七月迭代短暂完结,还有很多后端的关键东西没有弄,这是一版赶时间做的东西

2026-07-25 17:06:58 +08:00
parent ad9f613dd6
commit 73f5125d3d
249 changed files with 17137 additions and 877 deletions
--- a/internal/model/dto/wecom_scene_dto.go
+++ b/internal/model/dto/wecom_scene_dto.go
@@ -0,0 +1,55 @@
+package dto
+
+import "time"
+
+// WeComControlMappingItem 描述一个业务字段到企微模板控件的显式映射。
+type WeComControlMappingItem struct {
+	BusinessField string            `json:"business_field" validate:"required,min=1,max=64" description:"稳定业务字段编码"`
+	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 的映射；非选择控件传空对象"`
+}
+
+// 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" description:"业务类型 (refund_approval:退款审批, offline_recharge_approval:员工线下代充值审批)"`
+	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:"每页数量"`
+}