// settle_handler.go S2:结算域端点。D2 先挂两件——消耗日汇总查询(/billing/ // consume)与手动回补(/ops/settle/aggregate);D3(充值订单审核族)/D4(月结 // 单/阶梯/导出)/D5(利润/对账)随任务推进在本文件追加,契约见 openapi v1.3.0。 package v1 import ( "strconv" "time" "github.com/gin-gonic/gin" "go.uber.org/zap" "gorm.io/gorm" "go-sms/internal/config" "go-sms/internal/middleware" errs "go-sms/internal/pkg/errors" "go-sms/internal/pkg/response" "go-sms/internal/service/settle" ) // settleConsumeDefaultDays 消耗查询缺省窗口(近 7 天,对齐 stats trend 口径)。 const settleConsumeDefaultDays = 7 func registerSettleRoutes(protected *gin.RouterGroup, deps Deps) { h := &settleHandler{svc: deps.Settle} // 消耗日汇总查询:JWT 即可(admin/ops/service 全量;group/customer 仅自己, // scope 收窄在 handler 内做——与 stats 域同口径,casbin customer settle:read // 策略为 v20 所种,细分资源门按需后挂)。 protected.GET("/billing/consume", h.consumeList) // 手动触发回补(运维口径;settle:write)。 protected.POST("/ops/settle/aggregate", middleware.RequirePermission(deps.Perm, "settle", "write"), h.aggregate) // S2-D3:充值订单审核族(R3 双通道——即时充值保留,订单流承载付款审核确认; // 创建/确认/驳回挂 account:recharge 二级权限与即时充值同门;列表=平台角色 // admin/ops/service(group/customer 403——订单含全平台资金信息不放大)。 protected.GET("/billing/orders", h.ordersList) protected.POST("/billing/orders", middleware.RequirePermission(deps.Perm, "account", middleware.PermRecharge), h.orderCreate) protected.POST("/billing/orders/:id/confirm", middleware.RequirePermission(deps.Perm, "account", middleware.PermRecharge), h.orderConfirm) protected.POST("/billing/orders/:id/reject", middleware.RequirePermission(deps.Perm, "account", middleware.PermRecharge), h.orderReject) } // StartSettleAggregateJob v1 层装配入口(照 StartStatsRefresher 模式,仅 // gateway 调用;测试/迁移工具不启)。 func StartSettleAggregateJob(db *gorm.DB, cfg config.Settle, log *zap.Logger) { settle.StartAggregateJob(db, cfg.RefreshEvery, cfg.RefreshDays, cfg.BackfillDays, log) } type settleHandler struct{ svc *settle.Service } // consumeList GET /billing/consume:账号×业务×天 消耗事实源查询。 func (h *settleHandler) consumeList(c *gin.Context) { claims := statsClaims(c) // protected 组内恒在;复用 stats 域提取器 q := settle.ConsumeQuery{Page: 1, PageSize: 20} if v, err := strconv.ParseInt(c.Query("account_id"), 10, 64); err == nil && v > 0 { q.AccountID = v } q.Business = c.Query("business") now := time.Now() q.To = now q.From = now.AddDate(0, 0, -(settleConsumeDefaultDays - 1)) if s := c.Query("date_from"); s != "" { d, err := time.ParseInLocation("2006-01-02", s, time.Local) if err != nil { response.Error(c, errs.InvalidParam.WithMsg("date_from 须为 YYYY-MM-DD")) return } q.From = d } if s := c.Query("date_to"); s != "" { d, err := time.ParseInLocation("2006-01-02", s, time.Local) if err != nil { response.Error(c, errs.InvalidParam.WithMsg("date_to 须为 YYYY-MM-DD")) return } q.To = d } if v, err := strconv.Atoi(c.Query("page")); err == nil && v > 0 { q.Page = v } if v, err := strconv.Atoi(c.Query("page_size")); err == nil && v > 0 { q.PageSize = v } // 非平台角色强制收窄到自身账号(带参越权请求直接覆盖,不报错——stats 同口径)。 if claims != nil && !statsIsPlatform(c) { q.AccountID = claims.AccountID } list, total, err := h.svc.ListConsume(c.Request.Context(), q) if err != nil { bizResp(c, err) return } response.Success(c, gin.H{"total": total, "list": list}) } // aggregate POST /ops/settle/aggregate:date 缺省=昨日;幂等 UPSERT 可重入, // 返回两表落账行数(只回补单日——历史区间回补走重启 job 的 backfill 或逐日调用)。 func (h *settleHandler) aggregate(c *gin.Context) { var req struct { Date string `json:"date"` } _ = c.ShouldBindJSON(&req) day := time.Now().AddDate(0, 0, -1) if req.Date != "" { d, err := time.ParseInLocation("2006-01-02", req.Date, time.Local) if err != nil { response.Error(c, errs.InvalidParam.WithMsg("date 须为 YYYY-MM-DD")) return } day = d } accountRows, channelRows, err := h.svc.AggregateDay(c.Request.Context(), day) if err != nil { bizResp(c, err) return } response.Success(c, gin.H{ "day": day.Format("2006-01-02"), "account_rows": accountRows, "channel_rows": channelRows, }) } // ordersList GET /billing/orders:订单分页(account_id/pay_status 过滤;平台角色)。 func (h *settleHandler) ordersList(c *gin.Context) { if !statsIsPlatform(c) { response.Error(c, errs.Forbidden.WithMsg("仅平台角色可查看充值订单")) return } q := settle.OrderQuery{Page: 1, PageSize: 20} if v, err := strconv.ParseInt(c.Query("account_id"), 10, 64); err == nil && v > 0 { q.AccountID = v } if s := c.Query("pay_status"); s != "" { v, err := strconv.Atoi(s) if err != nil || v < 0 || v > 2 { response.Error(c, errs.InvalidParam.WithMsg("pay_status 须为 0/1/2")) return } ps := int8(v) q.PayStatus = &ps } if v, err := strconv.Atoi(c.Query("page")); err == nil && v > 0 { q.Page = v } if v, err := strconv.Atoi(c.Query("page_size")); err == nil && v > 0 { q.PageSize = v } list, total, err := h.svc.ListOrders(c.Request.Context(), q) if err != nil { bizResp(c, err) return } response.Success(c, gin.H{"total": total, "list": list}) } // orderCreate POST /billing/orders:创建待确认订单(不动余额;到账只发生在 confirm)。 func (h *settleHandler) orderCreate(c *gin.Context) { var req struct { AccountID int64 `json:"account_id" binding:"required"` Count int64 `json:"count" binding:"required"` Amount float64 `json:"amount"` PayType string `json:"pay_type"` Remark string `json:"remark"` } if err := c.ShouldBindJSON(&req); err != nil { response.Error(c, errs.InvalidParam.WithMsg("account_id/count 必填")) return } claims := statsClaims(c) operator := "" if claims != nil { operator = claims.Username } order, err := h.svc.CreateOrder(c.Request.Context(), &settle.CreateOrderRequest{ AccountID: req.AccountID, Count: req.Count, Amount: req.Amount, PayType: req.PayType, Operator: operator, Remark: req.Remark, }) if err != nil { bizResp(c, err) return } response.Success(c, order) } // orderConfirm POST /billing/orders/:id/confirm:付款审核确认(0→1,余额+count)。 func (h *settleHandler) orderConfirm(c *gin.Context) { id, err := strconv.ParseInt(c.Param("id"), 10, 64) if err != nil || id <= 0 { response.Error(c, errs.InvalidParam.WithMsg("订单 ID 非法")) return } claims := statsClaims(c) operator := "" if claims != nil { operator = claims.Username } res, err := h.svc.ConfirmOrder(c.Request.Context(), id, operator) if err != nil { bizResp(c, err) return } response.Success(c, gin.H{ "order_no": res.Order.OrderNo, "pay_status": res.Order.PayStatus, "count": res.Order.Count, "balance": res.Balance, "balance_log_id": res.BalanceLogID, }) } // orderReject POST /billing/orders/:id/reject:驳回(0→2,不涉余额)。 func (h *settleHandler) orderReject(c *gin.Context) { id, err := strconv.ParseInt(c.Param("id"), 10, 64) if err != nil || id <= 0 { response.Error(c, errs.InvalidParam.WithMsg("订单 ID 非法")) return } var req struct { Remark string `json:"remark"` } _ = c.ShouldBindJSON(&req) claims := statsClaims(c) operator := "" if claims != nil { operator = claims.Username } order, err := h.svc.RejectOrder(c.Request.Context(), id, operator, req.Remark) if err != nil { bizResp(c, err) return } response.Success(c, order) }