预埋板块视觉验收记录 · product-detail

目的:按 gpt6 9 项视觉验收 checklist,对「通用模块渲染器」迁移后的 product-detail 做真机逐项打勾。
铁律(gpt6):默认关的功能也必须视觉验收,不能只靠"不显示"蒙混;分包不是审核隔离区。
代码基线:4796c03a(feat: 通用模块渲染器 + 预埋板块策略落地)。

一、基本信息

项值
页面pages/product-detail
代码版本(commit)4796c03a
验证环境微信开发者工具 + 真机预览(iOS / Android 各一台)
基础库版本______(建议 ≥ 2.32.3)
验证人______
验证日期2026-__-__
结果汇总通过 ____ 项 / 阻断 ____ 项

二、前置准备:临时开启预埋块(开 flag 验渲染)

真改了代码包,上传前必须先验再提审。以下任选一种,验完务必还原:

方式 A(推荐,本地临时改,不影响线上数据)

  1. 打开 miniprogram-v3/utils/detail-config.ts
  2. 在 DEFAULT_PAGE_CONFIGS.PRODUCT_DEFAULT.modules 中,把 leader / gallery / video / notice 四个模块的 enable 临时改为 true
  3. 开发者工具「编译」→「真机预览」扫码
  4. 验收完成后 git checkout 还原该文件,不要把这个改动提交

方式 B(A 端开关,动 staging/prod 数据)

方式 C(预览参数,已内置实现,推荐 ✅)

pages/product-detail/product-detail?id=<真实套餐id>&__preview=gallery,video,notice,leader


三、模块逐项验收

#模块type默认态验证动作预期渲染结果(✓/✗)备注
1头图/标题hero常显正常进页大图 + 标题 + 副标题 + 价格,不参与 wx:for,独立渲染[ ]
2商品介绍intro常显正常进页取真实 description 渲染;无描述时整块隐藏不报错[ ]
3费用包含includes常显正常进页includes 数组 join 成条目列表;空数组时隐藏[ ]
4领队同行leader默认关用方式 A/B/C 开启显示领队名 + 标签;关闭时整块不渲染(无占位/无泄漏)[ ]
5核销说明redeem常显正常进页核销规则文本/条目;无数据时隐藏[ ]
6温馨提示notice默认关开 flag纯文本提示块,样式走 token;关闭时不渲染[ ]
7实拍图集gallery默认关开 flag + 多图3 列网格(.g-grid),单图 200rpx 高;无图时隐藏;多图不卡[ ]
8视频展示video默认关开 flag + videoUrl<video> 原生控件可播放/全屏;无新权限 scope;无 URL 时隐藏[ ]
通过准则:默认关的 4 块(leader/notice/gallery/video)在「关」时必须完全不渲染、不留空白占位;在「开」时必须正常渲染且风格一致。

四、gpt6 九项横切验收

#验收项验证方法预期结果(✓/✗)备注
1窄屏不溢出/不挤压iPhone SE 1st(320pt) 或 开发者工具 320 宽无横向滚动、文字不重叠、图集不破版[ ]
2常规屏排版正常iPhone 12/13(390pt)间距/留白均衡,模块间距一致[ ]
3长标题不破版标题 >20 字不截断(或合理省略号)、不撑破 hero[ ]
4多图不卡gallery 开 + >8 张图网格流畅,无长白屏;建议懒加载[ ]
5空数据兜底intro 无 description / gallery 无图 / leader 无数据对应块隐藏,页面其余正常,绝不白屏或 JS 报错[ ]
6setData 体积DevTools Audits 截 renderModules单页 renderModules < 30KB;大图走 CDN 不全量进 setData[ ]
7token 一致性取色核对所有色值全部走 --color-* / --space-* 变量,无裸 hex 回退[ ]
8视频控件video 开 + 点播放原生 <video> 可播/可全屏;确认审核无新增 scope[ ]
9顺序与分享卡调整 modules 顺序后预览模块按配置顺序渲染;onShareAppMessage 标题/图取商品正确[ ]

五、阻断 / 风险项


六、签字确认

角色姓名日期结论
执行验收______2026-__-__通过 / 驳回
复核(波波)______2026-__-__准予提审 / 打回

关联文档:docs/reports/2026-09-29-预埋板块清单-波波.md(各常用页预埋板块清单表 + gpt6 架构建议)
回归记录:Node harness buildRenderModules 17/17 通过(默认隐藏 leader、A 端覆盖启用、空态兜底、未知类型告警跳过、增量追加实例)