From ff91be928a78130f6ead8b6aa7428220058698ee Mon Sep 17 00:00:00 2001 From: wangjia <809946525@qq.com> Date: Sun, 12 Jul 2026 00:07:51 +0800 Subject: [PATCH] =?UTF-8?q?docs(pay-v2):=20=E5=BC=80=E5=8F=91=E5=86=B3?= =?UTF-8?q?=E7=AD=96=E6=97=A5=E5=BF=97=20step3-4(=E5=AE=A2=E6=88=B7?= =?UTF-8?q?=E7=AB=AF=E8=90=BD=E5=9C=B0=20+=20=E9=9B=86=E6=88=90=E6=B5=8B?= =?UTF-8?q?=E8=AF=95)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u --- docs/pay-v2-dev-log.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/pay-v2-dev-log.md b/docs/pay-v2-dev-log.md index 2d35560..9668743 100644 --- a/docs/pay-v2-dev-log.md +++ b/docs/pay-v2-dev-log.md @@ -26,3 +26,21 @@ - main.go：注册 `GET /v1/pay/orders`。 - 测试：新增 List 越权/倒序/富字段、下单展示金额分币种、详情富字段；**修 3 个 pre-existing 迁移测试**（renumber 21→23 遗留）。`go test ./...` 全绿。 - 决策：USDT 展示价放服务端 catalog（$4.99/$12.99/$34.99），客户端 switch 直接读，不硬编码；实际扣款仍以 pay 侧为准。 + +## [step3] 客户端 Flutter 落地（2026-07-11） +- 探查结论：购买/支付主干已存在（Riverpod + payment_api + payment_page 多态渲染）；缺订单列表/详情整链 + 购买页 segswitch/分币种。 +- **锁定共享契约（主 agent 手写，防并行冲突）**： + - models/payment.dart：`PayChannel{usdt,cny}`（.currency/.method）；`PayCatalogItem.priceUsdtMicro` + `priceLabel(ch)`/`perMonthLabel(ch)`/`months`（**priceLabel 改带参**）；新 `PayOrderSummary`；`PayOrderStatus.summary` 富字段。 + - payment_api.dart：`listOrders()`。 + - l10n：+19 getter（支付渠道 switch 4 + 订单 15）×6 语言，l10n 闸绿（209×6）。 + - StatusPill 复用（created→connecting/等待付款、paid→connected/已开通、canceled→neutral/已取消）。 +- **两 agent 并行建屏**：A=SegSwitch widget + purchase_page 重构(渠道 switch 置顶、分币种价、删底部弹窗) + payment_page 订单卡；B=orders_provider + orders_page(列表+详情) + 导航(NavView.orders + desktop_shell + account 入口)。 +- 决策：USDT 展示价由服务端 catalog 下发（不客户端硬编码）；「继续支付」MVP 走购买页重下单（retry-resume 列为后续）。 + +## [step4] 集成 + 测试 + 提交（2026-07-12） +- 整体 `flutter analyze` 0 error（3 个 pre-existing info：withOpacity×2 + unused import）。 +- `flutter test` 226 全绿：修 priceLabel 带参、假 API 补 listOrders、购买页测改成默认 USDT+切 CNY 断言、新增订单列表/空态/详情测试、golden 重录（icon 迁移+账户订单入口+连接键 loader）。 +- 服务端 `go test ./...` 全绿。 +- l10n 19 getter ×6 语言补 @override，check-l1-sync 绿（209×6）。check-ds 绿。 +- **提交**：a5adbf3 server / f6ce526 design / 272eca0 client。→ push + draft PR。 +- 遗留（非阻塞，明日可议）：订单「继续支付」走重新下单（非 retry-resume）；订单无 expired 本地态；`local-l13-start.sh` 是本地联调脚本(含 throwaway 密钥)不入 git。