Files

109 lines
9.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PRD 板块计划(v1.3 多场景模块化)
| 项目 | 内容 |
| --- | --- |
| 依据 | `shaping/v1.3-多场景模块化/06-shaped-brief.md` 2026-11-03 确认版;`07-product-spec.md` 定型基线 |
| 上游规格 | `prototype/v1.3-多场景模块化/01-SPEC.md`(205 个功能点,手机 90、平台 72、眼镜 43)、`04-components.md`、`05-data.md` |
| 设计基线 | `reference/DESIGN.md` |
| 交付形态 | 每个板块一份 Markdown + 对应高保真 HTML 原型 + 页面注释 |
| 模块序号 | 01–09 为正式 PRD;S8–S17 为定型依据;R1–R2 为设计参考;00 为过程产物 |
## 1 为什么拆成九个板块
拆法按「一个端一个作业单元」,不按章节体例。三端的交互模型互不重叠(眼镜靠语音与形状编码、手机靠触屏、平台靠表格与表单),写在一份里会反复切换语境;账号与授权、法规问答各自跨端、各有独立状态集与验收口径,塞进任一端都会让那一端失真。
三端合计 205 个功能点(手机 90、平台 72、眼镜 43),另加六个场景与四种判定结构的横向规则。
## 2 板块清单
| 序号 | 板块 | 目标(交付后读者能答什么) | 不写什么 | 依赖 | 原型页 | 状态 |
| --- | --- | --- | --- | --- | --- | --- |
| 01 | 产品定义与目标 | 这是什么产品、卖给谁、一期做到哪一步、明确不做什么 | 字段、交互、页面结构 | 定型摘要、产品说明书 | 无 | 待审(G2 已交付) |
| 02 | 用户与需求分析 | 八类用户各自要什么、权限如何按岗位切、JTBD 的两种驱动 | 页面级方案 | 01 | 无 | 待审(G2 已交付) |
| 03 | 用户故事与旅程 | 三端主旅程、故事与验收条件、四个场景族如何分叉 | 控件细节 | 01、02 | 无 | 待审(G2 已交付) |
| 04 | 眼镜端 · 现场主交互 | 六屏各显示什么、说哪句话发生什么、断连与丢失怎么办、L0/L1 如何退化 | 手机与平台页面 | 03、R1、R2 | P16 P17 P22 P23 P24 P18 | 待审(G4 已交付) |
| 05 | 手机端 · 链路与兜底 | 九页的区域、功能点、状态矩阵、跳转;四种任务布局如何由判定结构驱动 | 授权模型本体、问答答法 | 03、04(核对检查对象与提交需与眼镜对齐) | P25 P01 P19 P02 P03 P04 P20 P06 | 待审(G4 已交付) |
| 06 | 平台端 · 场景口径与留档 | 七页的区域与功能点、场景启停、模板冻结与版本、识别键列头、六个统计量 | 五角色矩阵全量展开(在 07)、问答答法(在 08) | 03、04、05 | P08 P21 P11 P12 P10 P13 | 待交付(G4) |
| 07 | 账号与授权 | 五角色十一动作、两层授权、三级范围、并集与撤授的判定顺序、手机准入拦截 | 各端页面布局(P09 的布局在 07,其余端只写规则) | 06(P09 落在平台菜单) | P09 | 待交付(G4) |
| 08 | 法规问答与 AI 能力 | 问什么答什么、条款号与兜底、检索日志、四类 AI 能力的边界 | 语料建设方法与模型选型 | 03、R1 | P05 P14 | 待交付(G4) |
| 09 | 全局约束与验收收口 | 全局硬规则、术语与禁用词、非功能要求、验收项与指标、未闭合清单 | 重复各板块已写的规则 | 全部 | 无 | 待交付(G4) |
功能点归属对账:眼镜 43 全归 04;手机 90 中 81 归 05、9 归 08(P05);平台 72 中 54 归 06、11 归 07(P09)、7 归 08(P14)。合计 205,与 `01-SPEC` §3 一致。
## 3 交付顺序与门禁
| 门禁 | 内容 | 停下等什么 |
| --- | --- | --- |
| G0 | 定型摘要已确认(2026-11-03 字面「用户确认」),本计划不改定型口径 | 已通过,不再回问 |
| G1 | 本文件 + manifest 模块顺序 | 确认板块拆分与原型页归属 |
| G2 | 01、02、03 三篇基础分析 | 确认三篇可作后续依据 |
| G3 | 复核 `reference/DESIGN.md`;重建组件展示页与状态展示页(C-01 ~ C-53) | 确认设计基线与组件清单 |
| G4 | 04 → 05 → 06 → 07 → 08 逐模块,每次提交一个板块的 PRD + 原型 + 注释 + 关系变更 | 每模块单独确认 |
| G5 | 09 全局收口 + 全量校验 + 隐藏 00 计划模块 | 终审 |
G4 的模块顺序按依赖排,不按序号重要度:眼镜先行,因为手机的核对检查对象、提交与回执都要与眼镜的判定事件对齐;平台最后,因为它读的是前两端产生的事实。
## 4 原型资产计划
25 个页面切成 26 个 HTML 文件(P12 多一个 Tab 对照页),三个固定视口。
| 端 | 视口 | 页面 | 功能点数 | HTML 数 |
| --- | --- | --- | --- | --- |
| 手机 | 375×812 | P25 P01 P19 P02 P03 P04 P20 P06 P05 | 90 | 9 |
| 平台 | 1440×900 | P08 P21 P11 P12(含 Tab 对照)P10 P09 P14 P13 | 72 | 8 |
| 眼镜 | 1280×720 | P16 P17 P22 P23 P24 P18 | 43 | 6 |
| 参考 | 1440×900 | 组件展示、状态展示 | — | 2 |
P07 已停用并入 P06,不出页面。v1.2 的 20 个旧页与 19 份旧注释已移到 `archive/v1.2-workspace/`,不入 manifest。
原型共享层只放一次:`prototypes/shared/` 承载令牌、手机与平台页框、眼镜 `gl-*` 屏框,页面文件只写本页内容。新增组件从 C-35 起编;C-01 至 C-34 只改语义不改编号。
## 5 每个板块的审核标准
统一五条,逐模块检查,缺一条不算交付。
1. 功能点对得上:`01-SPEC` §3 的功能点编号在本板块内全部出现,逐条写明角色与前置、触发、规则、结果、异常与空态、验收方式。
2. 原型可点通:页面内跳转与 manifest 关系一致,画布卡片不重叠,标注可逐条点击验证落点。
3. 规则不打架:与 09 全局硬规则、07 授权判定、06 模板版本这三处口径一致;冲突时改后写的一方,并回写前一处。
4. 词族正确:检查项用「符合/不符合/不适用」,送检用「核验合格/核验不合格」且带出具机构;不出现「超标」「违法」「应当处罚」,「合格/不合格」不得单独作为检查项判定值出现。
5. 未闭合项标注到位:凡引用客户未提供的输入,标 `[未取]` 并指回 `05-open-questions.md` 编号,不留空白也不编数。
6. Mock 数据自洽:页面上的账号、车号、项名、条号、时间、任务号、进度数一律取自 `reference/mock-data.md`;同一任务跨页的已查数与项总数要能算出等式,同一对象跨页的属性不得互相矛盾。
## 6 未闭合项的处理约定
下列六项在 PRD 中按设计值落稿,标注来源编号,不作为交付阻塞。
| 编号 | 内容 | PRD 中的写法 |
| --- | --- | --- |
| V13-Q13 | M01 检查项草案与限值 | 示例数据,标「待客户确认后替换」 |
| V13-Q44 | 素材与检索日志保存期限 | 写「按执法档案长期保留」并标 `[未取]` |
| V13-Q05 | 送检时限 | 只写超期提醒机制,不写具体天数 |
| V13-Q25 / Q43 | 实机分辨率、单色或彩色、刷新率 | 按 1280×720 与 `gl-*` 令牌落稿,注明复核后只换令牌 |
| V13-Q28 | 主页眼镜信息字段集合 | 四项(连接态、路径、电量、固件版本),标可删一行 |
| V13-Q45 | 车辆档案正式数据源 | 一期写本地 mock,正式对接另立接口条目 |
## 7 与仓库既有资产的关系
`prd/v1.1-指令配置管理/`、`prd/v1.2-语义意图路由/` 是历史单文件 PRD,保留不改。本目录 01–09 是 v1.3 唯一现行版本;旧根目录的 `04-mobile-field.md`、`05-law-qa.md`、`07-global-and-acceptance.md` 由 05、08、09 取代,删除后可在 git 历史取回。
`shaping/` 根目录的 00–07 是 v1.2 单场景基线,`shaping/v1.3-多场景模块化/` 是现行定型。底座把 v1.2 基线七篇收在 S1–S7 并置为隐藏,现行定型收在 S8–S17,避免读者拿旧口径对新页面。
## 8 与上游规格的一处冲突(已关闭)
眼镜能否发起切场景请求,材料原本内部不一致。定型正文三处(`06` 关键规则、`07` 关键规则、`05` 已关闭表)写「仅场景切换需手机确认」,读作手机是执行者;`00i` §2 第 3 条写「只做当前场景播报」;`03-scope` 眼镜端做表第 6 项却留了「发起切场景请求」,`01-SPEC` 把它实现成手机端一条「知道了」横幅,点了不执行。
裁决取最保守的一条:眼镜不选择、不发起请求,只播报当前场景,起单复用上次场景,切换唯一入口是手机主页卡片。上游四处已按此改完。
| 上游文件 | 原状态 | 现状 |
| --- | --- | --- |
| `shaping/v1.3-多场景模块化/03-scope.md` 眼镜端做表第 6 项 | 播报场景、发起切场景请求 | 改为只播报当前场景,并写明切换唯一入口在手机;暂缓表同步扩到「本地切场景与向手机发请求」两项 |
| `prototype/v1.3-多场景模块化/01-SPEC.md` | W-04 待确认 | W-04 关闭,§3 计数改眼镜 43、全量 205,§6 增一条决策记录 |
| `P16-待命屏改造.md` | 含「切换到{场景名}」指令与 F-P16-08 | 指令与功能点删除,计 7 |
| `P19-主页.md` | F-P19-11 处理切场景请求 | 改为只处理连接态、电量、固件的推送刷新;删状态行、数据契约字段、说明段与 M-11 引用 |
功能点数只减 1:眼镜 44 改 43,手机 90 与平台 72 不动,全量 205。手机 P19 之所以不减,是推送通道本身还要留着刷连接态与电量,被删掉的只是请求分支。
`06`、`07`、`05` 三处措辞不动,它们说的是切换由手机确认,与本次裁决一致。
画布侧还有两处要跟:`prototype/v1.3` 的 Ardot 画布里 P16 帧的指令表和 P19 帧的请求横幅仍旧画着,已记进 `00-PROGRESS` W-04 行,等 HTML 原型出来时以 HTML 为准。