# S2-D4 出账引擎+阶梯 人工验收单(2026-11-14 夜) > 前置:s2-d3.md(充值审核流)。本单覆盖 D4:月结出账全链——计价引擎/阶梯/确认/结账/XLSX 导出。 > **D4-0 口径**:Q1~Q6 六项业务口径以方案默认值经用户批准方案后生效(Q1 无价日 0 元入账/Q2 阶梯整月覆写/ > Q3 上家 all=submit/Q4 按生成时点当前 upstream_id 归并/Q5 全业务合并/Q6 状态机 0→1→2)—— > **用户走查补正项见文末**(S2 收官一并人工核)。 ## 一、交付物 | # | 任务 | 结果 | 证据 | |---|---|---|---| | 1 | **settle/price.go** | ✅ | R1/R6 全链唯一换算点:PriceAtAccount(业务线×时间线回溯 EffectiveAt≤当日)/PriceAtChannel/LadderPrice(月量落档取最高 tier_from) | | 2 | **settle/bill.go** | ✅ | GenerateCustomerBills(逐业务逐日计价,阶梯覆写,uk UPSERT 幂等,已结 skipped)/GenerateUpstreamBills(通道→upstream 当前归并,billing_mode 三口径)/Confirm(0→1)/Settle(1→2 CAS+SettleRecord 金额快照同事务)/列表/按天明细/ladder CRUD(同 owner 同 tier_from 唯一) | | 3 | **settle/export.go** | ✅ | excelize:下家=单头+按天明细;上家=单头+通道×天明细(含单价列) | | 4 | **handler 15 端点** | ✅ | customer 6/generate/upstream 5/ladder 4;settle:write 门;customer 账单仅自己(handler scope);上家域平台角色门 | | 5 | **测试 6 件**(settle 包 5+handler 1) | ✅ | **阶梯结算单测(S2 显式验收项)**:首档覆写 7.5/恰好落档 1000→40.0/删阶梯回退时间线;时间线月中调价按日分档(10.0+10.0);上家三口径(4.4/4.5)+未绑通道不入账;状态机 0→1→2+SettleRecord 快照+终态幂等;ladder CRUD+重复档 400;handler 全流程(生成→配档重算 5→确认→结账→skipped→导出 PK→403 门) | ## 二、门禁(七件套后端件) | 项 | 结果 | |---|---| | go vet ./... | ✅ RC=0 | | go test -race ./...(全量) | ✅ **39 包 ok 零 FAIL**(settle 包 14 件) | | golangci-lint v2.1.6 | ✅ 0 issues | ## 三、真机验证(dev,2026-11-14 21:34,HS256 临时 token) **出账全链**:种价(0.10)+消耗(succ=100)→生成 `{generated:1}`(时间线金额 10)→配阶梯(0 档 0.05)→重算 `{recalculated:1}`(**覆写 5**=100×0.05)→列表 amount=5 ✓→确认→结账(**SettleRecord:direction=1/amount=5/operator=admin/settled_at**)→再生成 `{skipped:1}`(已结拒重算)→**导出 5637 字节真 XLSX**(`file` 识别 Microsoft Excel 2007+)。数据已清理还原。 ## 四、口径留痕(修复过程) - settleBill 金额快照:Pluck 链式复用导致列类型污染(sqlite 实测暴露)→ 改 Select+Scan 单查询; - isDuplicateKey 补大小写归一(sqlite 2067 码 "UNIQUE constraint" 小写实测暴露); - 手动建表方言坑第三例:settle_upstream 的 idx_period 与 settle_customer 同名(测试侧无索引+显式 UNIQUE 约束版本)。 ## 五、用户走查(补正项,七件套·本人走查) - 走查脚本已备:`docs/acceptance/scripts/s2-walkthrough.sh`(覆盖 D2/D3;D4 出账链建议随 S2 收官走查一并执行——生成/阶梯/结账/导出 curl 序列与 §三一致)。 - **结果:待用户执行后回填**(此前 D2/D3 验收为自动化测试+AI 冒烟,本人走查项以此补正)。 ## 六、验收结论 **S2-D4 通过(自动化门禁与真机冒烟);用户走查项在途待回填。** D5(利润/返点/三方对账)为 S2 收官任务。