Files
go-sms-V2/internal/api/http/v1/settle_handler.go
T

115 lines
3.8 KiB
Go

// 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)
}
// 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,
})
}