3.2 KiB
3.2 KiB
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)
- 重驻:gw-stop→gw-start,/health ok+md5 一致(6376ba52…);
- JWT 临时签发:HS256+dev secret(config loader 默认值,非侵入不触库),casbin g(1,admin) 通过 recharge 二级权限;
- 全链冒烟:创建(count=123/amount=12.3,pay_status=0,OrderNo=B202611142050471417,余额零动)→confirm(余额 0→123+流水 id=1)→重复 confirm HTTP 409+ISC:039;
- 真库核验: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)与审计适配两项设计实证;
- 清理还原:余额归零/订单+流水删除(审计行保留=冒烟证据,日志性质 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(出账引擎+阶梯)开工前置=本单归档+回填+提交。