S2-D2 消耗日汇总引擎(settle 域首批业务代码): consume.go AggregateDay(账号×业务→billing_consume_log/通道→stats_channel_daily;GROUP BY+SUM(status=N)+[lo,hi) 半开窗双方言+OnConflict 复合 uk UPSERT;cost_total 不写守 R1)+ListConsume(时间窗按天归一修复);job.go 滚动重刷模型(D1 计划关键修正:单日 T+1 在 72h 回执窗失真→1h 重刷近 4 天幂等收敛+启动回补 7 天,失败 Warn 自愈);两端点(/billing/consume customer 强制收窄+/ops/settle/aggregate settle:write);Deps.Settle 装配+config.Settle 段+metrics 两件;sqlite 测试 6 件含 UNKNOWN 迁移收敛;门禁 vet/-race 39 包/lint 0 全绿;真 MySQL 实机闭环:种明细→回补落账逐列正确→status 迁移重刷收敛(success 1→2/unknown 1→0)→清理+三轮重驻 md5 一致;验收单 s2-d2.md+CHANGELOG+memory-bank 回填
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
# 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)
|
||||
|
||||
1. **部署串行铁律**:make gw-stop→gw-start 三轮(重驻/状态迁移验证/清理后),每轮 /health ok+**md5 比对一致**(8fd2dfbc…)。
|
||||
2. **端到端落账**: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。
|
||||
3. **滚动收敛实证**:UPDATE 明细 status 4→2 → 重启重刷 → 账号 1 行 **success 1→2/unknown 1→0**——72h 回执窗迁移收敛语义在真库闭环。
|
||||
4. **指标暴露**:/metrics 出现 go_sms_settle_aggregate_errors_total=0(HELP/TYPE 正常)。
|
||||
5. **清理**:测试明细 3 条+两表当日行全删(避免僵尸汇总行——热窗内明细不删的边界已文档化),最终干净重驻。
|
||||
|
||||
## 四、口径与边界留痕
|
||||
|
||||
- **滚动重刷窗 4 天**=72h 回执窗+当天增量;月结建议 T+4 后生成(D4 文档化;generate 幂等重算兜底);
|
||||
- 汇总行不随明细删除回退(热窗内明细不删;S4 分区清退后历史行冻结);
|
||||
- 通道维度不含 business/Σfee(通道价格体系不分业务;上家账单按 billing_mode 条数口径);
|
||||
- job 为 ticker 型(照 StatsRefresher),cronx 保留给已有 alarm/健康巡检用途。
|
||||
|
||||
## 五、验收结论
|
||||
|
||||
**S2-D2 通过。** D3(充值审核流)开工前置=本单归档+CHANGELOG+回填+提交。
|
||||
Reference in New Issue
Block a user