qipai/docs/devlogs/2026-06-24-M07-A-双余额账本.md

M07-A 双余额账本

• 日期：2026-06-24
• 起始 commit：8de3d05
• 工程 commit：63711ad
• ENGINEERING_DELTA=YES
• 子阶段状态：DONE

工程增量

• 新增 qipai_wallet_scope_policies，支持租户/门店余额共享范围配置。
• 新增 qipai_wallet_accounts，现金余额和赠送余额分账户保存。
• 新增 qipai_wallet_ledger_entries，所有充值、赠送、消费、退款和人工调整以不可变流水记录。
• 新增 WalletLedgerService，支持入账、赠送优先扣款、人工调整、余额不足拒绝和业务号幂等。
• 迁移计划、迁移契约和全量测试链路已接入 M07-A。

验证

• Windows npm run build：退出码 0。
• Windows node tests/wallet-ledger.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-A 全量后端回归通过。
• 工程 commit 已 push，HEAD == origin/main == 63711ad。

后续

游标进入 M07-B 充值优惠：实现充值规则、有效期、适用门店、限购、启停，以及支付成功后才记账。