116 lines
4.5 KiB
Go
116 lines
4.5 KiB
Go
|
package v1
|
|||
|
|
|
|||
|
|
import "github.com/gogf/gf/v2/frame/g"
|
|||
|
|
|
|||
|
|
// ============================================================================
|
|||
|
|
// C 端开发项目契约（迭代-2026-09-30 三期）
|
|||
|
|
//
|
|||
|
|
// 流程：后台建单（生成绑定令牌）→ 用户扫小程序码进入绑定页 → POST bind 绑定到
|
|||
|
|
// 当前用户 → 后台维护阶段/小节点/交付物（原型、UI 设计稿等）→ 用户端只读查看。
|
|||
|
|
// ============================================================================
|
|||
|
|
|
|||
|
|
// ProjectStageItem 项目阶段（含小节点与交付物）
|
|||
|
|
type ProjectStageItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
Title string `json:"title"`
|
|||
|
|
Status int `json:"status"` // 0未开始 1进行中 2已完成
|
|||
|
|
StatusText string `json:"status_text"`
|
|||
|
|
Nodes []ProjectNodeItem `json:"nodes"`
|
|||
|
|
Files []ProjectFileItem `json:"files"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectNodeItem 阶段小节点
|
|||
|
|
type ProjectNodeItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
Title string `json:"title"`
|
|||
|
|
IsDone int `json:"is_done"`
|
|||
|
|
DoneAt string `json:"done_at"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectFileItem 阶段交付物（图片，绝对 URL）
|
|||
|
|
type ProjectFileItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
FileName string `json:"file_name"`
|
|||
|
|
FileUrl string `json:"file_url"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectPayItem 项目分期（后台确认到账，用户只读）
|
|||
|
|
type ProjectPayItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
Seq int `json:"seq"`
|
|||
|
|
Percent int `json:"percent"`
|
|||
|
|
AmountCents int64 `json:"amount_cents"`
|
|||
|
|
Trigger string `json:"trigger"`
|
|||
|
|
TriggerText string `json:"trigger_text"`
|
|||
|
|
Status int `json:"status"` // 0待支付 1已支付
|
|||
|
|
PaidAt string `json:"paid_at"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectMaintainOut 维护期信息
|
|||
|
|
type ProjectMaintainOut struct {
|
|||
|
|
PlanName string `json:"plan_name"`
|
|||
|
|
FreeYears int `json:"free_years"`
|
|||
|
|
YearlyFeeCents int64 `json:"yearly_fee_cents"`
|
|||
|
|
SourceOnly int `json:"source_only"` // 1=仅源码无售后
|
|||
|
|
Accepted int `json:"accepted"`
|
|||
|
|
AcceptedAt string `json:"accepted_at"`
|
|||
|
|
StartAt string `json:"start_at"` // 维护期起算日（后台可调）
|
|||
|
|
PaidUntil string `json:"paid_until"` // 维护费已缴至（= 下次缴费日）
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectItem 项目列表项
|
|||
|
|
type ProjectItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
Title string `json:"title"`
|
|||
|
|
Description string `json:"description"`
|
|||
|
|
PriceCents int64 `json:"price_cents"`
|
|||
|
|
PriceNote string `json:"price_note"`
|
|||
|
|
DueNote string `json:"due_note"`
|
|||
|
|
Status int `json:"status"`
|
|||
|
|
StatusText string `json:"status_text"`
|
|||
|
|
StageTotal int `json:"stage_total"` // 已完成阶段数（输出时算好，前端直接展示进度）
|
|||
|
|
StageDone int `json:"stage_done"`
|
|||
|
|
CoverUrl string `json:"cover_url"` // 入口图（第一个阶段交付物图片，可能为空）
|
|||
|
|
UpdatedAt string `json:"updated_at"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectMineReq 我的项目（扫码绑定后可见）
|
|||
|
|
type ProjectMineReq struct {
|
|||
|
|
g.Meta `path:"/service/project/mine" method:"get" tags:"service" summary:"我的开发项目"`
|
|||
|
|
}
|
|||
|
|
type ProjectMineRes struct {
|
|||
|
|
List []ProjectItem `json:"list"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectDetailReq 项目详情（仅限已绑定用户；含阶段/节点/交付物/分期/维护期）
|
|||
|
|
type ProjectDetailReq struct {
|
|||
|
|
g.Meta `path:"/service/project/detail" method:"get" tags:"service" summary:"开发项目详情"`
|
|||
|
|
Id int64 `v:"required" json:"id"`
|
|||
|
|
}
|
|||
|
|
type ProjectDetailRes struct {
|
|||
|
|
ProjectItem
|
|||
|
|
Stages []ProjectStageItem `json:"stages"`
|
|||
|
|
Pays []ProjectPayItem `json:"pays"` // 分期付款（进度与到账状态）
|
|||
|
|
Maintain *ProjectMaintainOut `json:"maintain"` // 维护期信息（未选模板为 null）
|
|||
|
|
CanAccept int `json:"can_accept"` // 1=可点「确认验收」（已交付且未验收）
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectAcceptReq 用户确认验收：进入维护期（维护期起点=确认当天，后台可调整）。
|
|||
|
|
type ProjectAcceptReq struct {
|
|||
|
|
g.Meta `path:"/service/project/accept" method:"post" tags:"service" summary:"确认验收进入维护期"`
|
|||
|
|
Id int64 `v:"required" json:"id"`
|
|||
|
|
}
|
|||
|
|
type ProjectAcceptRes struct {
|
|||
|
|
MaintainStartAt string `json:"maintain_start_at"`
|
|||
|
|
PaidUntil string `json:"paid_until"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ProjectBindReq 扫码绑定项目（令牌来自小程序码 scene）
|
|||
|
|
type ProjectBindReq struct {
|
|||
|
|
g.Meta `path:"/service/project/bind" method:"post" tags:"service" summary:"绑定开发项目"`
|
|||
|
|
Token string `v:"required#缺少绑定令牌" json:"token"`
|
|||
|
|
}
|
|||
|
|
type ProjectBindRes struct {
|
|||
|
|
ProjectId int64 `json:"project_id"`
|
|||
|
|
}
|