规范: 新增枚举与状态字段规范并修复代理充值状态描述错误

- 新增 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 中文字段，防止前端映射出错

internal/model/dto/agent_recharge_dto.go

@@ -30,7 +30,8 @@ type AgentRechargeResponse struct {
 	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:已取消)"`
+	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:"创建时间"`
@@ -42,7 +43,7 @@ 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:已取消)"`
+	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)"`
 }

internal/service/agent_recharge/service.go

@@ -469,6 +469,23 @@ func (s *Service) generateRechargeNo() string {
 	return fmt.Sprintf("%s%s%06d", constants.AgentRechargeOrderPrefix, timestamp, randomNum)
 }
 
+func agentRechargeStatusName(status int) string {
+	switch status {
+	case constants.RechargeStatusPending:
+		return "待支付"
+	case constants.RechargeStatusPaid:
+		return "已支付"
+	case constants.RechargeStatusCompleted:
+		return "已完成"
+	case constants.RechargeStatusClosed:
+		return "已关闭"
+	case constants.RechargeStatusRefunded:
+		return "已退款"
+	default:
+		return "未知"
+	}
+}
+
 // toResponse 将模型转换为响应 DTO
 func toResponse(record *model.AgentRechargeRecord, shopName string) *dto.AgentRechargeResponse {
 	resp := &dto.AgentRechargeResponse{
@@ -480,6 +497,7 @@ func toResponse(record *model.AgentRechargeRecord, shopName string) *dto.AgentRe
 		Amount:        record.Amount,
 		PaymentMethod: record.PaymentMethod,
 		Status:        record.Status,
+		StatusName:    agentRechargeStatusName(record.Status),
 		CreatedAt:     record.CreatedAt.Format("2006-01-02 15:04:05"),
 		UpdatedAt:     record.UpdatedAt.Format("2006-01-02 15:04:05"),
 	}