交付出件箱

← 返回出件箱

云机会话交接 · 2026-08-13（dev2 · 门店签约 v2 微信支付版）

上一会话上下文将满，本文为完整交接件。新会话读完本文 + 方案文档即可无缝接手，无需回溯对话。

0. 一页速览

项	状态
主线任务	门店签约并行化 v2 · 微信支付版 —— 方案已定稿冻结
代码	一行未写，无半成品需收尾
待拍板	✅ 清零
可立即开工	🟢 批 A（价格管理）零依赖
卡住的	🔑 批 B 卡商户 13 项材料（长官办）· 🔑 `wechatpay-dev-cli` 待 root 装
交付物	方案 1017 行 + 效果图 9 节三端，四处副本 md5 一致

1. 交付物位置（四处落盘 · md5 一致）

件	位置
方案文档（1017 行 / 正文可实施 + 附录评审流水）	`~/reports/门店签约并行化方案v2-微信支付版-20260813.md`（正本） `~/zyai-handbook/` 同名（台账） `~/reports/shared/signup-v2-plan.md`（出件箱） worktree `reports-out/signup-v2-plan.md`（公屏卡片）
效果图（9 节 · 门店端/平台手机端/PC 三端）	`~/reports/signup-v2-mockup.html` · 出件箱 `signup-v2-mockup.html`
公网取件	`https://dev-tokyo.tail3912a6.ts.net/signup-v2-plan.md` `https://dev-tokyo.tail3912a6.ts.net/signup-v2-mockup.html`（用户名 dev，密码见 `~/.claude/CLAUDE.md`）
dev1 微信支付调研原件	`/home/dev1/reports/wechat-pay-handoff-20260812.md`（已合并进方案 §五N）

方案文档结构：开篇「导读」按批次指路 → 〇~九正文（可实施）→ 五A~五AA 专题 → 文末附录（八轮 UI 评审流水，仅供追溯）。

2. 已拍板决策（勿再问长官）

业务

资料审核 ∥ 付款并行（两卡片互不为前置）；线下付款整体去掉
只做 JSAPI（H5 支付微信内不可用；不做 Native 扫码）
平台定单价 × 门店选数量，服务端算钱；不做套餐，PC 新增「价格管理」
增购/续费全价不折算（D8 首登激活：每席独立 365 天额度、首登起算）；续费本就顺延
增购流程简化（废「待确认金额」态、去掉平台逐单定价），与微信支付一起做，不拆批
退款走线下 + 系统标记；已打款给渠道的分成不追讨、年底不计入收入
开通仍手动点；「到账确认」人工动作退役（微信回调自动）
原价划线纯前端展示，service_prices 不加字段；服务端只认 unit_price
不做价格锁定、订单不设有效期（支付成功那刻才锁单价与分成比例）

授权（8-13 新增）

三端强制授权（手机/平板/PC 微信），不设跳过路径
授权提前到入口守卫：签约页 + 复核页共用，会话级判定（非档案级）
拒绝授权不放行，停在授权页给「重新授权」
一人一档：签约链接可分享，但各填各的、各付各的，不允许 A 提交资料 B 付款
授权落地页照抄智脑现网那页（seat-wx-auth-landing.tsx），页面不解释机制
付款人以实际支付那次的 payer.openid 为准

交互/视觉

进度页付款卡显示原价划线 + 现价；「1 个工作日」等时效承诺一律不写
支付按钮「立即支付」（不带金额，上方已显示合计）
点「修改资料」→ 服务费用区隐藏，提交/取消后恢复
账号密码查看：平台侧复用门店端 Redis 72h TTL + 3 次读满即焚，不落库；
不判断"是否已改密码"（72h 机制自然消解）
原价划线 #b4becb（不叠 opacity，文字与删除线分开控制，须比现价轻一档）
列表时间短日期、详情/弹窗带年份
PC 列表不得随意增删列，改了要在图上标注+说明理由
图上「批注 · 不出现在系统中」标头的文字一律不写进代码

3. 🔴 实施红线（动手前必读）

