docs: 发布 v1.3 PRD 全文(00-09,2026-11-04 收口版)
This commit is contained in:
commit
7559a9aa61
11 files changed
+1805
No files matched your search
+108
@@ -0,0 +1,108 @@
|
||||
# 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 为准。
|
||||
Reference in new issue
Block a user