Files

40 lines
3.2 KiB
Markdown

# S2-D3 充值审核流 人工验收单(2026-11-14)
> 前置:s2-d2.md(消耗日汇总)。本单覆盖 D3:BillingOrder 订单审核族(R3 双通道裁决落地)。
## 一、交付物
| # | 任务 | 结果 | 证据 |
|---|---|---|---|
| 1 | **settle/recharge.go** | ✅ | CreateOrder(count 1~100 亿校验/账号存在性/pay_status=0 **不动余额**;OrderNo=B+时间戳+4 位随机,uk 冲突重试一次)/ConfirmOrder(**单事务四步**:状态 CAS(WHERE pay_status=0,RowsAffected=0→ISC:039)→余额原子自增 count→同事务回读→流水 ref_id=order_no)/RejectOrder(0→2 CAS 不涉余额,remark 留痕)/ListOrders(过滤分页 id 倒序) |
| 2 | **错误码 ISC:039** | ✅ | 「订单状态冲突(非待确认)」HTTP 409;**三处同步**:codes.go+registry 手工清单+x-isc-dict+dict.ts 再生成(52 码);openapi_sync_test 双向锁绿 |
| 3 | **四端点** | ✅ | GET /billing/orders(平台角色 admin/ops/service;group/customer 403)+POST /billing/orders、/:id/confirm、/:id/reject(挂 account:recharge 二级权限,与即时充值同门);审计自动留痕(module=billing action=orders:post/confirm:post) |
| 4 | **测试 7 件** | ✅ | service:创建校验(0/负/超限/账号不存在/OrderNo 唯一批量 21 单)/confirm 事务语义(paid_at+operator+流水四字段+balance_after 一致)/状态机(重复 confirm 409 且余额二次不变;已确认 reject 409;不存在 404)/**并发 confirm 恰一成功**(-race)/驳回/列表;handler:全流程(创建→列表→confirm→409 ISC:039)/权限(恒拒 checker 403+customer 列表 403) |
## 二、门禁(七件套后端件)
| 项 | 结果 |
|---|---|
| go vet ./... | ✅ RC=0 |
| go test -race ./...(全量) | ✅ **39 包 ok 零 FAIL** |
| golangci-lint v2.1.6 | ✅ 0 issues |
| openapi_sync_test + codes_test 数量断言 | ✅ 52 码同步(测试断言随更) |
## 三、真机验证(dev,2026-11-14 20:50)
1. **重驻**:gw-stop→gw-start,/health ok+md5 一致(6376ba52…);
2. **JWT 临时签发**:HS256+dev secret(config loader 默认值,非侵入不触库),casbin g(1,admin) 通过 recharge 二级权限;
3. **全链冒烟**:创建(count=123/amount=12.3,pay_status=0,OrderNo=B202611142050471417,**余额零动**)→confirm(**余额 0→123**+流水 id=1)→重复 confirm **HTTP 409+ISC:039**;
4. **真库核验**:account_balance_log(biz_type=recharge/amount=123/balance_after=123/**ref_id=order_no**/operator=admin)+ system_operate_log 自动留痕(module=billing action=orders:post/confirm:post)——**双通道区分锚点(ref_id)与审计适配两项设计实证**;
5. **清理还原**:余额归零/订单+流水删除(审计行保留=冒烟证据,日志性质 append-only);临时 token 清除。
## 四、口径留痕
- **双通道语义**(R3):即时充值=已线下确认快捷入账(流水 ref_id 空);订单流=付款审核确认(流水 ref_id=order_no)——D5 对账以 ref_id 有无区分两通道;
- 并发安全:MySQL 行锁路径(与 account.Recharge 同代码形态,POC 期已真库验证)+ sqlite 单连接串行 CAS 语义等价(单测覆盖);
- OrderNo 可读风格与 TaskNo(T 前缀)对齐,B 前缀=billing 域。
## 五、验收结论
**S2-D3 通过。** D4(出账引擎+阶梯)开工前置=本单归档+回填+提交。