支付代码落 settlement/，不落核心 app/
支付页绝不自动跳微信授权 —— 快照页会拿到虚拟 openid，项目已踩过；必须用户点击才发起
算金额/判到期/算席位禁止读 profile.service_end_at —— 代码自述"三个档案值当展示都会说谎"
订单号禁用 COUNT(*)+1 —— 改 PostgreSQL 序列 + 唯一约束（见 §五V.1）
危险操作（退款/改价/开通）必须留痕：*_by 用 Integer FK users.id，同时写 AuditLog
完工前必跑微信支付 Skill「接入质量评估」，🔴🟠 清零才提验收（§五Z）

4. 自检挖出的坑（已进方案，实施须处理）

#	坑	处置	批次
1	收益账本按「到账确认」生成 —— 那是整条资金链的唯一发动机（7 步：建确认记录/锁两级渠道/取三种分成比例/算分成/建收益快照冻结比例/归结算期/推进订单）	微信回调整段移植 7 步，漏第 5/6 步则渠道分成与月度结算单直接断	B
2	*订单号 `COUNT()+1` 并发撞号**	改序列 + 唯一约束	B 前置
3	永久席位续费会整单 400（注释记载已出过事故）	前端置灰 + 服务端二次校验，判据只有 `seat_valid_days`	E
4	增购自动开通后账号密码无处可查（现网只在 `provisionResult` 内存态）	平台侧加查看入口，读同一份 Redis 凭证	E
5	非微信环境无 UA 检测	抄核心侧 `isInWeChat()`，非微信隐藏支付按钮	C
6	改价历史图上有、表里没有	补独立表 `service_price_changes`（一改一行永不覆盖）	A
7	复核链接是独立入口	与签约页共用同一入口守卫	C
8	拒绝授权无出路	停在授权页 + 重新授权	C

5. 待办与卡点

#	事项	卡在谁
1	🟢 批 A 价格管理 —— 零依赖，一句令即可开工	等长官令
2	🔑 微信商户 13 项材料	长官办。第 ① 项最硬：必须是已认证服务号，订阅号申请不到 JSAPI 权限，不成立则方案推翻
3	🔑 `wechatpay-dev-cli` 待装	已给长官转 root 的原话；根因 npm 全局前缀 `/usr` 属 root。装法：`sudo npm install -g @tenpay/wechatpay-dev-cli@latest`
4	⚠️ PC 微信能否调起 JSAPI —— 官方文档未明述，知识库无	批 B 联调实测（Windows 微信 0.01 元）；不支持的退路是提示改用手机微信

6. 微信支付 Skill（已装 · 会自动触发）

位置 ~/.claude/skills/wechatpay-payment-integration/（43M / 4134 文件 / 知识库 4122 篇）
已生效：工具列表可见，遇「微信支付/JSAPI/回调/签名/证书/错误码」等词自动调用
资源同步已跑通：python3 scripts/wechatpay-resource-sync.py update
⚠️ CLI 未装：SKILL.md 要求每轮先跑 wechatpay-dev-cli knowledge search，现只能直读 assets/ 文档（能溯源，无语义检索）
使用原则（长官定）：照原样跑、不做预防性降级；跑不通如实报错上报（说清哪一步/什么报错/影响什么），不自行绕路、不硬凑

7. 本会话的自伤记账（新会话引以为戒）

DOM 少一个 </div> → 该节吞掉后续所有节 → 长官反馈"格式乱/更丑"的真根因
负 margin 强撑 1440 → 内容溢出屏幕左侧、字段被切 → 不做局部撑破版式
CSS 权重被覆盖 → 改了色值渲染没变 → 只看类名挂上就以为改成了，须放大截图确认
账号密码入口画错端两次 → 门店端本就有，该加的是平台侧
两次说"没问题"后仍被挖出真缺口 → 交底要分层：哪些物理验过、哪些只是纸上推演

8. 环境速查

交付：cp 到 ~/reports/shared/ → 给公网链接 https://dev-tokyo.tail3912a6.ts.net/<文件名>
链接裸写或 [名](URL)，禁止放代码块（放了点不动）；ASCII 文件名
出图：node ~/render-env/browse.js <url> --desktop --script <steps.js>；交付前必跑溢出自查
发版：本仓 MR；改 settlement/ 看 settle-test 流水线（不是 test）
关联记忆：signup-v2-plan-frozen · settlement-decisions-and-pending · mockup-standard · cloud-md-must-give-online-links