Files

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)

  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(出账引擎+阶梯)开工前置=本单归档+回填+提交。