docs(pay): P1 实现计划(数据层+开通重构)+ 哪吒密钥入库标记已定

P1 计划(4 TDD 任务:迁移 000022 双引擎 / subscription.Grant 抽取 / codes 委托 /
payorders 数据访问)+ HTML 阅读版 + 登记 index。设计文档哪吒行更新为已定
(Bitwarden nzzf)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-07-09 23:17:47 +08:00
parent c33ac6d258
commit cc47f16190
4 changed files with 885 additions and 1 deletions
+5
View File
@@ -96,6 +96,11 @@
</a>
<h2>实现计划 / Plans</h2>
<a class="doc" href="pay-orchestration-p1-plan.html">
<div class="t">统一支付编排层 · P1 数据层 + 开通重构(阅读版)<span class="tag html">HTML</span></div>
<div class="d">阅读版;执行真相源 <code>docs/superpowers/plans/2026-07-09-pay-orchestration-p1-schema-grant.md</code>(含 checkbox)。<a href="pay-orchestration-design.html">编排层设计</a>的首个落地阶段(7 阶段之 P1)。建 <b>pay_orders</b>(业务订单/购买账本,order_no 幂等)+ <b>pay_attempts</b>(支付尝试/收款账本,UNIQUE(provider,provider_ref) 幂等)两表;把「开通订阅」从 codes 抽成可传 <code>source</code><code>subscription.Grant</code> 包,<code>subscriptions.source</code> 枚举加 <code>'pay'</code><code>payorders</code> 数据访问含幂等 MarkOrderPaid。4 任务 TDD。P2-P7Provider 抽象/crypto·哪吒 adapter/Flutter 支付页/订单页/端到端)各自成计划、落地前细化。</div>
<div class="path">docs/pay-orchestration-p1-plan.html · 真相源 docs/superpowers/plans/2026-07-09-pay-orchestration-p1-schema-grant.md</div>
</a>
<a class="doc" href="pay-single-address-plan.html">
<div class="t">pangolin-pay 单地址 + 唯一金额收款模型(定稿,#34/34A)<span class="tag html">HTML</span></div>
<div class="d">阅读版;执行真相源 <code>docs/superpowers/plans/2026-07-09-pay-single-address.md</code>(含 checkbox)。<b>定稿:单个固定收款地址 + 每单唯一金额</b>(取代每单唯一 HD 地址/地址池)。归集=1 地址(激活一次、扫一笔)最省;订单靠金额区分。唯一金额=base+微尾数(≤0.01 USDT);精确 == 匹配 + 时间戳(晚于建单)防迟到误配;付错→孤儿人工对账。前端契约不变(POST /order 返回 address+expect_amount)→ 以后升多地址/GasFree 纯后端切、前端零改。5 Phase:数据模型→建单→watcher 匹配/超时/孤儿→归集(能量租赁)→并发/付错真链验证。</div>