[OnePlus-X-code]

📝 变更描述 / Description

集成 #3 的订阅预扣、锁顺序与支付额度换算重构，以及 #4 的 Auto 标记修复，供维护者一次审查后合入 main。分支直接创建自 #4 最终提交 e4722eb；保留 #3（dae9a04a）、#4（e4722ebab）、#5（34b6db14f）全部原始提交。追加提交 0e87a44 仅包含报告、清单与诊断附件，业务树相对 #4 无差异。#5 的持久化退款代码不包含在本 PR。

结论：完整 CI 通过，未发现集成引入的功能、计费或测试回归，可人工审阅合并。仍保持 Draft，等待维护者确认；没有合并或部署。由 Codex 按维护者指示准备，人工确认项保持未勾选。

完整集成报告 · 最简生产发布与回退清单。

合并结论不等于无条件生产就绪：本 PR 仍沿用旧异步退款机制，最终失败后的补偿缺口需在发布前处置。#5 的隔离 SQL 测量确认，关闭批量更新时正常钱包/订阅原额结算分别从 2→6、3→7 条 DML；追加预扣后退款分别从 6→13、9→16。它每轮串行最多处理 100 条，不能保证每分钟 100 条；外部告警尽力投递，旧 master 清理会破坏非终态退款证据。#5 暂不建议发布，需补充容量、告警送达与迁移/回退演练；本轮只评估，没有扩展实现。

🚀 变更类型 / Type of change

• ⚡ 性能优化 / 重构 (Refactor)
• 📝 文档更新 (Documentation)

🔗 关联任务 / Related Issue

集成 #3、#4；独立评估 #5，不引入其实现。

✅ 提交前检查项 / Checklist

• 人工确认: 我已亲自整理并撰写此描述，没有直接粘贴未经处理的 AI 输出。
• 非重复提交: 此 PR 是维护者明确要求的集成入口，代替逐个合入 refactor: unify subscription reservations and wallet quota accounting #3/fix(keys): restore Auto badge presentation contract #4。
• Bug fix 说明: 未关联额外 Issue。
• 变更理解: 等待维护者复核。
• 范围聚焦: 集成 refactor: unify subscription reservations and wallet quota accounting #3 + fix(keys): restore Auto badge presentation contract #4，排除 feat(billing): durable refund retries and reconciliation #5 退款实现。
• 本地验证: 完整后端、独立 relaykit、前端生产构建和私有 PostgreSQL SQL 诊断通过。
• 安全合规: 仅隔离环境验证，无生产数据或真实交易。

📸 运行证明 / Proof of Work

• 最终提交完整 CI 38866605121：主模块/relaykit vet、build、test，前端类型检查/完整测试，以及 PG 16 的 model/service/controller 三组 race 检查全部通过。
• 业务提交完整 CI 38865362440、PR 格式检查通过。Ubuntu 24.04.5、Go 1.25.1、Bun 1.3.14；同 runner main/head 前端原始运行 118/16→179/0，独立文件运行 175/3→179/0，原失败断言保留。
• PG 16 + race 共 60 个叶子用例、66 条父/子 pass 事件，0 失败/跳过；覆盖预扣/退款锁序、额度竞争、重复 request_id、退款/结算竞态、回调/人工补单并发及套餐/流量包契约。
• 本地主模块 1,214 个叶子用例（34 包），独立 relaykit 243 个（6 包），均关闭测试缓存，0 失败；主模块 11 个显式跳过逐项列在报告，其中三项另由 PG CI 实际执行，其余八项未算通过。Windows Bun 1.4.3 冻结安装与 build:check 通过。
• feat(billing): durable refund retries and reconciliation #5 写入测量使用冻结提交、Go overlay、私有 loopback PG 16.14 与合成用户/Key/权益；12 个对照场景均通过并核对最终余额。CSV 逐行与 SQL trace 核对一致；这不是性能基准，未声称吞吐量/生产容量通过。
• 未验证真实浏览器 E2E、MySQL 实例、生产快照、外部通知投递或完整灾难恢复；未访问生产数据库、真实支付和付费上游。私有测试 PostgreSQL 已关闭。