Files
go-sms-V2/internal/service/settle/job.go
T

66 lines
2.1 KiB
Go

// job.go S2-D2:消耗日汇总后台 job(照 StartStatsRefresher 幂等模式;仅 gateway
// 装配调用,测试/迁移工具不启)。
//
// 滚动重刷模型(D2 对 D1 计划的修正,理由见 consume.go 头注):启动回补
// BackfillDays 天(不阻塞启动)→ 周期 RefreshEvery 重刷近 RefreshDays 天
// (默认 4 天=72h 回执窗+当天增量,UNKNOWN 状态迁移靠重刷收敛)。幂等
// UPSERT——多实例/重复跑无害;失败 Warn 不中断,下轮自愈。
package settle
import (
"context"
"time"
"go.uber.org/zap"
"gorm.io/gorm"
"go-sms/internal/pkg/metrics"
)
// StartAggregateJob 启动消耗日汇总 job(goroutine 内自兜底配置零值;
// cfg 三参<=0 时分别取 1h / 4 天 / 7 天,见 config.Settle 注释)。
func StartAggregateJob(db *gorm.DB, refreshEvery time.Duration, refreshDays, backfillDays int, log *zap.Logger) {
if refreshEvery <= 0 {
refreshEvery = time.Hour
}
if refreshDays <= 0 {
refreshDays = 4
}
if backfillDays <= 0 {
backfillDays = 7
}
svc := NewService(db)
go func() {
for i := backfillDays - 1; i >= 0; i-- {
aggregateOneDay(svc, time.Now().AddDate(0, 0, -i), log)
}
if log != nil {
log.Info("settle_backfill_done", zap.Int("days", backfillDays))
}
ticker := time.NewTicker(refreshEvery)
defer ticker.Stop()
for range ticker.C {
now := time.Now()
for i := refreshDays - 1; i >= 0; i-- {
aggregateOneDay(svc, now.AddDate(0, 0, -i), log)
}
}
}()
}
// aggregateOneDay 单日落账 + 指标埋点(失败不返回错误——job 壳内消化,
// 错误计数器持续增长即真故障信号,runbook 口径)。
func aggregateOneDay(svc *Service, day time.Time, log *zap.Logger) {
accountRows, channelRows, err := svc.AggregateDay(context.Background(), day)
if err != nil {
metrics.SettleAggregateErrors.Inc()
if log != nil {
log.Warn("settle_aggregate_failed",
zap.String("day", day.Format("2006-01-02")), zap.Error(err))
}
return
}
metrics.SettleAggregateRows.WithLabelValues("account").Add(float64(accountRows))
metrics.SettleAggregateRows.WithLabelValues("channel").Add(float64(channelRows))
}