# M07-B 充值优惠

- 日期：2026-06-24
- 起始 commit：`db1d08e`
- 工程 commit：`d9743d3`
- ENGINEERING_DELTA=YES
- 子阶段状态：DONE

## 工程增量

- 新增 `qipai_recharge_plans`，支持充值规则、有效期、适用门店、限购和启停状态。
- 新增 `qipai_recharge_orders`，记录充值单号、客户端请求号、支付记录、支付时间和入账时间。
- 新增 `RechargeService`，创建充值订单时校验规则有效性、门店范围和用户限购。
- 支付成功回调后才调用 `WalletLedgerService.credit` 入账，重复创建请求和重复支付回调均保持幂等。
- 迁移计划、迁移契约、迁移 runner 和全量测试链路已接入 M07-B。

## 验证

- Windows `npm run build`：退出码 0。
- Windows `node tests/recharge-service.test.mjs`：退出码 0。
- Windows `node tests/migration-contract.test.mjs`：退出码 0。
- Windows `node tests/migration-runner.test.mjs`：退出码 0。
- Windows `npm test`：退出码 0，M01-A 至 M07-B 全量后端回归通过。
- 工程 commit 已 push，`HEAD == origin/main == d9743d3`。

## 后续

游标进入 M07-C 优惠券和套餐：实现权益定义、发放、核销、服务端事务扣减，以及与订单/余额流水的联动。