3.6 KiB
3.6 KiB
S2-D2 消耗日汇总引擎 人工验收单(2026-11-14)
前置:s2-d1.md(表设计+v20+契约)。本单覆盖 D2:settle 域首批业务代码—— 消耗日汇总引擎(结算域事实源)+ 两端点 + 后台滚动重刷 job。
一、交付物
| # | 任务 | 结果 | 证据 |
|---|---|---|---|
| 1 | settle/consume.go(聚合引擎) | ✅ | AggregateDay:账号×业务→billing_consume_log、通道→stats_channel_daily,一条 GROUP BY(计 SUM(status=N) 计数+Σfee 条)+OnConflict UPSERT(复合 uk 覆盖更新);[lo,hi) 半开窗规避 date() 方言差;cost_total 不写(R1);ListConsume 分页/过滤/时间窗按天归一(零点行不被带时刻参数误滤) |
| 2 | settle/job.go(滚动重刷 job) | ✅ | 对 D1 计划的关键修正:单日 T+1 落账会在 72h 回执窗内失真(UNKNOWN→成功迁移),改为周期重刷近 4 天滚动收敛;启动回补 7 天;配置零值兜底(1h/4/7);失败 Warn 不中断+errors 计数器,幂等下轮自愈 |
| 3 | settle_handler.go(两端点) | ✅ | GET /billing/consume(JWT+customer/group 强制收窄自身,越权带参覆盖不报错)+ POST /ops/settle/aggregate(settle:write 手动回补);D3~D5 端点随任务在本文件追加 |
| 4 | 装配 | ✅ | Deps.Settle 字段+registerSettleRoutes;v1.StartSettleAggregateJob(照 StartStatsRefresher v1 层包装模式);gateway main 挂载于 StatsRefresher 之后;config.Settle 段(1h/4/7)+config.dev.yaml 注释口径;metrics 两件(go_sms_settle_aggregate_rows_total{kind}/errors_total) |
| 5 | 单测 | ✅ | consume_test.go 4 件(正确性多账号×双业务×五状态逐行断言/幂等+跨天边界/UNKNOWN 状态迁移重刷收敛/查询过滤分页)+ settle_handler_test.go 2 件(admin 全量 vs customer 收窄带参越权/手动回补落账+坏日期 4xx) |
二、门禁(七件套后端件)
| 项 | 结果 |
|---|---|
| go vet ./... | ✅ RC=0 |
| go test -race ./...(全量) | ✅ 39 包 ok 零 FAIL(新增 settle 包) |
| golangci-lint v2.1.6 | ✅ 0 issues |
| 集成 | ✅ 沿用 schema/casbin(D1 已过;D2 无新集成面,真库验证见 §三) |
三、dev 实机验证(真 MySQL,2026-11-14)
- 部署串行铁律:make gw-stop→gw-start 三轮(重驻/状态迁移验证/清理后),每轮 /health ok+md5 比对一致(8fd2dfbc…)。
- 端到端落账:SQL 直插 3 条今日明细(账号 1×2:成功+未知/账号 100×1 成功,通道 1)→启动回补自动聚合 → billing_consume_log 2 行(1:sms 2/1/0/1/fee3.0;100:sms 1/1/0/0/fee2.5)+ stats_channel_daily 1 行(3/2/1/cost_total=0)——逐列与 sqlite 单测期望一致;metrics rows{account}=2/{channel}=1。
- 滚动收敛实证:UPDATE 明细 status 4→2 → 重启重刷 → 账号 1 行 success 1→2/unknown 1→0——72h 回执窗迁移收敛语义在真库闭环。
- 指标暴露:/metrics 出现 go_sms_settle_aggregate_errors_total=0(HELP/TYPE 正常)。
- 清理:测试明细 3 条+两表当日行全删(避免僵尸汇总行——热窗内明细不删的边界已文档化),最终干净重驻。
四、口径与边界留痕
- 滚动重刷窗 4 天=72h 回执窗+当天增量;月结建议 T+4 后生成(D4 文档化;generate 幂等重算兜底);
- 汇总行不随明细删除回退(热窗内明细不删;S4 分区清退后历史行冻结);
- 通道维度不含 business/Σfee(通道价格体系不分业务;上家账单按 billing_mode 条数口径);
- job 为 ticker 型(照 StatsRefresher),cronx 保留给已有 alarm/健康巡检用途。
五、验收结论
S2-D2 通过。 D3(充值审核流)开工前置=本单归档+CHANGELOG+回填+提交。