v3 MVP 上线版 · 分支策略与页面清单

执行:小齐 | 2026-09-27 00:0x | 授权:刘总「你帮我决定后处理吧」
基线 749bb336 | 分支 release/mvp-v3 | v3 页面 25 → 24

〇、口径更正(刘总 2026-09-27 00:1x 纠正,小齐原表述错误)

刘总原话:「不是 v3 冻结,应该是 v3 改版吧?」

我原表述错在哪:我把 v3 当成「要被冻结保存的旧版本」,据此设计了「冻结分支 + main 继续开发 + 双向 cherry-pick」,并建议 v4 另起 miniprogram-v4/ 目录。三条全错。

正确口径(按刘总):

误(我的)正(刘总)
v3 冻结成上线版v3 持续改版,冈子做的完整版就是改 v3,不是另起 v4 目录
v4 = 新目录无 v4 目录,v3 改到完整版为止
MVP 分支双向同步MVP = 改版途中的一次性快照,单向,不回灌

快照的性质:切出去就不再跟改版。改版产生的新功能不进快照;只有「上线前必办项」(见第三节风险表,如 home 测试开关、feedback mock 字样)才在快照上单独改,且这些改动不要求反向回灌 main——因为完整版出来后整体替换,快照即作废。

由此消除的风险:v4 若另起目录,foundation-library(令牌 496 / 原则 10 条 / validate V0-V14)存在被复制一套、另起色板的风险(刘总 09-2x 纠过「未执行基础库=平行造轮子」)。v3 原地改版则天然共用同一棵树的 docs/design-system/foundation-library,该风险自动消失。

由此新增的风险(唯一):改版不停 ⇒ 快照时点必须挑在 v3 处于可提审状态时。若冈子改版把某页拆到一半,那一版不能切快照,须等该页落地。判据见第四节第 6 条。

一、四项裁决(原待拍板项,现由小齐定)

项裁决理由
① 基线 commit749bb336含当日 F3 拼贴 / F4 压图 / F6 露半张 / F8 叶形卡四版式改造。不带改造上线=刘总批过「方方正正太土」的版本,不能出
② 页面去留24 页全留,只砍 debug-gallery实测:除 dev-only 页外每页都有 ≥2 处真实入口引用(selection 12 / hotel-booking 13 / orders 13…),包体已收敛;删页=断链路,MVP 与完整版的差异应靠「快照时点」而非「砍功能」(原写「冻结」,按〇节更正)
③ selection(玩法页)保留页面、不删不改小冈 WIP-275 文件锁 🔒 在 selection/profile/local,我不擅动;tabBar 已换风物,该页非入口,不构成提审风险
④ 示例图 / 示例商品不标注,沿用刘总 2026-09-22 三裁口径AI 示例图作示意(后期按参考人工补拍)已批准;shop 示例商品 6 件亦为刘总令「示例先行、A 端配置后自动失效」

二、24 页去留表

判定依据:入口引用数(全仓 wxml/ts/json 中被指向次数;1 = 仅 app.json 注册无入口)。

页面tab入口判定备注
home✅ 首页33必留含「长按 logo 开测试内容」dev 开关,见风险表
local✅ 在地19必留
shop✅ 风物3必留示例商品 6 件,A 端键位已预留
profile✅ 我的12必留券链路入口(WIP-274)
login / privacy-auth / agreement—12 / 3 / 4必留登录与合规页,缺一不可审
feedback—11必留首页 FAB「问客服」入口
orders / order-detail / redemption-code—13 / 5 / 12必留订单与券码链路,WIP-274 刚接线
hotel-booking—13必留首页 dest-scroll 双卡入口
content-library / content-article—13 / 8必留文库与内容详情
journey—11必留行程管家
selection—12保留无入口🔒 小冈重排中,不碰
voice-guide / health-check / passport—8 / 9 / 9保留有入口,功能主链路外
merchant-store / guide-companion / status-timeline—5 / 3 / 4保留有入口
review / share-code—3 / 2保留入口较弱,留观
debug-gallery—1已砍dev-only 组件验证页,仅注册零引用

三、上线前风险清单(未擅自改,逐项报)

风险位置现状建议
「测试内容」长按开关home.ts onBrandLongPress长按品牌 logo 可切测试内容(dev 演示)保留(开发/刘总看数用);若提审从严可在 MVP 分支关掉,请刘总一句话
示例数据orders / passport / hotel-booking / shop示例项先行,价格未配显示「—」符合铁律(零硬编码业务数字),不处理
占位文案share-code含「占位」字样上线前由归属人替换为 A 端配置键
测试内容标记content-library / voice-guide含测试内容开关读取同 home,属既有开关
cover 图带 lorem 水印后端 guides 数据(pole.jpg 等)占位水印图非前端问题,上报波波由运营换图
mock 字样feedback代码内出现 mock待核(若是假数据须清;红线)

四、分支协作纪律(快照与改版如何共存)

⚠️ 本节已按〇节刘总口径更正:v3 持续改版,MVP 是快照,单向不同步。原「冻结 + 双向 cherry-pick」表述作废。
  1. main 继续改版(我的版式改造、波波后端接线、小冈三页重排、冈子完整版改造)。不停。
  2. release/mvp-v3 = 一次性快照:切出去后不再接收新功能,只做减法与「上线前必办项」的单独修复。
  3. 共享面契约冻结(关键,与改版并行仍有效):f-gallery / registry.ts / m-content-feed —— 只扩参数、不改字段名、不删版式。小冈 WIP-275「页面只组合禁手搓」依赖这些库件,我改前先同步小冈。
  4. 单向,不回灌:改版产生的新功能不进快照;快照上的必修项也不要求反向回灌 main(完整版出来后整体替换,快照作废)。—— 原「双向 cherry-pick」作废,那是建立在「v3 长期演进」上的错误前提。
  5. 文件锁:pages/selection/* 🔒 / pages/profile/* 🔒 / pages/local/* 🔒 属小冈,我不动。
  6. 快照时点判据(新增,改版不停带来的唯一风险):只有在 v3 处于可提审状态时才切快照。判据三条全绿方可切:①app.json 无 dev-only 页(本快照已满足:24 页);②无拆改到一半的页面(判法=该页 .wxml 引用的组件在 .json 的 usingComponents 中全部在位);③tsc 仅基线错(当前=miniprogram-api-typings 缺失 1 错)。任一条不绿,等改版落地再切,不许带着半成品上线。

五、本分支已执行改动