break
575d056f54
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
AUG26-008。
- 迁移 000214–000217：tb_shop 全局唯一且不可修改的随机分销码（含存量回填）、
tb_agent_distribution_registration 待审批注册记录、tb_withdrawal_qualification 资料版本、
tb_commission_withdrawal_request_attempt 审批尝试记录，以及提现申请的 latest_*/异常标记列；
不修改既有迁移，down 在存在本 Change 业务事实或新类型场景行时拒绝破坏性回滚。
- 公开接口 POST /api/c/v1/agent-distribution-registrations：无认证，复用既有短信验证码校验、
消费与限流；无效分销码、停用上级、验证码无效或已消费统一返回「分销码不可用」且不落库，
审批通过前不创建店铺、账号或钱包。
- 审批通过才在同一事务内建启用店铺、代理主账号、钱包、上级层级与业务员快照，驳回不建实体，
重复回调不重复建实体，提交后清理上级下级缓存。
- 提现资料资格按不可变版本保存，替换合同或法人身份证即新增版本并同事务失效旧有效版本；
超管作废原因必填；代理停用与店铺删除联动失效。
- 提现每次提交或重提新增不可变审批尝试记录并冻结金额；企业微信通过仅一次从冻结扣减、
保持状态 2 并写 paid_at（不使用状态 4），驳回/cancelled/deleted 仅一次释放，
通过后撤销不回滚、不重新冻结、只写正交异常标记；加锁顺序统一为申请→尝试→钱包。
- 本地人工终审对已关联审批实例的申请返回状态冲突，approval_instance_id 为空的存量申请保持既有行为，
不新增任何配置开关。
- 补齐审批业务类型注册点全集：业务类型与场景字段常量、场景 DTO 两处枚举与中文描述、
场景字段白名单/合法类型/中文名、数据库 CHECK、Worker 决策消费者与装配、审批审计资源映射，
以及三个新审计资源与 13 个审计动作；失败/拒绝审计改为必达。
- 新增后台路由与 OpenAPI：资格提交/查询/作废、提现申请/重提/详情、店铺详情返回只读分销码。
- 归档本 Change：主 Spec 新增 agent-distribution-withdrawal 能力（5 个 Requirement）。
验证（junhong_cmp_test + Redis DB 6，显式 DB_*，未重置整库）：
- 迁移 up → version 217 且 dirty=false → down 3 → up 回 217，fixture 复核残留为 0。
- 受控状态机脚手架 227 项通过 / 0 项失败，覆盖 18 组场景（幂等与乱序回调、资金冻结/释放/重提、
退款回扣 × 在途提现并发、负向场景拒绝审计与 14 个动作码审计真实落库）。
- gofmt 空、go build/go vet 通过、gendocs 与工作区逐字节一致、context-health 通过、
openspec validate --strict 通过、doctor healthy；自动化测试按项目决策为 N/A。
运行期前置（未完成，非代码交付物）：由超管经 PUT /api/admin/wecom/scenes/{business_type} 为
agent_distribution_approval、withdrawal_qualification_approval、commission_withdrawal_approval
配置启用场景与模板控件映射；未配置时相应提交失败关闭。
103 lines
7.4 KiB
Go
103 lines
7.4 KiB
Go
package dto
|
||
|
||
import "time"
|
||
|
||
// WeComControlMappingItem 描述一个业务字段到企微模板控件的显式映射。
|
||
type WeComControlMappingItem struct {
|
||
BusinessField string `json:"business_field" validate:"required,min=1,max=64" description:"系统业务字段编码；按 business_type 调用 GET /api/admin/wecom/scenes/{business_type}/fields 获取可选值"`
|
||
ControlID string `json:"control_id" validate:"required,min=1,max=128" description:"企微模板控件 ID"`
|
||
ControlType string `json:"control_type" validate:"required,min=1,max=64" description:"企微模板控件类型，必须与模板详情一致"`
|
||
OptionMapping map[string]string `json:"option_mapping" description:"业务枚举值到企微选择项 key 的映射；非选择控件传空对象"`
|
||
}
|
||
|
||
// InspectWeComTemplateRequest 检查企业微信审批模板请求。
|
||
type InspectWeComTemplateRequest struct {
|
||
TemplateID string `json:"template_id" validate:"required,min=1,max=128" description:"企微后台已创建模板 ID"`
|
||
}
|
||
|
||
// InspectWeComTemplateParams 检查企业微信审批模板路径与请求参数。
|
||
type InspectWeComTemplateParams struct {
|
||
IDReq
|
||
InspectWeComTemplateRequest
|
||
}
|
||
|
||
// WeComBusinessFieldListParams 查询企业微信审批场景可映射字段路径参数。
|
||
type WeComBusinessFieldListParams struct {
|
||
BusinessType string `path:"business_type" required:"true" enum:"refund_approval,offline_recharge_approval,employee_collection_approval,agent_distribution_approval,withdrawal_qualification_approval,commission_withdrawal_approval" description:"业务类型 (refund_approval:退款审批, offline_recharge_approval:员工线下代充值审批, employee_collection_approval:员工代收款核销审批, agent_distribution_approval:代理扫码分销注册审批, withdrawal_qualification_approval:提现资料资格审批, commission_withdrawal_approval:佣金提现终审)"`
|
||
}
|
||
|
||
// WeComBusinessFieldResponse 企业微信审批场景可映射业务字段响应。
|
||
type WeComBusinessFieldResponse struct {
|
||
Code string `json:"code" description:"control_mapping.business_field 应填写的稳定字段编码"`
|
||
Name string `json:"name" description:"字段中文名称"`
|
||
ValueType string `json:"value_type" description:"字段值类型 (string:字符串, integer:整数, money:两位小数的元金额字符串, file_list:对象存储文件引用列表)"`
|
||
Description string `json:"description" description:"字段取值说明"`
|
||
}
|
||
|
||
// WeComBusinessFieldListResponse 企业微信审批场景可映射业务字段列表响应。
|
||
type WeComBusinessFieldListResponse struct {
|
||
BusinessType string `json:"business_type" description:"业务类型"`
|
||
BusinessTypeName string `json:"business_type_name" description:"业务类型名称（中文）"`
|
||
Items []WeComBusinessFieldResponse `json:"items" description:"当前业务类型允许写入 control_mapping.business_field 的字段"`
|
||
}
|
||
|
||
// WeComTemplateControlResponse 企业微信审批模板控件响应。
|
||
type WeComTemplateControlResponse struct {
|
||
ID string `json:"id" description:"企微模板控件 ID"`
|
||
Type string `json:"type" description:"企微模板控件类型"`
|
||
Title string `json:"title" description:"企微模板控件标题"`
|
||
Required bool `json:"required" description:"是否必填"`
|
||
OptionKeys []string `json:"option_keys" description:"选择控件可用选项 key"`
|
||
}
|
||
|
||
// WeComTemplateDetailResponse 企业微信审批模板详情响应。
|
||
type WeComTemplateDetailResponse struct {
|
||
TemplateID string `json:"template_id" description:"企微模板 ID"`
|
||
Name string `json:"name" description:"企微模板名称"`
|
||
Controls []WeComTemplateControlResponse `json:"controls" description:"可用于业务字段映射的模板控件"`
|
||
}
|
||
|
||
// SaveWeComApprovalSceneRequest 保存企业微信审批场景请求。
|
||
type SaveWeComApprovalSceneRequest struct {
|
||
ApplicationID uint `json:"application_id" validate:"required,gt=0" description:"企业微信应用配置 ID"`
|
||
TemplateID string `json:"template_id" validate:"required,min=1,max=128" description:"企微后台已创建模板 ID"`
|
||
ControlMapping []WeComControlMappingItem `json:"control_mapping" validate:"required,min=1,dive" description:"业务字段与模板控件映射"`
|
||
Status int `json:"status" validate:"oneof=0 1" enum:"0,1" description:"状态 (0:禁用, 1:启用)"`
|
||
}
|
||
|
||
// SaveWeComApprovalSceneParams 保存企业微信审批场景路径与请求参数。
|
||
type SaveWeComApprovalSceneParams struct {
|
||
BusinessType string `path:"business_type" required:"true" enum:"refund_approval,offline_recharge_approval,employee_collection_approval,agent_distribution_approval,withdrawal_qualification_approval,commission_withdrawal_approval" description:"业务类型 (refund_approval:退款审批, offline_recharge_approval:员工线下代充值审批, employee_collection_approval:员工代收款核销审批, agent_distribution_approval:代理扫码分销注册审批, withdrawal_qualification_approval:提现资料资格审批, commission_withdrawal_approval:佣金提现终审)；可先调用 GET /api/admin/wecom/scenes/{business_type}/fields 查询允许映射的业务字段"`
|
||
SaveWeComApprovalSceneRequest
|
||
}
|
||
|
||
// WeComApprovalSceneListRequest 查询企业微信审批场景请求。
|
||
type WeComApprovalSceneListRequest struct {
|
||
Page int `query:"page" validate:"omitempty,min=1" default:"1" description:"页码，默认 1"`
|
||
PageSize int `query:"page_size" validate:"omitempty,min=1,max=100" default:"20" description:"每页数量，默认 20，最大 100"`
|
||
}
|
||
|
||
// WeComApprovalSceneResponse 企业微信审批场景响应。
|
||
type WeComApprovalSceneResponse struct {
|
||
ID uint `json:"id" description:"场景配置 ID"`
|
||
BusinessType string `json:"business_type" description:"业务类型"`
|
||
BusinessTypeName string `json:"business_type_name" description:"业务类型名称（中文）"`
|
||
ApplicationID uint `json:"application_id" description:"企业微信应用配置 ID"`
|
||
TemplateID string `json:"template_id" description:"企微模板 ID"`
|
||
TemplateName string `json:"template_name" description:"企微模板名称"`
|
||
TemplateFingerprint string `json:"template_fingerprint" description:"模板控件最小快照 SHA-256 指纹"`
|
||
ControlMapping []WeComControlMappingItem `json:"control_mapping" description:"已验证控件映射"`
|
||
Status int `json:"status" description:"状态 (0:禁用, 1:启用)"`
|
||
StatusName string `json:"status_name" description:"状态名称（中文）"`
|
||
LastVerifiedAt time.Time `json:"last_verified_at" description:"最近模板校验时间"`
|
||
UpdatedAt time.Time `json:"updated_at" description:"更新时间"`
|
||
}
|
||
|
||
// WeComApprovalSceneListResponse 企业微信审批场景分页响应。
|
||
type WeComApprovalSceneListResponse struct {
|
||
Items []WeComApprovalSceneResponse `json:"items" description:"审批场景列表"`
|
||
Total int64 `json:"total" description:"总数量"`
|
||
Page int `json:"page" description:"当前页码"`
|
||
PageSize int `json:"page_size" description:"每页数量"`
|
||
}
|