342 lines
14 KiB
Go
342 lines
14 KiB
Go
package v1
|
||
|
||
import "github.com/gogf/gf/v2/frame/g"
|
||
|
||
// ============================================================================
|
||
// 管理端开发项目契约（迭代-2026-09-30 三期）
|
||
//
|
||
// 建单 → 生成绑定小程序码（scene 携带 bind_token）→ 用户扫码绑定；
|
||
// 阶段/小节点/交付物（原型、UI 设计稿）均为即时保存接口（管理端逐项操作）。
|
||
// 阶段状态变更 / 交付物上传 / 交付 会向绑定用户推站内信。
|
||
// ============================================================================
|
||
|
||
// AdminProjectPayItem 项目分期
|
||
type AdminProjectPayItem 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"`
|
||
PaidAt string `json:"paid_at"`
|
||
PaidNote string `json:"paid_note"`
|
||
}
|
||
|
||
// AdminProjectItem 项目列表项
|
||
type AdminProjectItem struct {
|
||
Id int64 `json:"id"`
|
||
UserId int64 `json:"user_id"`
|
||
UserNickname string `json:"user_nickname"`
|
||
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"`
|
||
BindToken string `json:"bind_token"`
|
||
CodeUrl string `json:"code_url"`
|
||
CreatedAt string `json:"created_at"`
|
||
UpdatedAt string `json:"updated_at"`
|
||
Stages []AdminProjectStageItem `json:"stages"`
|
||
|
||
MaintainPlanId int64 `json:"maintain_plan_id"`
|
||
PayPlanId int64 `json:"pay_plan_id"`
|
||
MaintainPlanName string `json:"maintain_plan_name"`
|
||
PayPlanName string `json:"pay_plan_name"`
|
||
Accepted int `json:"accepted"`
|
||
AcceptedAt string `json:"accepted_at"`
|
||
MaintainStartAt string `json:"maintain_start_at"`
|
||
MaintainPaidUntil string `json:"maintain_paid_until"`
|
||
MaintainDaysLeft int `json:"maintain_days_left"` // 距下次缴费天数（未启用维护为 -1）
|
||
Pays []AdminProjectPayItem `json:"pays"`
|
||
}
|
||
|
||
// AdminProjectListReq 项目列表
|
||
type AdminProjectListReq struct {
|
||
g.Meta `path:"/admin/service/project/list" method:"get" tags:"admin" summary:"开发项目列表"`
|
||
Keyword string `json:"keyword"`
|
||
Status *int `json:"status"`
|
||
Page int `json:"page"`
|
||
PageSize int `json:"pageSize"`
|
||
}
|
||
type AdminProjectListRes struct {
|
||
List []AdminProjectItem `json:"list"`
|
||
Total int `json:"total"`
|
||
}
|
||
|
||
// AdminProjectSaveReq 新增/编辑项目（id=0 新建并生成绑定令牌；userId>0 直接绑定）
|
||
type AdminProjectSaveReq struct {
|
||
g.Meta `path:"/admin/service/project/save" method:"post" tags:"admin" summary:"保存开发项目"`
|
||
Id int64 `json:"id"`
|
||
Title string `v:"required#请填写项目名称" json:"title"`
|
||
Description string `v:"length:0,1000#需求描述最多 1000 字" json:"description"`
|
||
PriceCents int64 `v:"min:0#金额不能为负" json:"priceCents"`
|
||
PriceNote string `v:"length:0,64#金额备注最多 64 字" json:"priceNote"`
|
||
DueNote string `v:"length:0,64#交付周期最多 64 字" json:"dueNote"`
|
||
Status int `v:"in:1,2,3#状态不合法" json:"status"`
|
||
UserId int64 `json:"userId"` // 编辑时可直接改绑（填 0 = 解绑待扫码）
|
||
MaintainPlanId int64 `json:"maintainPlanId"` // 维护模板（0=未选）
|
||
PayPlanId int64 `json:"payPlanId"` // 付款分期模板（0=未选）
|
||
}
|
||
type AdminProjectSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
BindToken string `json:"bind_token"` // 新建时返回，供前端直接弹码
|
||
}
|
||
|
||
// AdminProjectDeleteReq 删除项目（软删除；阶段/节点/交付物一并硬删）
|
||
type AdminProjectDeleteReq struct {
|
||
g.Meta `path:"/admin/service/project/delete" method:"post" tags:"admin" summary:"删除开发项目"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectDeleteRes struct{}
|
||
|
||
// AdminProjectStageItem 阶段（含节点与文件，管理端详情用）
|
||
type AdminProjectStageItem struct {
|
||
Id int64 `json:"id"`
|
||
Title string `json:"title"`
|
||
Status int `json:"status"`
|
||
StatusText string `json:"status_text"`
|
||
Sort int `json:"sort"`
|
||
IsEnabled int `json:"is_enabled"`
|
||
Nodes []AdminProjectNodeItem `json:"nodes"`
|
||
Files []AdminProjectFileItem `json:"files"`
|
||
}
|
||
|
||
// AdminProjectNodeItem 小节点
|
||
type AdminProjectNodeItem struct {
|
||
Id int64 `json:"id"`
|
||
Title string `json:"title"`
|
||
IsDone int `json:"is_done"`
|
||
Sort int `json:"sort"`
|
||
}
|
||
|
||
// AdminProjectFileItem 交付物（绝对 URL 直显）
|
||
type AdminProjectFileItem struct {
|
||
Id int64 `json:"id"`
|
||
FileName string `json:"file_name"`
|
||
FileUrl string `json:"file_url"`
|
||
}
|
||
|
||
// AdminProjectDetailReq 项目详情（管理态全量：阶段/节点/文件）
|
||
type AdminProjectDetailReq struct {
|
||
g.Meta `path:"/admin/service/project/detail" method:"get" tags:"admin" summary:"开发项目详情"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectDetailRes struct {
|
||
AdminProjectItem
|
||
}
|
||
|
||
// AdminProjectQrcodeReq 生成/重取绑定小程序码（微信 getUnlimited，scene=项目+令牌）
|
||
type AdminProjectQrcodeReq struct {
|
||
g.Meta `path:"/admin/service/project/qrcode" method:"post" tags:"admin" summary:"生成项目绑定小程序码"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectQrcodeRes struct {
|
||
CodeUrl string `json:"code_url"`
|
||
}
|
||
|
||
// AdminProjectStageSaveReq 新增/编辑阶段
|
||
type AdminProjectStageSaveReq struct {
|
||
g.Meta `path:"/admin/service/project/stage/save" method:"post" tags:"admin" summary:"保存项目阶段"`
|
||
Id int64 `json:"id"`
|
||
ProjectId int64 `v:"required" json:"projectId"`
|
||
Title string `v:"required#请填写阶段名称" json:"title"`
|
||
Status int `v:"in:0,1,2#状态不合法" json:"status"`
|
||
Sort int `json:"sort"`
|
||
IsEnabled int `json:"isEnabled"`
|
||
}
|
||
type AdminProjectStageSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
// AdminProjectStageDeleteReq 删除阶段（其节点与交付物一并删除）
|
||
type AdminProjectStageDeleteReq struct {
|
||
g.Meta `path:"/admin/service/project/stage/delete" method:"post" tags:"admin" summary:"删除项目阶段"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectStageDeleteRes struct{}
|
||
|
||
// AdminProjectNodeSaveReq 新增/编辑小节点（isDone 变更即时生效）
|
||
type AdminProjectNodeSaveReq struct {
|
||
g.Meta `path:"/admin/service/project/node/save" method:"post" tags:"admin" summary:"保存阶段小节点"`
|
||
Id int64 `json:"id"`
|
||
StageId int64 `v:"required" json:"stageId"`
|
||
Title string `v:"required#请填写节点内容" json:"title"`
|
||
IsDone int `json:"isDone"`
|
||
Sort int `json:"sort"`
|
||
}
|
||
type AdminProjectNodeSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
// AdminProjectNodeDeleteReq 删除小节点
|
||
type AdminProjectNodeDeleteReq struct {
|
||
g.Meta `path:"/admin/service/project/node/delete" method:"post" tags:"admin" summary:"删除阶段小节点"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectNodeDeleteRes struct{}
|
||
|
||
// AdminProjectFileAddReq 登记交付物（文件本体先经 /admin/upload 上传，此处只落 path）
|
||
type AdminProjectFileAddReq struct {
|
||
g.Meta `path:"/admin/service/project/file/add" method:"post" tags:"admin" summary:"登记项目交付物"`
|
||
ProjectId int64 `v:"required" json:"projectId"`
|
||
StageId int64 `json:"stageId"`
|
||
FileName string `v:"required#请填写文件名" json:"fileName"`
|
||
FilePath string `v:"required#缺少文件路径" json:"filePath"`
|
||
}
|
||
type AdminProjectFileAddRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
// AdminProjectFileDeleteReq 删除交付物登记
|
||
type AdminProjectFileDeleteReq struct {
|
||
g.Meta `path:"/admin/service/project/file/delete" method:"post" tags:"admin" summary:"删除项目交付物"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectFileDeleteRes struct{}
|
||
|
||
// ---------- 维护模板 ----------
|
||
|
||
// AdminMaintainPlanItem 维护模板
|
||
type AdminMaintainPlanItem struct {
|
||
Id int64 `json:"id"`
|
||
Name string `json:"name"`
|
||
FreeYears int `json:"free_years"`
|
||
YearlyFeeCents int64 `json:"yearly_fee_cents"`
|
||
SourceOnly int `json:"source_only"`
|
||
Sort int `json:"sort"`
|
||
IsEnabled int `json:"is_enabled"`
|
||
Remark string `json:"remark"`
|
||
}
|
||
|
||
// AdminMaintainPlanListReq 维护模板列表
|
||
type AdminMaintainPlanListReq struct {
|
||
g.Meta `path:"/admin/service/maintain-plan/list" method:"get" tags:"admin" summary:"维护模板列表"`
|
||
}
|
||
type AdminMaintainPlanListRes struct {
|
||
List []AdminMaintainPlanItem `json:"list"`
|
||
}
|
||
|
||
// AdminMaintainPlanSaveReq 保存维护模板
|
||
type AdminMaintainPlanSaveReq struct {
|
||
g.Meta `path:"/admin/service/maintain-plan/save" method:"post" tags:"admin" summary:"保存维护模板"`
|
||
Id int64 `json:"id"`
|
||
Name string `v:"required#请填写模板名称" json:"name"`
|
||
FreeYears int `v:"min:0" json:"freeYears"`
|
||
YearlyFeeCents int64 `v:"min:0" json:"yearlyFeeCents"`
|
||
SourceOnly int `json:"sourceOnly"`
|
||
Sort int `json:"sort"`
|
||
IsEnabled int `json:"isEnabled"`
|
||
Remark string `v:"length:0,255" json:"remark"`
|
||
}
|
||
type AdminMaintainPlanSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
// AdminMaintainPlanDeleteReq 删除维护模板
|
||
type AdminMaintainPlanDeleteReq struct {
|
||
g.Meta `path:"/admin/service/maintain-plan/delete" method:"post" tags:"admin" summary:"删除维护模板"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminMaintainPlanDeleteRes struct{}
|
||
|
||
// ---------- 付款分期模板 ----------
|
||
|
||
// AdminPayPlanItem 付款分期模板
|
||
type AdminPayPlanItem struct {
|
||
Id int64 `json:"id"`
|
||
Name string `json:"name"`
|
||
Schedule string `json:"schedule"` // JSON：[{seq,percent,trigger}]
|
||
Sort int `json:"sort"`
|
||
IsEnabled int `json:"is_enabled"`
|
||
Remark string `json:"remark"`
|
||
}
|
||
|
||
// AdminPayPlanListReq 分期模板列表
|
||
type AdminPayPlanListReq struct {
|
||
g.Meta `path:"/admin/service/pay-plan/list" method:"get" tags:"admin" summary:"付款分期模板列表"`
|
||
}
|
||
type AdminPayPlanListRes struct {
|
||
List []AdminPayPlanItem `json:"list"`
|
||
}
|
||
|
||
// AdminPayPlanSaveReq 保存分期模板
|
||
type AdminPayPlanSaveReq struct {
|
||
g.Meta `path:"/admin/service/pay-plan/save" method:"post" tags:"admin" summary:"保存付款分期模板"`
|
||
Id int64 `json:"id"`
|
||
Name string `v:"required#请填写模板名称" json:"name"`
|
||
Schedule string `v:"required#请填写分期计划 JSON" json:"schedule"`
|
||
Sort int `json:"sort"`
|
||
IsEnabled int `json:"isEnabled"`
|
||
Remark string `v:"length:0,255" json:"remark"`
|
||
}
|
||
type AdminPayPlanSaveRes struct {
|
||
Id int64 `json:"id"`
|
||
}
|
||
|
||
// AdminPayPlanDeleteReq 删除分期模板
|
||
type AdminPayPlanDeleteReq struct {
|
||
g.Meta `path:"/admin/service/pay-plan/delete" method:"post" tags:"admin" summary:"删除付款分期模板"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminPayPlanDeleteRes struct{}
|
||
|
||
// ---------- 分期到账 / 维护期 ----------
|
||
|
||
// AdminProjectPayMarkReq 标记分期到账（后台确认收款，用户端推站内信）
|
||
type AdminProjectPayMarkReq struct {
|
||
g.Meta `path:"/admin/service/project/pay/mark" method:"post" tags:"admin" summary:"标记分期到账"`
|
||
Id int64 `v:"required" json:"id"`
|
||
PaidNote string `v:"length:0,64#备注最多 64 字" json:"paidNote"`
|
||
}
|
||
type AdminProjectPayMarkRes struct{}
|
||
|
||
// AdminProjectPayUnmarkReq 撤销分期到账（误操作回退）
|
||
type AdminProjectPayUnmarkReq struct {
|
||
g.Meta `path:"/admin/service/project/pay/unmark" method:"post" tags:"admin" summary:"撤销分期到账"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectPayUnmarkRes struct{}
|
||
|
||
// AdminProjectMaintainRenewReq 维护费 +1 年已收（paid_until 顺延一年并通知用户）
|
||
type AdminProjectMaintainRenewReq struct {
|
||
g.Meta `path:"/admin/service/project/maintain/renew" method:"post" tags:"admin" summary:"维护费续收一年"`
|
||
Id int64 `v:"required" json:"id"`
|
||
}
|
||
type AdminProjectMaintainRenewRes struct {
|
||
PaidUntil string `json:"paid_until"`
|
||
}
|
||
|
||
// AdminProjectMaintainAdjustReq 调整维护期起算日（重算已缴至与到期提醒）
|
||
type AdminProjectMaintainAdjustReq struct {
|
||
g.Meta `path:"/admin/service/project/maintain/adjust" method:"post" tags:"admin" summary:"调整维护期起算日"`
|
||
Id int64 `v:"required" json:"id"`
|
||
StartAt string `v:"required#请选择起算日期" json:"startAt"` // YYYY-MM-DD
|
||
}
|
||
type AdminProjectMaintainAdjustRes struct {
|
||
PaidUntil string `json:"paid_until"`
|
||
}
|
||
|
||
// ---------- 缴费提醒设置 ----------
|
||
|
||
// AdminMaintainRemindGetReq 提醒设置读取
|
||
type AdminMaintainRemindGetReq struct {
|
||
g.Meta `path:"/admin/service/maintain-remind/get" method:"get" tags:"admin" summary:"维护费提醒设置读取"`
|
||
}
|
||
type AdminMaintainRemindGetRes struct {
|
||
RemindDays int `json:"remind_days"`
|
||
AdminNotifyUserId int64 `json:"admin_notify_user_id"`
|
||
}
|
||
|
||
// AdminMaintainRemindSaveReq 提醒设置保存
|
||
type AdminMaintainRemindSaveReq struct {
|
||
g.Meta `path:"/admin/service/maintain-remind/save" method:"post" tags:"admin" summary:"维护费提醒设置保存"`
|
||
RemindDays int `v:"min:1|max:90#提醒天数需在 1-90 之间" json:"remindDays"`
|
||
AdminNotifyUserId int64 `json:"adminNotifyUserId"`
|
||
}
|
||
type AdminMaintainRemindSaveRes struct{}
|