huang
e9ff14df0e
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
- 新增 docs/enum-status-standards.md：完整的枚举/状态规范，涵盖 int vs string 选择、起始值约定、description 格式统一、constants 唯一真相来源、Response DTO 必须提供 status_name - 更新 dto-standards SKILL.md：加入枚举规范要点，AI 写 DTO 时自动触发 - 更新 AGENTS.md：常量管理章节和 Code Review 检查清单各加入枚举检查项 - 修复 agent_recharge_dto.go：description 从错误的 3 个状态改为正确的 5 个状态（原 3:已取消 实为 3:已完成） - 修复 agent_recharge service：toResponse 补充 StatusName 中文字段，防止前端映射出错
58 lines
3.7 KiB
Go
58 lines
3.7 KiB
Go
package dto
|
||
|
||
// CreateAgentRechargeRequest 创建代理充值请求
|
||
type CreateAgentRechargeRequest struct {
|
||
ShopID uint `json:"shop_id" validate:"required" required:"true" description:"目标店铺ID，代理只能填自己店铺"`
|
||
Amount int64 `json:"amount" validate:"required,min=10000,max=100000000" required:"true" minimum:"10000" maximum:"100000000" description:"充值金额（分），范围100元~100万元"`
|
||
PaymentMethod string `json:"payment_method" validate:"required,oneof=wechat offline" required:"true" description:"支付方式 (wechat:微信在线支付, offline:线下转账仅平台可用)"`
|
||
}
|
||
|
||
// AgentOfflinePayRequest 代理线下充值确认请求
|
||
type AgentOfflinePayRequest struct {
|
||
OperationPassword string `json:"operation_password" validate:"required" required:"true" description:"操作密码"`
|
||
}
|
||
|
||
// AgentOfflinePayParams 确认线下充值聚合参数 (用于文档生成)
|
||
type AgentOfflinePayParams struct {
|
||
IDReq
|
||
AgentOfflinePayRequest
|
||
}
|
||
|
||
// AgentRechargeResponse 代理充值记录响应
|
||
type AgentRechargeResponse struct {
|
||
ID uint `json:"id" description:"充值记录ID"`
|
||
RechargeNo string `json:"recharge_no" description:"充值单号(ARCH前缀)"`
|
||
ShopID uint `json:"shop_id" description:"店铺ID"`
|
||
ShopName string `json:"shop_name" description:"店铺名称"`
|
||
AgentWalletID uint `json:"agent_wallet_id" description:"代理钱包ID"`
|
||
Amount int64 `json:"amount" description:"充值金额（分）"`
|
||
PaymentMethod string `json:"payment_method" description:"支付方式 (wechat:微信在线支付, offline:线下转账)"`
|
||
PaymentChannel string `json:"payment_channel" description:"实际支付通道 (wechat_direct:微信直连, fuyou:富友, offline:线下转账)"`
|
||
PaymentConfigID *uint `json:"payment_config_id" description:"关联支付配置ID，线下充值为null"`
|
||
PaymentTransactionID string `json:"payment_transaction_id" description:"第三方支付流水号"`
|
||
Status int `json:"status" description:"状态 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款)"`
|
||
StatusName string `json:"status_name" description:"状态名称（中文）"`
|
||
PaidAt *string `json:"paid_at" description:"支付时间"`
|
||
CompletedAt *string `json:"completed_at" description:"完成时间"`
|
||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||
UpdatedAt string `json:"updated_at" description:"更新时间"`
|
||
}
|
||
|
||
// AgentRechargeListRequest 代理充值记录列表请求
|
||
type AgentRechargeListRequest struct {
|
||
Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码，默认1"`
|
||
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页条数，默认20，最大100"`
|
||
ShopID *uint `json:"shop_id" query:"shop_id" description:"按店铺ID过滤"`
|
||
Status *int `json:"status" query:"status" description:"按状态过滤 (1:待支付, 2:已支付, 3:已完成, 4:已关闭, 5:已退款)"`
|
||
StartDate string `json:"start_date" query:"start_date" description:"创建时间起始日期(YYYY-MM-DD)"`
|
||
EndDate string `json:"end_date" query:"end_date" description:"创建时间截止日期(YYYY-MM-DD)"`
|
||
}
|
||
|
||
// AgentRechargeListResponse 代理充值记录列表响应
|
||
type AgentRechargeListResponse struct {
|
||
Total int64 `json:"total" description:"总记录数"`
|
||
Page int `json:"page" description:"当前页码"`
|
||
PageSize int `json:"size" description:"每页条数"`
|
||
List []*AgentRechargeResponse `json:"items" description:"充值记录列表"`
|
||
}
|