需求：UI 变化先出 web 预览¶
结论：UI 变化先出 Web 预览的要求已并入研发工作流 S5。
版本 0.3（已并入）· 2026-10-13
本文件是 workflow.md 的一条补丁需求。已并入主本 0.6 与仓库本 0.5。
主本对应 S5，仓库本对应 S5。本文件保留作依据。
1. 目的¶
给工作流补一道设计闸门。 UI 变化在实施前先出可点的预览，供评审判断是否符合表现预期。
2. 范围¶
适用于一切改变用户可见界面的功能。 不改变界面的改动不受约束。
3. 需求¶
| 编号 | 需求 | 判据 |
|---|---|---|
| R1 | 功能涉及 UI 变化时，实施前必须产出 web 预览 | 预览可打开，主路径可点 |
| R2 | 预览用 web 的 Compose 编写 | 产物是浏览器可打开的页面 |
| R3 | 预览通过评审后，才可开始实施 | 评审结论已写回 issue |
| R4 | 评审对照需求正文的「表现预期」逐条判断 | 预期逐条有结论 |
| R5 | 评审结论写回 issue 正文，不写评论 | 只读正文就能看到结论 |
| R6 | 打回时不关闭预览项，列出差异，改完重评 | 差异逐条关闭 |
| R7 | 预览覆盖主路径 | 主路径无死路 |
| R8 | 预览地址与截图记入 issue | 评审人可自行打开 |
| R9 | 预览不是交付物 | 发布物不含预览 |
| R10 | 大功能的预览是第一个 sub-issue，实施 sub-issue 阻塞于它 | 依赖关系在 GitHub 上可见 |
| R11 | 小功能的预览写在同一 issue 里 | 正文含预览结论 |
| R12 | 需求正文必须有「表现预期」一栏 | 表单必填 |
4. 分级¶
| 档 | 用在 | 覆盖 | 工期 |
|---|---|---|---|
| 单屏预览 | 已评审界面的小改动 | 一屏 | 半天内 |
| 交互原型 | 新界面，或交互变化 | 主路径 | 2 个工作日 |
5. 例外¶
清单外的 UI 变化一律要预览。清单是穷举的。
- 纯逻辑、数据、性能或构建改动，外观不变。
- 文案与标点修正。
- 内部重构，外观不变。
- 依赖升级，外观不变。
- 已评审界面的同构复制，交互不变。
6. 角色¶
| 角色 | 职责 |
|---|---|
| 负责人 | 产出预览，写结论 |
| 评审人 | 对照表现预期判断。由非作者担任 |
| 单人仓库 | 负责人自查，结论照样记录 |
7. 待确认¶
- 评审人：非作者评审，还是单人时一律自查。
- 预览地址：本地服务，还是 Pages。
- 时间盒：半天与 2 个工作日是否合适。