docs(M05-A): 记录统一支付验收并推进微信支付

2026-06-20 14:31:39 +08:00
parent 6c506ff862
commit dea2ee5ee1
5 changed files with 40 additions and 12 deletions
@@ -0,0 +1,28 @@
+# M05-A 统一支付领域
+
+- 日期：2026-06-20
+- 起始 commit：`f9ec0af`
+- 工程 commit：`6c506ff`
+- ENGINEERING_DELTA=YES
+- 子阶段状态：DONE，已 push 且 `HEAD == origin/main`
+
+## 工程增量
+
+- 建立支付单、支付尝试、回调、退款单、分账单和分层支付配置模型。
+- 支付金额只取订单服务端未付金额，客户端金额字段被严格拒绝。
+- 支付创建使用 clientRequestId 幂等，回调使用 provider + callbackId 唯一约束。
+- 错误金额回调保存为 REJECTED，不更新支付单、订单金额或状态。
+- 成功回调在单事务内更新支付、订单已付金额、PAID 历史和房间预占。
+- 支付配置按门店、租户、小程序层级解析，只保存环境变量等凭据引用。
+- 测试支付适配器默认关闭，仅非生产环境显式开启后可用。
+
+## 验证
+
+- Windows 后端全量测试和仓库门禁通过。
+- WSL MySQL 8.4.9 临时库执行 `up → verify → down → up → verify` 通过。
+- 迁移语句：up 75、verify 54、down 69。
+- 实测服务端金额、支付单幂等、错误金额回调留档、重复成功回调不重复记账、门店配置优先级和生产环境测试适配器强制关闭。
+
+## 后续
+
+M05-B 接入微信支付预支付、签名、回调验签、主动查单、退款、退款回调和对账。