commit 7559a9aa614358e48b7d20f30110cc4f473c30b4 Author: wudh Date: Wed Nov 4 13:49:03 2026 +0800 docs: 发布 v1.3 PRD 全文(00-09,2026-11-04 收口版) diff --git a/00-plan.md b/00-plan.md new file mode 100644 index 0000000..4ea4837 --- /dev/null +++ b/00-plan.md @@ -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 为准。 diff --git a/01-product-definition.md b/01-product-definition.md new file mode 100644 index 0000000..fefbce3 --- /dev/null +++ b/01-product-definition.md @@ -0,0 +1,175 @@ +# 01 产品定义与目标 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-03 | +| 依据 | `shaping/v1.3-多场景模块化/06-shaped-brief.md` 确认版、`07-product-spec.md` | +| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` | +| 状态 | G2 交付,待评审 | + +## 1 产品是什么 + +面向生态环境多场景现场检查的作业辅助系统。眼镜负责逐项引导、判定、录入与提交,手机负责数据中转、兜底提交、改错与复核,平台负责场景口径、模板、授权、统计与留档。 + +对外一句话:走到现场、说一句话、选对对象,该查的项自动出来,查完当场出结论并留档。 + +三端职责与不承担的部分: + +| 端 | 形态 | 承担 | 不承担 | +| --- | --- | --- | --- | +| 眼镜 | 现有厂商设备,不改硬件 | 主交互:识别对象、显示清单与进度、逐项语音引导、判定、语音录入、语音确认提交 | 多级菜单、表单、数字键盘、自由文本长输入、场景选择与切换(含请求) | +| 手机 | 新建 Android APK | 链路中转(眼镜不直连互联网,现场必经手机)、兜底提交、改错、待复核清单、证据查看、弱网暂存 | 主操作路径、平台派单接收、历史记录查询 | +| 平台 | 自建 Web,一期跑开发本机 | 场景启停、模板冻结与版本、四维授权、任务留档、分模块统计、问答工作台 | 发起检查、派单、规则在线编辑、仪表盘 | +| AI | 外部大模型加法规语料 | 固定指令解析、语音意图、法规问答(带条款号与兜底) | 自由生成执法结论、黑烟判别、等级判定 | + +两处边界要说清。系统的对手是「纸质表加执法记录仪」这套跑了多年的组合,不是别的 AI 产品;系统的位置是补「非现场监管」管不到的一段,不替换客户既有的在线监控、用电监控与双随机系统。 + +## 2 定名 + +四层名称分开定,各用各的场合。 + +| 层 | 定名 | 用在哪 | 谁看 | +| --- | --- | --- | --- | +| 产品名 | 生态环境现场检查智能辅助系统 | 汇报、演示、宣传、界面标题 | 客户业务口、领导 | +| 立项与合同名 | 生态环境行政检查智能辅助系统建设项目(前加地名与局名) | 立项、招标、合同、验收 | 财政、信息化、审计 | +| 简称 | 现场检查助手 | 口头传播、内部沟通 | 一线与项目组 | +| 一期标段名 | 一期(路检路查场景) | 本期交付范围 | 项目组与客户对口人 | + +旧名「路检路查智能执法辅助系统」停用,它只是六个场景之一,用作产品名会把范围讲小。禁用词:「移动执法」在生态环境系统已有移动执法终端、移动执法箱等既有品类;「多场景」「模块化」是内部口径;「智能眼镜」把产品绑在载体上,而平台与手机才是主页面。 + +## 3 要解决的四个缺口 + +| 缺口 | 现状表现 | 本产品的解 | 不解决 | +| --- | --- | --- | --- | +| 换一类检查对象就要重写一遍 | 清单、页面、提交校验、统计各写一套 | 口径、模板、权限、统计四处先立起来,换对象只改这四处 | 客户自助配场景,一期仍需实施导入模板 | +| 该查哪些项靠个人经验 | 同一类对象换个人换一套查法,漏项当场无人提醒 | 按检查对象自动出清单,依据带条款号 | 替人判断该不该查,检查项仍由客户确认 | +| 识别对象靠手抄 | 车牌、机械登记码、信用代码抄一遍再录一遍 | 识别即带入,取不到时人工录入并标来源 | 无牌车:按基线口径提示不走本流程(`shaping/05-open-questions.md` Q14) | +| 过程没有结构化留痕 | 谁在什么时候改了什么值、依据哪一条,事后说不清;送出去的样没有回执 | 每次改动记人、时间、前后值、原因;送检记录独立成对象,回填即结案 | 对外部门的移送对接,一期只做状态标记 | + +## 4 做什么、不做什么 + +一期做: + +- 眼镜五屏加一组覆盖层。待命、清单、单项引导、录入、提交结果,加聆听与执行状态的覆盖层与横幅。 +- 手机九页。启动页、登录、主页、核对检查对象、任务、填报与采集、待复核清单、提交与回执、智能问答。 +- 平台八页。登录、场景管理、任务列表、任务详情、场景与模板、账号与授权、法规问答、操作日志。 +- 权限五角色、十一动作、授权两层、范围三级。 +- 统计六个基础量加两个派生量,落任务列表汇总带。 + +一期不做,每条给理由: + +| 不做 | 理由 | +| --- | --- | +| 自动作出违法认定、生成处罚文书 | 判断权在执法人员,系统不做结论主体 | +| 黑烟判别、等级判定、计量认证 | 属检测能力,不在作业电子化的范围 | +| iOS 与鸿蒙客户端 | 客户配发设备为 Android | +| 重建客户既有监管平台与双随机系统 | 只做必要对接,不替换既有系统 | +| 敏感执法数据上公有云 | 单局独立部署是硬约束 | +| 眼镜上做业务界面与多级菜单 | 六选一在眼镜上做不成,多轮语音比掏一次手机慢 | +| 把六类检查的结构合并成一张统计表 | 四种判定结构的口径不同,合并后数字无法对账 | +| 覆盖率、排名、同比环比、个人绩效统计 | 覆盖率没有应查名单作分母;排名会诱导刷量;无历史基线;绩效数据可用于复核但不能直接当考核 | + +## 5 六个场景与四种判定结构 + +六个场景的九项口径已在定型中固定,此处只列 PRD 需要的六列。 + +| moduleId | 场景 | objectType | 业务识别键 | 判定结构 | 一期深度 | +| --- | --- | --- | --- | --- | --- | +| M01 | 路检路查 | VEHICLE | 车牌加日期 | TRISTATE | 详填,实装 | +| M02 | 非道路机械 | MACHINE | 机械环保登记号码 | TRISTATE | 骨架,占位 | +| M03 | 排放检验机构 | ORG | 机构名加资质编号 | TRISTATE + SAMPLING | 骨架,占位 | +| M04 | 堆场扬尘 | YARD、TERMINAL | 统一社会信用代码加点位编号 | REGIONAL | 骨架,占位 | +| M05 | 固废倾倒 | SPOT、VEHICLE | 坐标或车牌(可并存) | INCIDENT | 骨架,占位 | +| M06 | 工业废水 | ENTERPRISE | 统一社会信用代码加排口编号 | TRISTATE | 骨架,占位 | + +四种判定结构覆盖六个场景,页面与流程按结构分叉,不按场景分叉: + +| 结构 | 状态集 | 结论产出 | 覆盖 | 页面形态 | +| --- | --- | --- | --- | --- | +| TRISTATE | 未查、已查、不适用 | 问题清单 | M01、M02、M03 主体、M06 | 单对象一页清单 | +| SAMPLING | 待采样、已采样、核验合格、核验不合格 | 问题清单加抽检结论 | M03 报告抽查 | 清单加送检挂起 | +| REGIONAL | 点位待查、点位完成,点位内嵌三态 | 问题清单加点位清单 | M04 | 对象加点位列表 | +| INCIDENT | 已开立、已取证、已移送、已关闭 | 违法线索 | M05 | 事件页加时间线与移送 | + +产品层面的结论:手机端任务页共四种布局,不是六种。新增第七个场景时,落在已有结构内就复用现有布局,落在结构外才需要新增布局。这一条以 M02 接入实测为准,判定方式见 §7。 + +场景名不进页面名、接口路径、字段名、方法名、事件名。分支判断只用四个字段:moduleId、objectType、判定结构、标志位。 + +## 6 一期交付范围 + +交付深度与交付范围是两件事。文档只详填 M01 是深度,六场景框架全建是范围,两者不能互相推导。 + +| moduleId | 口径 | 文档深度 | 一期交付 | 缺什么才能上 | +| --- | --- | --- | --- | --- | +| M01 | 已定 | 详填 | 实装功能 | 检查项草案经客户确认 | +| M02 | 已定 | 骨架 | 只做壳,占位 | 检查项与限值依据 | +| M03 | 已定 | 骨架 | 只做壳,占位 | 送检时限与回填数据来源 | +| M04 | 已定 | 骨架 | 只做壳,占位 | 点位编号与去重规则 | +| M05 | 已定 | 骨架 | 只做壳,占位 | 一单多锚点优先级与移送对象 | +| M06 | 已定 | 骨架 | 只做壳,占位 | 场景边界是否含污水厂与 M 站 | + +壳的定义:六个场景在平台侧建模块、定口径、可授权、可启用;手机主页按「已授权 + 已启用 + 有冻结模板」三个条件出卡。M02 至 M06 无冻结模板,落占位卡,标「尚未开放」,可进说明页、不可起单。占位态只有一份,不按 moduleId 写分支。 + +范围纪律三条: + +1. 一期只承诺结构可扩展,不承诺客户自助配场景。 +2. M01 的检查项依据必须先过客户确认,否则 M01 也不能算交付完成。 +3. 送检回填责任人已定,时限未由客户给定之前,M03 不实装,壳不受影响。 + +## 7 成功指标 + +模块化三条指标是「换一类对象不改代码」这个主张能否成立的证据,不达标则这句话只是文档里的说法。 + +| 指标 | 定义 | 目标 | 判定方式 | +| --- | --- | --- | --- | +| 骨架接入零代码 | 用 M02 走完接入,三端业务代码改动行数。统计范围不含契约文件、数据库迁移脚本、模板数据、AI 词表 | 0 行 | `git diff --stat`,按上述范围取数 | +| 骨架纸面完备 | 只看契约文档重填 M03 全部检查项,条数以客户给的模板为准 | 全部填得出且不新增字段 | 双人独立填写后比对 | +| 分模块统计对账 | 构造 20 条记录跑统计 | 六个量与手工期望逐格相等 | 工具加人工 | + +M01 的业务指标沿用基线: + +| 指标 | 目标 | 判定方式 | +| --- | --- | --- | +| 必检项零遗漏 | 抽查 20 单,缺项 0 | 平台明细比对 | +| 一条记录一次检查 | 无同日重复在办单 | 唯一索引与留痕 | +| 挂起结案分离 | 有项等送检的单据计入结案数为 0 | 统计 SQL,构造数据验证,不依赖 M03 实装 | +| 结构名隔离 | 报告、文书、页面文案出现内部结构名 0 次 | grep | +| 录入来源可追 | 抽查 20 条语音录入值,来源标记齐全且进过待复核清单 | 平台明细 | + +一条观测项不作验收判据:眼镜语音提交成功率,即不看屏幕完成提交的单数占比。目标值待现场实测后填,`[未取]`。 + +## 8 约束与假设 + +硬约束: + +| 约束 | 内容 | +| --- | --- | +| 链路 | 眼镜不直连互联网,现场恒为「眼镜 → 手机 → 平台」 | +| 部署 | 单局独立部署,敏感执法数据不上公有云 | +| 认定 | 系统不作出违法认定,不为处罚文书提供结论 | +| 依据 | 统一引法典条号,法典 2026-08-15 施行,旧法条款不得出现 | +| 判定词 | 检查项用「符合/不符合/不适用」,送检用「核验合格/核验不合格」并带出具机构 | +| 载体 | 眼镜不改硬件,能力上限由厂商通道决定 | + +假设,标注证据级别: + +| # | 假设 | 级别 | 不成立时的影响 | +| --- | --- | --- | --- | +| A1 | 厂商支持回显与逐项引导,实测分辨率与刷新率达 1280×720 | 推断,口头确认,书面未取(V13-Q43) | 眼镜六屏需重排,L0 与 L1 两档升为验收项 | +| A2 | 马路噪声下语音识别率可承载数值项录入 | 未提供(V13-Q27) | 数值项全部退回手机录入,待复核清单失去一半价值 | +| A3 | 一线接受戴眼镜作业而不退回手机 | 未提供 | 主交互端判断失效,产品退回手机主导 | +| A4 | 客户认同编码化留痕可替代签字盖章 | 未提供 | 记录的合法性依据需另立 | + +## 9 未决事项 + +七项未闭合,都在数据输入与实机能力层面,不改变产品形态与页面结构,逐项处理约定见 `09-global-and-acceptance.md`。 + +| 编号 | 内容 | 阻塞什么 | +| --- | --- | --- | +| V13-Q13 | M01 检查项草案与限值 | M01 模板导入 | +| V13-Q05 | 送检时限 | M03 实装 | +| V13-Q44 | 素材与检索日志保存期限 | 数据保留口径 | +| V13-Q25 / Q43 | 实机分辨率、单色或彩色、刷新率、书面确认 | 眼镜屏画布与验收依据 | +| V13-Q28 | 主页眼镜信息字段集合 | 主页字段 | +| V13-Q45 | 车辆档案正式数据源 | 核对检查对象页字段范围 | +| V13-Q11 | M02 至 M06 现状作业方式与痛点 | 其余场景的清单与话术 | diff --git a/02-users-and-needs.md b/02-users-and-needs.md new file mode 100644 index 0000000..98536fa --- /dev/null +++ b/02-users-and-needs.md @@ -0,0 +1,178 @@ +# 02 用户与需求分析 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-03 | +| 依据 | `shaping/v1.3-多场景模块化/01-product-shaping.md` 用户与权限节、`02-jtbd.md` | +| 状态 | G2 交付,待评审 | + +## 1 用户分八类 + +| 用户 | 特征 | 核心诉求 | 决策权与影响 | 证据级别 | +| --- | --- | --- | --- | --- | +| 主用户:执法员 | 现场作业,一次任务查一个对象,一天可能跨 2 至 3 类检查;戴手套、身后有车流、手上还有设备 | 少填、别漏、当场出结论、回办公室不补录 | 决定用不用,现场唯一作业者 | 已确认 | +| 主用户延伸:中队负责人 | 带班、派活、复核本队单据 | 进度可见、异常可追 | 影响使用深度 | 推断 | +| 决策者:执法局业务负责人 | 关注规范性与可追溯,数据不出内网 | 过程留痕、结论可复核、能对上级出数 | 决定试点与采购 | 已确认 | +| 影响者:科室管理员 | 维护场景模板与检查项,处理送检回填 | 改模板不改历史单据 | 能否决模板口径 | 推断 | +| 影响者:平台管理员 | 账号、角色、授权、场景启停、留痕审计 | 独立部署、权限清晰、日志可审计 | 可否决部署方式 | 已确认 | +| 协同方:公安交管 | 拦停与核验车辆,不操作本产品 | 现场节奏快 | 影响 M01 的节奏 | 已确认 | +| 影响者:眼镜厂商 | 提供设备、光机与 SDK | 协议边界清晰 | 通道能力决定眼镜侧上限 | 已确认 | +| 被影响者:被检查对象 | 司机、企业负责人、工地负责人 | 过程快、结论可解释 | 无决策权,现场质疑会打断作业 | 已确认 | + +被检查对象是否需现场签字,定型已关闭该问题:场景模块的业务层面暂不考虑。系统内的凭证是编码化留痕,不是签字。 + +## 2 岗位与端的对应 + +五个角色对应三端的进入权,这是需求的第一层切分,不按页面切。 + +| 角色 | 面向 | 手机端 | 平台端默认能力 | +| --- | --- | --- | --- | +| 执法员 | 现场作业 | 可用 | 只看自己的记录 | +| 中队负责人 | 带班、复核本队 | 可用 | 本组织记录查看与导出 | +| 科室管理员 | 模板、送检、统计 | 不可用 | 模板查看与冻结、送检回填、本组织统计 | +| 平台管理员 | 账号、授权、场景启停 | 不可用 | 全部,含授权与启停 | +| 只读 | 法制复核、上级查看 | 不可用 | 查看导出,本局全部 | + +手机端只放行前两个角色。基线的「系统管理员」在新模型里拆成平台管理员,且不上手机,避免现场用一个能改授权的高权账号作业。 + +同一个人可以挂多个角色,中队长通常兼执法员。权限取所挂角色模板的并集,再叠加个人加授与撤授;同一场景下多个角色给出不同范围时取最宽一级;个人撤授优先于并集。 + +## 3 一次作业里谁做什么 + +现场不是一个人的活,四类角色在同一条链上各管一段。 + +| 环节 | 谁做 | 在哪 | 不做的后果 | +| --- | --- | --- | --- | +| 场景启用与授权 | 平台管理员 | 平台 P21、P09 | 手机没卡可点,现场开不了工 | +| 模板冻结 | 科室管理员 | 平台 P10 | 场景可启用但起单被拒,提示联系管理员 | +| 现场检查、判定、提交 | 执法员 | 眼镜为主,手机兜底 | — | +| 待复核确认 | 执法员本人 | 手机 P20 | 机器与语音给的值无人核对,证据链有洞 | +| 送检回填 | 科室管理员(或经个人加授获得送检回填权限的人员) | 平台 P12(需送检回填权限) | 单据永久停在待结论,统计只增不减 | +| 复核与导出 | 中队负责人、只读 | 平台 P11、P12 | 结论无人追,问题项无从核对 | + +这条链的断点都在现场之外:没人启用、没冻模板、没人回填。三处都在界面上给了明确提示,不让人在车边猜为什么起不了单。 + +## 4 现状替代方案与缺口 + +| 替代方案 | 覆盖了什么 | 缺什么 | 切换阻力 | +| --- | --- | --- | --- | +| 纸质检查表加班后录入 | 检查项齐全、可签字 | 手抄、二次录入、无实时进度 | 低,但没人愿意抄两遍 | +| 智能执法记录仪加手机 PDA | 录像留证、部分清单、拍照 | 需腾手、规则不按对象联动 | 中,不想再加一台 | +| 双随机抽查系统(PC 端) | 任务下达、抽查留痕 | 现场无清单、结果回办公室录 | 高,现场作业与它无关 | +| 微信群电话报数 | 快 | 无结构、无留痕 | 无 | + +切换阻力要逐条承认,不能靠话术消解: + +1. 要戴眼镜,一天戴多久未验证。 +2. 要装 APK,现场设备管理多一道。 +3. 平台要在位,模板要先配好,否则起不了单。 +4. 现场要重新学一套语音话术。 +5. 一线已习惯纸质表加记录仪,签字盖章有章可循。 +6. 语音录入出错的责任归属需要事先讲清。 + +## 5 JTBD + +只写到上位 Job 加三种驱动点。六个场景各自的痛点材料未提供(V13-Q11),不做补写。 + +上位 Job 一个:把一次现场检查从「凭经验、靠纸笔」变成「有清单、有值、有证据、有留档」。 + +M01 的 Job Story(基线已确认,不改): + +> 当我戴着手套、手里拿着设备走到被拦停的货车旁边时,我想不用腾出手、不用背清单就知道这台车该查哪几项、每项该填什么,从而当场查完当场交,班后不用再对着纸片补录。 + +v1.3 把这句话里的「设备」从手机换成眼镜。执法人员不再在车边掏手机点清单打字,而是听眼镜逐项报、说一句结论、说错再改;手机在口袋里当中转,掏出来只剩三个时机:改错、看证据、复核。 + +这处位移把赢点从「不漏项」扩到「不打断」。纸质表要的是不漏项,记录仪加口头交接要的是不打断。眼镜主导的价值不是少填几个字,是检查过程中手不离活。 + +三种驱动点(M01 与 M02 为拦停型是已确认口径,其余为推断): + +| 驱动点 | 覆盖 | Job Story | +| --- | --- | --- | +| 拦停型 | M01、M02 | 当我站在路边、后面还排着车的时候,我想在三十秒内确定这对象归哪一类检查、该查哪几项,从而不被清单本身拖住 | +| 场所型 | M03、M04、M06 | 当我走进企业或堆场、手上只有一台手机、对方还在等我说明来意时,我想让系统先把这一次要查哪些点摆出来,从而按点位走完不乱、不漏、出门前能交出问题清单 | +| 事件型 | M05 | 当我接到举报或巡查发现一堆不明固废时,我想先把这是什么、在哪、多少、谁的可能固定成一条可追的线索,从而不必等查清全部再录 | + +## 6 四力与新增顾虑 + +四力(M01 已确认,其余场景未提供): + +| 维度 | 内容 | +| --- | --- | +| Push 当前痛点 | 车型与规则靠个人经验记;车牌手抄二次录入;漏项当场无人提醒 | +| Pull 新方案吸引力 | 说一句话起单,规则自动出,已查未查分明,提交即留档 | +| Anxiety 顾虑 | 车牌认错怎么办;眼镜戴一天撑不撑住;当事人质疑设备依据;数据存哪里;断网能不能继续 | +| Habit 惯性 | 纸质表签字盖章有章可循;记录仪录像已成习惯;口头交接比系统快 | + +v1.3 新增的四条顾虑,均属推断,需现场验证,但每一条都直接决定了设计点: + +| # | 顾虑 | 设计落点 | +| --- | --- | --- | +| 1 | 场景选错怎么办,选错能不能改 | 主页按判定结构分族出卡降低选错率;选错只能在手机主页重选,眼镜无切换入口;起单后选错对象可说「重新核对」作废重建,不给原地改识别键的口子 | +| 2 | 一次任务挂多点位多车,会不会填乱 | 区域型用子记录承载点位,编号与描述分开存 | +| 3 | 送检结论要等,单子挂在那里算不算我交差了 | 待结论单列,不计入结案;任务列表状态列标「待结论」,详情页显示超期天数 | +| 4 | 嘴上说的数值被识别错了,责任算谁的 | 录入来源标记、待复核清单、提交前复述识别键 | + +第 4 条是四条里最硬的。戴着手套、耳边有车流,说一句「一点二」被听成「七点二」,这个值进了执法记录,事后没人能证明它是错的。不给来源标记与复核动作,语音录入就是给证据链埋雷。 + +四力里最硬的一条不变:现场最怕的不是效率低,是记录被质疑。v1.3 的压力更大,因为新增场景的结论要送出去,一条无依据的问题项会被退回来。 + +## 7 需求清单 + +优先级定义:P0 为一期必须成立且进验收;P1 为一期实现但不作验收判据。 + +| 编号 | 需求 | 来源 | 级别 | 落点 | +| --- | --- | --- | --- | --- | +| R01 | 按检查对象自动出该查的项,清单来自已冻结模板,不硬编码 | 定型 | P0 | 05 P03、06 P10 | +| R02 | 眼镜逐项引导:项名、依据条款号、当前结论三选 | 定型 | P0 | 04 P22 | +| R03 | 检查项结论只认规范词「符合/不符合/不适用」;识别层兼容旧说法的映射在配置里,不进界面文案 | SPEC §4 | P0 | 04 P22、P17 | +| R04 | 识别不出时口述数值,值带语音来源标记 | 定型 | P0 | 04 P23 | +| R05 | 语音确认提交,校验在服务端跑,不过则播报差哪几项 | 定型 | P0 | 04 P24、05 P06 | +| R06 | 手机兜底提交,两路先进为准,后到一路提示本单已提交 | 定型 | P0 | 05 P06 | +| R07 | 待复核清单只收识别、语音、转抄三类,手输不进 | 定型 | P0 | 05 P20 | +| R08 | 不适用必须说原因,原因为空的提交一律被拒 | 定型 | P0 | 04 P22、05 P04、05 P06 | +| R09 | 主页场景卡三态由已授权、已启用、有冻结模板三个条件驱动 | 定型 | P0 | 05 P19 | +| R10 | 场景启停:启用不校验模板,停用要求在办单为 0 | 定型 | P0 | 06 P21 | +| R11 | 模板版本与冻结:起单锁定版本,校验与渲染按锁定版本 | 定型 | P0 | 06 P10、05 P03 | +| R12 | 识别键按模块定义,列表列头取模板里的识别键标签 | 定型 | P0 | 05 P02、06 P11 | +| R13 | 任务页四种布局按判定结构分叉,不按场景写分支 | SPEC §3 | P0 | 05 P03 | +| R14 | 送检挂起与回填:回填人不是现场执法员,回填即结案 | 定型 | P1 | 06 P12 | +| R15 | 五角色、十一动作、两层授权、三级范围,一人可挂多角色 | 定型 | P0 | 07 P09 | +| R16 | 手机端准入拦截:只有执法员与中队负责人可登录 | 定型 | P0 | 07、05 P01 | +| R17 | 断连可继续判定,禁止提交;判定入队、重连补传、屏上标未同步 | 定型 | P0 | 04 P17、P18 | +| R18 | 素材按检查项挂,眼镜采后即交手机,手机为第一副本,允许先交单后补料 | 定型 | P0 | 05 P04、06 P12 | +| R19 | 法规问答必须带条款号与原文摘录,带不出走固定兜底 | 定型 | P0 | 08 P05、P14 | +| R20 | 留痕只追加,每次改动记人、时间、前后值、原因 | 定型 | P0 | 06 P12、P13 | +| R21 | 冷启动遮蔽等待,超 5 秒给重试与先进入 | 定型 | P1 | 05 P25 | +| R22 | 在办单续做:主页列表按最近操作倒序,最多三条加更多 | 定型 | P1 | 05 P19、P03 | +| R23 | 操作日志可按时间、人、动作、场景筛选 | 基线 | P1 | 06 P13 | +| R24 | 场景选择与切换的唯一入口是手机主页卡片;眼镜只播报当前场景,起单复用该人上次完成的场景,不发起切换请求 | 定型 `00i` §2 第 3 条 | P0 | 05 P19、04 P16 | + +## 8 边缘用户与边缘情境 + +| 情境 | 谁受影响 | 需求含义 | +| --- | --- | --- | +| 无牌车 | 执法员 | 识别键取不到,按既有口径提示不走本流程,不阻断其他检查 | +| 复合识别键缺段 | M04、M05、M06 的作业者 | 允许缺段起单,缺的段在手机补齐,补齐前不进提交 | +| 眼镜断连 | 执法员 | 可继续判定,不可提交;屏上标未同步 | +| 队列丢失(眼镜重启) | 执法员 | 不给补救入口,提交时由服务端列缺项,逐项补查 | +| 换班与交接 | 执法员、中队负责人 | 在办单归属原起单人,接续操作记入留痕 | +| 手机没电 | 执法员 | 眼镜可继续判定,但无法提交;提交必须恢复链路 | +| 模板改版时有人在办 | 科室管理员、执法员 | 在办单按锁定版本校验与渲染,改版提示影响面 | +| 两路同时提交 | 执法员 | 先进为准,后到一路提示并跳回执,不产生第二条记录 | +| 场景被停用时有在办单 | 平台管理员、执法员 | 停用被拒并提示在办单数;已在办的单进任务页时顶部出停用提示 | +| 语音误识数值 | 执法员 | 值带语音来源,进待复核清单,可改并留痕 | + +## 9 需求取舍 + +一期明确不做的需求,以及不做之后的替代路径: + +| 需求 | 不做的理由 | 替代路径 | +| --- | --- | --- | +| 平台派单与手机待办栏 | 任务一律现场起;M01 属随机拦停,没有名单可派 | 双随机名单继续走线下 | +| 覆盖率与应查未查统计 | 先有派单与名单才有分母 | 只看任务数与问题项数 | +| 手机端历史查询(列表式) | 定型暂缓表口径:基线不做。触发条件是现场出现「当场调上次记录」的真实需求 | 回办公室用平台查;P02 只显示同对象同日已有记录 | +| 眼镜发起切场景请求 | 一期不做。眼镜上唯一能做的是播报当前场景与复用上次场景;一个点了没反应的请求横幅会被现场当成故障,且它要求在眼镜侧维护「请求中、被忽略、被拒绝」三个状态,没有验收资源 | 场景切换走手机主页卡片;等厂商词表能力书面确认后,连请求带本地切换一起进二期 | +| 完整离线作业 | 只做提交队列,不做本地全量副本 | 断连可判定,提交等恢复链路 | +| 电子签名签章 | 客户未提出,场景是否要签未定 | 编码化留痕加复核清单 | +| 客户自助配场景 | 一期只承诺结构可扩展 | 实施导入模板 | +| 个人绩效统计 | 数据可用于复核,不能直接当考核 | 结案数与待办积压只到组织级 | diff --git a/03-user-stories-and-journey.md b/03-user-stories-and-journey.md new file mode 100644 index 0000000..44c8c41 --- /dev/null +++ b/03-user-stories-and-journey.md @@ -0,0 +1,189 @@ +# 03 用户故事与旅程 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-03 | +| 依据 | `shaping/v1.3-多场景模块化/04-pages-and-flows.md`、`prototype/v1.3-多场景模块化/03-flows.md` | +| 状态 | G2 交付,待评审 | + +## 1 主旅程 + +一次现场检查从起单到留档,主线在眼镜与语音里走完,手机是五个介入点,平台在事后接手。 + +```mermaid +flowchart TD + A1[手机主页点场景卡] --> B + A2[眼镜说开始检查·用上次场景] --> B + B[核对检查对象:手机界面确认或眼镜语音确认] --> C[按冻结模板返清单] + B -->|识别失败| B2[手机手输或扫码] + B2 --> B + C --> D[眼镜清单屏:当前项] + D -->|说项名或下一项| E[单项引导:说结论] + D -->|手机介入| F[手机填报与采集] + E -->|不符合要数值| G[眼镜录入屏说数值] + E -->|结论已定| H[下一项] + G --> H + F --> H + H --> I{全部项有结论} + I -->|否| D + I -->|是| J[语音提交或手机提交] + J --> K[服务端校验] + K -->|不过| L[差哪几项] + L --> D + K -->|过| M[落库留痕] + M --> N[手机待复核清单] + N --> O[逐条确认或改值] + M --> P[平台任务列表与详情] + P --> Q[送检回填] +``` + +两个起单入口在核对检查对象处汇合。手机起单走界面确认;眼镜起单走语音确认,手机不点亮,只有识别失败或复合键缺段才拉起手机。起单之后仍可反悔:在清单屏说「重新核对」,本单作废并留痕,回到核对检查对象环节重新识别。不给原地改识别键的口子,改键等于换对象,作废重建比改字段干净。 + +## 2 手机介入的五个时点 + +| 时点 | 为什么必须手机 | 眼镜为什么做不了 | +| --- | --- | --- | +| 选场景 | 六选一 | 多轮语音比掏一次手机慢,厂商词表能力未书面确认 | +| 核对检查对象失败 | 键盘逐字录入、扫码、坐标手标 | 眼镜无键盘,长文本不可用 | +| 要改值 | 改已判定的值、补不适用原因、补证据 | 眼镜只承载数值口述,不承载表单 | +| 要看证据 | 回放截帧与短片、看素材状态 | 眼镜分辨率与带宽都不够 | +| 要复核 | 逐条核对识别与语音来源的值 | 清单长度与阅读负担不适合抬头显示 | + +不介入时整条流在眼镜与语音里走完。这五个点是设计上的上限,不是建议。 + +## 3 场景从授权到出卡 + +场景在手机上能不能看见、能不能起单,由三个条件串起来决定,不由角色写死。 + +```mermaid +stateDiagram-v2 + [*] --> 未授权 + 未授权 --> 已授权未启用: 平台配授权 + 已授权未启用 --> 已启用无模板: 平台启用场景 + 已启用无模板 --> 已启用有模板: 冻结模板新版本 + 已启用有模板 --> 已启用无模板: 版本归档且无在办单 + 已启用有模板 --> 已授权未启用: 停用(需在办单为 0) + 已启用无模板 --> 已授权未启用: 停用(需在办单为 0) + 已授权未启用 --> 未授权: 撤授权 +``` + +| 状态 | 手机主页 | 能否进核对检查对象 | 能否起单 | +| --- | --- | --- | --- | +| 未授权 | 不渲染 | 否 | 否 | +| 已授权未启用 | 不渲染 | 否 | 否 | +| 已启用无模板 | 占位行「尚未开放」 | 进说明层 | 否,起单被拒并提示联系管理员 | +| 已启用有模板 | 可作业卡 | 是 | 是 | + +停用只要还有在办单就被拒,与「启用不校验模板」是一对:进得松、出得紧。 + +## 4 四种结构如何分叉旅程 + +| 结构 | 核对检查对象后到哪 | 清单形态 | 结案条件 | 旅程上的差别 | +| --- | --- | --- | --- | --- | +| TRISTATE | 任务页单对象清单 | 一页项列表 | 全部项有结论且无待送检 | 主线,无额外分支 | +| SAMPLING | 任务页清单加送检区 | 项列表加送检项 | 送检结论回填 | 提交后可能停在待结论,结案由回填触发 | +| REGIONAL | 任务页对象加点位列表 | 点位下各项 | 全部点位完成 | 先走点位,点位内逐项,点位编号必填 | +| INCIDENT | 任务页事件页 | 时间线加线索项 | 取证完成或移送 | 允许边查边录,先固定线索不等查清 | + +页面布局与结构一一对应,不与场景对应。六个场景落在四种布局里,第七个场景进来先看它属于哪一种。 + +SAMPLING 这一支要在一期建出来,但不进现场验收。理由是 M03 是壳,没有任何真实送检单。布局、送检区块、待结论状态都要落,否则 M03 实装时要同时改页面、改状态机、改统计三处;验收只在开发环境用构造数据走。 + +## 5 用户故事 + +故事按交付板块分组,每条给验收条件。编号 `US-<板块>-<序号>`。 + +### 起单(板块 05) + +| 编号 | 故事 | 验收条件 | +| --- | --- | --- | +| US-05-01 | 作为执法员,我在主页点一个可作业场景卡,进入核对检查对象 | 卡片标题显示场景名;点击带 moduleId 进 P02;占位卡点击只弹说明层,层内无起单按钮 | +| US-05-02 | 作为执法员,对象识别成功时我只确认一次就进任务页 | 起单成功才跳转;同日同识别键已有在办单时不新建,跳既有单 | +| US-05-03 | 作为执法员,识别不出来时我手输识别键,值被标为手输 | 手输值不进待复核清单;留痕记原值与录入值 | +| US-05-04 | 作为执法员,我在眼镜上说「开始检查」,按上次完成的场景起单 | 有上次场景则播报场景名并识别对象;无上次场景或场景已停用则播报「请先在手机选择检查类型」,不猜场景 | +| US-05-05 | 作为执法员,场景没有冻结模板时我被拒绝起单且知道该找谁 | 提示「该场景尚未配置检查项,请联系管理员」,不生成任务 | + +### 判定与录入(板块 04) + +| 编号 | 故事 | 验收条件 | +| --- | --- | --- | +| US-04-01 | 作为执法员,我听眼镜报当前项、依据条款号和下两项,说一句结论就推进 | 结论被记录后清单屏该行形状变化(1 秒内为设计值,不作验收判据);不符合项追加「是否录入数值」 | +| US-04-02 | 作为执法员,我说不适用必须同时说原因 | 原因为空不落库;原因入库后该项状态为不适用,形状为斜纹 | +| US-04-03 | 作为执法员,识别不出时我口述数值,值进待复核清单 | 值带语音来源;屏上有「重说」入口;连续两次失败提示「请用手机录入」 | +| US-04-04 | 作为执法员,我说「重新核对」可以作废这次临时单 | 临时单作废并留痕记原因;已提交的单不允许该指令 | +| US-04-05 | 作为执法员,断连时我能继续判定,但提交被拒 | 判定入本地队列,屏上该行标未同步;按提交播报「请先连上手机」;重连后按序补传,角标逐条消失 | + +### 提交与复核(板块 05) + +| 编号 | 故事 | 验收条件 | +| --- | --- | --- | +| US-05-06 | 作为执法员,我在眼镜上说提交,服务端校验通过后拿到回执 | 提交前复述识别键;通过后回执号后六位显示 3 秒,随后回待命屏 | +| US-05-07 | 作为执法员,校验不过时我知道差哪几项 | 眼镜列最多三条,超出显示「还有 N 项」;手机 P06 显示完整校验清单;不生成回执 | +| US-05-08 | 作为执法员,我可以在手机再提交一次,不会产生第二条记录 | 后到一路提示「本单已提交」并跳回执页 | +| US-05-09 | 作为执法员,提交后我逐条核对机器与语音给的值 | 待复核清单只收识别、语音、转抄三类;逐条确认、可跳 P04 改值、可批量确认本单 | +| US-05-10 | 作为执法员,改过的值回到待复核 | 改值后状态回待复核并留痕记前后值 | + +### 平台口径(板块 06) + +| 编号 | 故事 | 验收条件 | +| --- | --- | --- | +| US-06-01 | 作为平台管理员,我启用或停用一个场景 | 启用不校验模板,但弹提示该场景当前无模板、启用后只能查看不能起单;停用有在办单时被拒并显示在办单数 | +| US-06-02 | 作为科室管理员,我冻结模板新版本,在办单不受影响 | 冻结后新起单用新版本;提示仍有 N 个在办单使用旧版本;旧版本不删除 | +| US-06-03 | 作为科室管理员,我在任务列表筛场景、看汇总带 | 汇总带跟随筛选实时刷新;六个量口径与 §7 一致;识别键列头取模板标签 | +| US-06-04 | 〔P1,不进一期现场验收〕作为科室管理员,我在任务详情回填送检结论 | 无送检回填权限不可见回填入口;回填后任务转已结案;核验不合格同时生成问题项 | +| US-06-05 | 作为中队负责人,我复核本队的操作留痕 | 留痕只追加、不可改删;每条记人、时间、前后值、原因 | + +### 授权(板块 07) + +| 编号 | 故事 | 验收条件 | +| --- | --- | --- | +| US-07-01 | 作为平台管理员,我给角色配场景 × 动作 × 范围 | 角色固定五个不可新增;范围三级;保存后即时生效 | +| US-07-02 | 作为平台管理员,我给某个人加授或撤授 | 实际权限 = 角色并集 ∪ 个人加授 − 个人撤授;撤授优先 | +| US-07-03 | 作为平台管理员,我不能撤掉自己的授权与用户管理 | 两项置灰并说明原因,防自锁 | +| US-07-04 | 作为科室管理员,我用平台管理员账号登手机被拦 | 提示「当前账号无现场作业权限」,不进入主页 | + +### 问答(板块 08) + +| 编号 | 故事 | 验收条件 | +| --- | --- | --- | +| US-08-01 | 作为执法员,我在现场问一句拿到带条款号的答案 | 答案含条款号与原文摘录;带不出条款号走固定兜底话术 | +| US-08-02 | 作为执法员,我在眼镜上问,只听到结论与条款号 | 原文只在手机呈现;问答不挂任务、不进明细、不进导出 | + +## 6 失败与恢复路径 + +| 失败 | 现场表现 | 系统行为 | 恢复 | +| --- | --- | --- | --- | +| 识别键取不到 | 眼镜播报识别失败 | 转手机手输或眼镜语音录入,值标人工录入 | 录入后继续,不阻断作业 | +| 复合键缺段 | 起单成功但提交被阻断 | 缺段列入校验清单 | 手机补齐后重新提交 | +| 同一对象同日有在办单 | 起了单但没新建 | 跳既有单并提示 | 继续原单 | +| 提交校验不过 | 眼镜列差项、手机出校验清单 | 不生成回执 | 逐项补查后重提 | +| 断连 | 屏上标未同步 | 判定入队,禁止提交 | 重连补传 | +| 队列丢失(眼镜重启) | 无具体项可定位 | 不给补救入口 | 提交时服务端列缺项,逐项补查 | +| 存在待送检项 | 任务停在待结论 | 不计入结案,单列统计 | 科室管理员回填后转已结案 | +| 模板中途改版 | 无感知 | 提交校验与详情按锁定版本 | 无需处理,设计上不打断 | +| 场景被停用 | 主页卡片消失 | 在办单仍在,任务页顶部出停用提示 | 由管理员恢复启用 | +| 两路同时提交 | 后到一路提示 | 不产生第二条记录 | 看回执即可 | + +## 7 时间与等待参数 + +| 位置 | 参数 | 含义 | 来源 | +| --- | --- | --- | --- | +| 启动页 | 动画上限 1.2 秒 | 就绪即走,不等播完 | 定型 | +| 启动页 | 5 秒 | 超时转兜底,给「重试」「先进入」 | 定型 | +| 登录态 | 8 小时 | 有效期,客户未表态可推翻 | 设计值 | +| 眼镜语音确认 | 1.5 秒静默窗 | 防抢话应声,超时才认定为用户发言 | SPEC §6 | +| 眼镜判定的屏面反馈 | 1 秒内 | 说完结论到形状变化 | 设计值 | +| 核对检查对象 | 语音确认超时 20 秒 | 超时拉起手机界面确认 | 设计值 | +| 提交结果屏 | 成功 3 秒、失败 8 秒 | 自动跳转时长,失败也可说「继续」 | 定型 | +| 眼镜刷新 | 2 秒 | 低于此值不做加载指示,眼镜不渲染加载态 | SPEC §4 | +| 主页 | 30 分钟 | 无操作不自动刷新,避免现场看到列表自己变 | 定型 | + +数值为设计值,客户未表态的项在字段旁标了来源,可用反馈推翻。 + +## 8 验收口径 + +故事分两档。全篇 26 条,其中 P0 二十五条进一期验收,P1 一条(US-06-04)实现但不验收。 + +送检不进一期验收。M03 一期是壳,送检回填(US-06-04)降为 P1,只验三件事:回填入口按送检回填权限显隐、回填后任务从待结论转已结案、核验不合格同时生成问题项。三项都用构造数据在开发环境验证,不计入现场试运行验收。待结论这个状态本身仍要建,因为它决定统计口径与任务详情页的三段结构,M03 实装时不改表也不改页面。 + +验收以故事为最小单元,每个故事至少一条可复现的判定动作。不可判定的表述(系统应友好提示、体验流畅)不进验收表。 diff --git a/04-glasses-field.md b/04-glasses-field.md new file mode 100644 index 0000000..3016f43 --- /dev/null +++ b/04-glasses-field.md @@ -0,0 +1,232 @@ +# 04 眼镜端 · 现场主交互 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-03 | +| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` §3、`02-pages/P16 P17 P22 P23 P24 P18`、`04-components.md` C-47 至 C-52 | +| 原型 | p16-standby、p17-list、p22-item、p23-input、p24-result、p18-overlay | +| 功能点 | 43(P16 7、P17 12、P22 5、P23 5、P24 5、P18 9) | +| 视口 | 1280×720,`gl-*` 令牌,形状加亮度编码 | +| 数据来源 | `reference/mock-data.md`,六屏全部示例值取自该文件 | +| 状态 | G4 交付,待评审 | + +## 1 端的定位 + +眼镜是现场主交互端。执法人员戴着它走完一次检查:看清单、听引导、说结论、说数值、说提交。手机在口袋里当中转,只在改错、看证据、复核三个时点掏出来。 + +四条边界决定了本板块的全部设计: + +1. 屏上元素一律不可点。没有按钮、没有列表选择、没有滚动条,交互只有语音。加一个可点元素,就意味着要设计焦点、要处理触控与语音的争用,而现场戴着手套点不中。 +2. 不渲染加载态。骨架、进度条、转圈一概不出。刷新在两秒内不可感知,任何加载指示只是噪声。 +3. 镜片按单色落稿(实机单色还是彩色未定,V13-Q25/Q43),淡绿底上红绿灰三色语义不可辨。三态只能靠形状与亮度区分,并配一行文字计数兜底。 +4. 场景不在这里选。眼镜只播报当前场景,起单复用该人上次完成的场景,切换场景的唯一入口是手机主页。眼镜发起的切换请求已在 2026-11-03 删除。 + +## 2 六屏一览 + +| 屏 | 一句话 | 入口 | 出口 | 功能点 | +| --- | --- | --- | --- | --- | +| P16 待命屏 | 现在归哪一类检查、怎么开始 | 开机;提交成功后回落 | P17 清单屏 | 7 | +| P17 清单屏 | 这一类该查什么、查到哪了,并且在这里把它查完 | P16 起单成功;P22、P23 返回;P24 失败回落 | P22、P24、P16 | 12 | +| P22 单项引导屏 | 这一项查什么、判什么 | P17 说项名或说下一项 | P17;P23(不符合后说录入) | 5 | +| P23 录入屏 | 识别不出时,把值说出来 | P22 不符合后说录入 | P17 | 5 | +| P24 提交结果屏 | 交成没交成、差哪几项 | P17 说提交,服务端校验返回 | P16(成功);P17(失败或断连) | 5 | +| P18 覆盖层与横幅 | 正在听、听懂了什么、判定记没记住、还有什么没核对 | 任意屏之上 | 自动回落,无手动关闭 | 9 | + +主线在 P17 完成:说结论即推进,P22 是「停下来看清一项」的放大镜,P23 只在不符合且有数值时出现,P24 是提交后的唯一反馈面。 + +## 3 语音词表 + +词表是眼镜端的接口定义。同义词双收,落库与播报一律用规范词,留痕存原始话语。 + +| 说法 | 生效在 | 行为 | 屏面反馈 | +| --- | --- | --- | --- | +| 小新小新 | 任意屏 | 唤醒 | C-29 聆听横幅 | +| 开始检查 | P16 | 按该人上次完成的场景起单 | 播报「{场景名},正在识别」 | +| 符合 | P17、P22 | 当前项置「符合」,进下一未查项 | C-51,播报「已记符合」 | +| 不符合 | P17、P22 | 当前项置「不符合」;有数值要求时追问 | C-51,播报「已记不符合」 | +| 不适用 | P17、P22 | 追问原因,收到原因才落库 | C-51 | +| 录入 | P22(仅不符合后) | 进 P23 | 屏面切 P23 | +| 重说 | P23 | 清空回显,重新聆听 | 回显清空 | +| 确认 | P23 | 落库,来源 voice | 200ms 后回 P17 | +| 跳过/下一个 | P17、P22 | 当前项状态不变,跳到下一项 | 大字换项 | +| 上一项 | P17、P22 | 回上一个未查项 | 大字换项 | +| 第 N 项 | P17、P22 | 跳到该项 | 大字换项 | +| 重新核对 | P17 | 本单作废,回到核对检查对象环节重新识别,留痕记作废原因 | 播报「已作废,请核对检查对象」 | +| 提交 | P17 | 先复述对象求确认,确认后校验提交 | 进 P24 | +| 继续 | P24 | 立即回 P17 首个差异项 | 屏面切 P17 | +| 还有几项 | P17 | 播报剩余数 | 无变化 | +| 关闭显示/打开显示 | 任意屏 | 熄屏与亮屏,语音照常 | 全黑或恢复 | + +三条词表纪律: + +1. 跳过与不适用必须分开。跳过是不查就过、状态不变;不适用是查过判定不适用、要原因。合成一个说法,NA 无原因数必然涨。 +2. 「录入」只在不符合之后可用。误说时播报「请先说不符合」,不直接进 P23,否则会录出一个没有对应结论的数值。 +3. 一次说两句(「不符合,下一个」)只取第一个结论,第二句忽略并播报「已记不符合」。 + +词表只有规范词。界面文案、播报、落库值一律用「符合/不符合/不适用」。识别层对现场沿用的旧说法做同义映射,映射表维护在语音指令配置里,不进入任何界面与本文正文。 + +示例区的话必须先唤醒。待命屏与清单屏的示例只是教学样例,未唤醒时说这些内容系统不响应,因此必须给一句「请先说『小新小新』」:现场把没反应当设备故障,比多说一句话的代价高得多。 + +「重新核对」与手机端页面名「核对检查对象」同源,现场听到的是同一个动作:停下当前这单,回到核对环节重新识别。它不作废整条记录,只作废这次的临时单,留痕里记谁在什么时候因为什么停了单。 + +## 4 逐屏定义 + +### 4.1 P16 待命屏 + +| 区域 | 内容 | +| --- | --- | +| R0 顶栏 | 左「就绪」,右「■ 手机已连接」;断开态改空心方块 | +| R0b 页面名 | 当前场景名;未定场景显示「未选择场景」 | +| R1 唤醒提示 | 「说『小新小新』开始」 | +| R2 示例轮播 | 前置一行「唤醒后可以说」,示例挂在左竖线下;按当前场景取示例组,M01 三条:开始检查、说结论推进、烟度要不要取样 | +| R3 底部声明 | 「检查在眼镜完成,修改在手机」 | + +起单有四种拒绝,都不生成任务:无上次场景、上次场景已停用、场景无冻结模板、手机未连接(起单可成但识别无法回传)。 + +### 4.2 P17 清单屏 + +| 区域 | 内容 | +| --- | --- | +| R1 对象行 | 识别键主字段大字加场景名;复合键的主字段与副行分开 | +| R2 当前项 | 项名 64px、状态图形、依据条款号一行 28px | +| R3 进度计数 | 已查 / 未查 / 不适用,形状加文字双兜底 | +| R4 下两项 | 当前项之后两个未查项的项名 | +| R5 同步角标 | 未同步的行右侧标「未同步」,补传后逐条消失 | + +R2 加依据条款号是本次唯一的加字。现场被问「凭什么判这条」时,屏上要有条号,不能每次回手机查。 + +### 4.3 P22 单项引导屏 + +项名、依据、三个结论块横排、一行语音提示。无顶栏状态条、无计数行:这一屏只服务一项,带计数反而分散注意力。 + +三个结论块的形状与清单屏三态图形一一对应:符合是实心方块、不符合是空心方块、不适用是斜纹方块。不符合在手机端仍是「已查」,异常与否由异常判定算,不由结论词算。 + +### 4.4 P23 录入屏 + +待录字段(名、单位、范围提示)、聆听态、识别回显(值 64px 加来源标「语音」)、兜底提示四段。 + +不落库的三种情况:超出范围、非数值、超时无输入。落库即回清单屏,不在本屏停留。 + +### 4.5 P24 提交结果屏 + +成功显示回执号后六位与「已留档」,失败显示「未提交」加差哪几项(最多三条,超出「还有 N 项」),断连显示「未连手机」。 + +三个变体的自动回落时长不同:成功与断连 3 秒,失败 8 秒。回落目标也不同,成功回待命屏,失败回清单屏的首个差异项。 + +### 4.6 P18 覆盖层与横幅 + +单实例栈,不并行叠放:聆听 → 路由 → 结果 → 判定已记录 → 待复核提醒。后一个替换前一个。 + +C-51 解决「说了结论但不确定系统有没有收到」,没有它现场会重复说一遍,把同一项说成两条。C-52 解决「提交完就走」,识别与语音的值没人看过,这份记录在复核时站不住。待复核数为 0 时不出现 C-52。 + +## 5 跨屏规则 + +| 规则 | 内容 | +| --- | --- | +| 断连 | 判定落本地队列,屏上标未同步,允许继续判定;按提交播报「请先连上手机」,不发校验请求 | +| 队列丢失 | 眼镜重启且未落盘,该行标「未落库」,不给补救入口;提交时由服务端列缺项后逐项补查 | +| 熄屏 | 全黑但语音与判定照常;四条横幅只播报不上屏;屏不因任何事件自动亮起 | +| 场景停用 | 大字下方一行「该场景已停用」,禁止判定与提交 | +| 文字兜底 | 三态计数永远显示文字,不只靠形状 | +| 不显示判定长文 | 眼镜上不播报长文案,失败只说差哪几项 | + +## 6 降级:L0 与 L1 + +L0(无屏)与 L1(仅状态灯)两档全部退化为语音,功能不缺失,只是没有视觉。两档不进一期验收,但代码分支不能删,否则换机型要改结构。 + +| 屏 | L0/L1 播报示例 | +| --- | --- | +| P17 | 「第 3 项,OBD 就绪状态,依据法典第 1126 条,说符合、不符合或不适用」 | +| P22 | 同上,进入即播,不等追问 | +| P23 | 「请说光吸收系数的数值,单位米的负一次方」,识别后播「一点二,说确认或重说」 | +| P24 | 成功播「已提交,回执号 000041」;失败播「未提交,缺 5 项」,只播前 3 条与总数 | + +## 7 功能点清单 + +| 编号 | 功能 | 规则 | 验收 | +| --- | --- | --- | --- | +| F-P16-01 | 顶栏状态 | 左就绪、右连接态,断开为空心方块 | 断开手机后顶栏右端变空心方块 | +| F-P16-02 | 页面名 | 显示当前场景名,随切换更新 | 切换场景后屏上名称同步,不残留旧名 | +| F-P16-03 | 唤醒提示 | 「说『小新小新』开始」 | 常显 | +| F-P16-04 | 示例轮播 | 按场景取示例组,3 条 5 秒轮换;示例区带「唤醒后可以说」前提标签,视觉从属于唤醒提示 | 切场景后示例组随之变化;未唤醒说示例内容时播报「请先说『小新小新』」,不静默 | +| F-P16-05 | 底部声明 | 「检查在眼镜完成,修改在手机」 | 常显,不含技术词 | +| F-P16-06 | 熄屏态 | 全黑,语音照常,屏不自动亮 | 说「关闭显示」后全黑,再说「开始检查」仍能起单 | +| F-P16-07 | 语音起单 | 按上次完成场景起单;四种拒绝各一句播报 | 无上次场景时播「请先在手机选择检查类型」,且不生成任务 | +| F-P17-01 | 顶栏状态 | 同 P16 | — | +| F-P17-02 | 对象行 | 识别键主字段加场景名,复合键副行 | M04 显示信用代码为主、点位编号为副 | +| F-P17-03 | 当前项 | 项名、状态图形、依据条款号 | lawRef 为空时显示「依据待补」 | +| F-P17-04 | 进度计数 | 已查、已查不适用、未查三段 | 计数与项状态实时一致 | +| F-P17-05 | 下两项 | 取当前项之后两个未查项 | 末项时该行不渲染 | +| F-P17-06 | 熄屏态 | 同 P16 | — | +| F-P17-07 | 显示事件挂载 | 接挂载、增量、清除三类下行事件 | 手机改值后屏上对应行变化 | +| F-P17-08 | 说结论即推进 | 两类结论;不适用追问原因;跳过不改状态 | 说「不符合」后落库值为「不符合」,项状态转已查 | +| F-P17-09 | 翻项 | 按名、按序、上一项、下一项、第 N 项 | 说「上一项」回到上一未查项 | +| F-P17-10 | 语音提交 | 先复述识别键求确认;断连拒绝;通过进 P24 | 断连时说提交只播报,不发校验 | +| F-P17-11 | 同步角标 | 未同步逐行标注,补传后逐条消失 | 断连判定后该行出现「未同步」,重连后消失 | +| F-P17-12 | 对象纠错 | 说「重新核对」作废本单并留痕 | 作废后回核对检查对象环节,留痕可见作废原因 | +| F-P22-01 | 项名展示 | 单行截断,18 字以内不换行 | 30 字项名截断加省略号,不缩字号 | +| F-P22-02 | 依据展示 | 取 lawRef,只显示条款号 | 无依据时显示「依据待补」 | +| F-P22-03 | 结论三选展示 | 三块横排,形状加文字 | 三块形状与清单屏三态一致 | +| F-P22-04 | 语音收结论 | 收结论后落定并回 P17 | 说「不符合」后三块中该块转高亮,回清单屏 | +| F-P22-05 | 不符合后续问 | 配了数值区间才问「是否录入数值」 | 布尔项不出现该追问 | +| F-P23-01 | 待录字段 | 字段名、单位、范围提示 | 未配范围时该行不出现 | +| F-P23-02 | 聆听态 | 波形条随音量变化,不做识别进度 | 说话时波形起伏 | +| F-P23-03 | 识别回显 | 值加单位,来源标「语音」 | 回显值与落库值一致 | +| F-P23-04 | 重说 | 清空回显重新聆听 | 说「重说」后回显清空 | +| F-P23-05 | 二次失败兜底 | 连续两次解析失败提示「请用手机录入」 | 两次失败后不再追问数值 | +| F-P24-01 | 成功展示 | 回执号后六位加「已留档」 | 后六位与手机端回执一致 | +| F-P24-02 | 失败展示 | 差哪几项最多三条,超出「还有 N 项」 | 8 个差异项时不滚动只列三条 | +| F-P24-03 | 断连展示 | 「未连手机」加一行提示 | 不发起校验请求 | +| F-P24-04 | 自动回落 | 成功 3 秒、断连 3 秒、失败 8 秒,无手动关闭 | 到时自动跳转,无关闭入口 | +| F-P24-05 | 语音继续 | 说「继续」回 P17 首个差异项 | 回落目标是差异项,不是首个未查项 | +| F-P18-01 | 聆听横幅 | C-29,与「请讲」同帧 | 唤醒后立即出现 | +| F-P18-02 | 路由横幅 | C-30,意图判定单行 | 兜底不经过本组件 | +| F-P18-03 | 结果横幅 | C-31,指令、答案、兜底三变体 | 三种说法各出其变体 | +| F-P18-04 | 自动回落 | 各横幅按自身时长回落 | 判定已记录 1.5 秒,待复核提醒 3 秒 | +| F-P18-05 | 熄屏边界 | 熄屏期间只播报不上屏 | 熄屏时判定不出现横幅 | +| F-P18-06 | 单实例栈 | 五类元素顺序替换,不叠放 | 连续判定只刷新主副行,不排队 | +| F-P18-07 | 兜底静默 | 未命中不弹条,只播固定话术 | 说无关内容不出现横幅 | +| F-P18-08 | 判定已记录横幅 | 主行加副行「已查 n / 总数」,1.5 秒 | 每记一条出现一次 | +| F-P18-09 | 待复核提醒横幅 | 主行加副行「手机可改」,3 秒,仅一次 | 待复核为 0 时不出现 | + +## 8 与手机端的分工接口 + +| 接口 | 方向 | 载荷 | 手机侧承接 | +| --- | --- | --- | --- | +| 判定 | 眼镜上行 | 项编号、结论、来源、时间、是否入队 | 落库,值进待复核清单 | +| 录入值 | 眼镜上行 | 项编号、原话、解析值、来源 voice | 落库,进待复核清单 | +| 挂载与增量 | 手机下行 | 清单、项状态、同步态 | 变值后下行刷新屏面 | +| 提交结果 | 手机下行 | 回执号或差异项列表 | P06 显示同一份回执与校验清单 | +| 核对检查对象 | 眼镜上行 | 识别键 | P02 只在识别失败或复合键缺段时拉起 | + +两路提交先进为准。眼镜提交成功后,手机 P06 进入即转回执段,不产生第二条记录。 + +## 9 验收范围 + +本板块 43 个功能点进入一期验收,对应 `03-user-stories-and-journey.md` 的 US-04-01 至 US-04-05。L0、L1 两档不验收但保留分支;实机分辨率与刷新率复核后只换 `gl-*` 令牌,不改结构。 + +## 10 Mock 数据一致性 + +六屏与手机端共用一套事实,取自 `reference/mock-data.md`。跨页出现的车号、项名、条号、进度必须能对上,不允许各页自造。 + +| 屏 | 关键数据 | 事实集对应 | +| --- | --- | --- | +| P16 | 场景名「路检路查」;示例三条为路检语境(烟度、OBD、尿素),不得混入堆场或废水场景的话术 | §4 场景与检查项 | +| P17 | 苏A12345 · 已查 2 / 未查 5 / 不适用 0,当前第 3 项光吸收系数「法典第 1124 条」 | §4 进度算术第 1 行 | +| P22 | 第 3 项光吸收系数,数值型,判不符合后可录入 | §4 第 3 项:值类型 数值 0 至 9.99 m⁻¹ | +| P23 | 光吸收系数 1.2 m⁻¹,范围 0 至 9.99 | §4 第 3 项终局 | +| P18 | 判定已记录,副行「已查 3 / 7」 | §4 进度算术第 3 行 | +| P24 | 差 4 项:OBD 就绪状态、尿素使用情况、OBD 通信,还有 1 项(车载诊断系统故障指示) | §4 进度算术第 4 行 | + +条号、限值属示例值,客户确认检查项依据后替换,只改数值不改结构(V13-Q13)。 + +## 11 未闭合 + +| 编号 | 内容 | 本板块的落法 | +| --- | --- | --- | +| V13-Q27 | 马路噪声下语音识别率未实测 | 录入屏不设置信度阈值,只在连续两次解析失败时兜底 | +| V13-Q25 / Q43 | 实机分辨率、单色或彩色、刷新率、书面确认 | 按 1280×720 与 `gl-*` 令牌落稿 | +| V13-Q11 | 其余五场景的示例话术 | M01 沿用三条,其余场景用通用三条占位 | +| V13-Q28 | 主页眼镜信息字段 | 与本板块无关,属手机端 R5 | + +一处设计值待实测:P24 失败回落 8 秒,依据是「够读完三条差异项」,未实测。偏短则延长到 12 秒,不做翻页。 diff --git a/05-mobile-field.md b/05-mobile-field.md new file mode 100644 index 0000000..463b270 --- /dev/null +++ b/05-mobile-field.md @@ -0,0 +1,277 @@ +# 05 手机端 · 链路与兜底 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-03 | +| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` §3、`02-pages/P25 P01 P19 P02 P03 P04 P20 P06`、`04-components.md` C-35 至 C-41、C-53 | +| 原型 | p25-launch、p01-login、p19-home、p02-object、p03-task、p04-capture、p20-review、p06-submit | +| 功能点 | 81(P25 5、P01 7、P19 11、P02 11、P03 12、P04 14、P20 8、P06 13) | +| 视口 | 375×812 | +| 数据来源 | `reference/mock-data.md`,八页示例值取自该文件 | +| 状态 | G4 交付,待评审 | + +## 1 端的定位 + +手机由主操作界面降为链路中转与兜底端。现场主路径在眼镜与语音里走完,手机在口袋里当中转;掏出来只有五个时刻:选场景、对象核对失败要手工录入、要改值、要看证据、要复核。 + +这个定位决定三条设计取向: + +1. 页面不为「常用」优化,为「必须用时一次做对」优化。既然不常掏,就要求一次就位,不做多级跳转。 +2. 凡是眼镜能做的主入口,手机不重复做一遍。改值是例外,因为改值本来就要看清单与证据。 +3. 手机有眼镜没有的四样东西:键盘、相机回放、列表浏览、批量操作。手机的价值在这四样上,不在「也能提交」这条上。 + +## 2 八页一览 + +| 页面 | 路由 | 一句话 | 入口 | 出口 | 功能点 | +| --- | --- | --- | --- | --- | --- | +| P25 启动页 | `/launch` | 遮住必然的等待,超时给退路 | 冷启动 | P19 或 P01 | 5 | +| P01 登录 | `/login` | 进得来,把不该进来的拦住 | P25;退出 | P19 | 7 | +| P19 主页 | `/home` | 眼镜在不在、能查哪几类、还欠几张单 | P01;P06 回主页 | P02、P03、P20、P05 | 11 | +| P02 核对检查对象 | `/confirm/:taskId` | 系统看到的那一个对象,人再核对一次 | P19 可作业卡;眼镜识别失败 | P03、P19 | 11 | +| P03 任务 | `/task/:taskId` | 这个对象该查什么,一眼看全 | P02;P04 返回;P19 在办单 | P04、P05、P06 | 12 | +| P04 填报与采集 | `/item/:taskId/:itemId` | 把这一项的值改对、证据补齐 | P03 项行;P20 跳转 | P03、P05 | 14 | +| P20 待复核清单 | `/review/:taskId?` | 哪些值是机器或嘴给的,人核对一遍 | P06 回执;P19 待复核条数 | P04 | 8 | +| P06 提交与回执 | `/submit/:taskId` | 交没交成、交完是什么状态 | P03 底部;P19 在办单 | P20、P19、P03 | 13 | + +P07 回执页停用,整体并入 P06 尾部的 S3 段。 + +## 3 主页高度账 + +375×812,含 44px 系统状态栏。上方各块高度固定,只有场景区可伸缩。 + +| 层 | 高度 | 说明 | +| --- | --- | --- | +| R0 状态栏 | 44 | 系统占位,照画不画内容 | +| R4 账号卡 | 60 | 姓名、角色、组织 | +| R5 眼镜卡 | 80 | 连接态、路径、电量、固件 | +| R7 在办与待复核 | 128 起 | 块标题 24 + 在办行 64×n + 待复核行 40 | +| R6 场景区 | 328 起 | 族标题 32 + 可作业卡 96 + 占位行 40×5 | +| R8 底栏 | 56 | 手输识别键、智能问答 | +| 安全区 | 20 | 手势区按 20 算 | + +三种实排结果: + +| 情形 | 合计 | 结论 | +| --- | --- | --- | +| 在办 0 条、待复核 0 条(主态,即常态) | 612 | 余 200,场景区可多留白 | +| 在办 1 条、待复核 3 条(在办与待复核态) | 716 | 余 96,无需下滚 | +| 在办 3 条、待复核 3 条(上限) | 844 | 超 32,页面下滚 | + +一条硬规则从这里来:占位场景在主页一律用 40 高行,不用 96 高卡。一期五类无模板,五张灰卡吃掉 480px,会把在办单挤出首屏;改五行只占 200px。占位卡形态只在说明弹层与全部场景列表里出现,那里需要与可作业卡并列比较。 + +## 4 逐页定义 + +### 4.1 P25 启动页 + +深色,全局唯一。取景框四角、车牌轮廓、斜向光带、透视网格全部矢量绘制,色值只取两档蓝。 + +状态行三句依次替换:恢复登录态、连接眼镜、正在同步场景授权,每句最短停留 300 毫秒。三步在 3 秒内返回就跳,不等动画播完;超过 5 秒转兜底,给「重试」与「先进入」,无登录态时只给「重试」。 + +眼镜连不上不拦人:前两步完成即放行,连接状态交给主页眼镜卡。 + +功能点合并说明:入场淡入与光带扫过视为同一功能点「入场动效」,验收时一起看,因此本页计 5。分片把两者拆成两条,合并后与 `01-SPEC` §3 的计数一致。 + +### 4.2 P01 登录 + +只保留未登录态。品牌在启动页已露出过一次,这里只留一行小字「现场检查助手」。 + +五角色里只放行执法员与中队负责人,其余三个登录即整页拦截:标题「无现场作业权限」,一行说明,只有「退出登录」。平台管理员不上手机,是避免现场用一个能改授权的高权账号作业。不给申请入口,一期没有申请流。 + +登录失败分两种,文案必须分开:账号密码错是「工号或密码不正确」,角色越权是「当前账号无现场作业权限」。前者可重试,后者重试无用,混成一句会让人一直试密码。 + +### 4.3 P19 主页 + +渲染顺序固定:状态栏、账号卡、眼镜卡、在办与待复核、场景区、底栏。在办块排在场景区之前,因为主页要回答的三个问题里只有「还欠几张单」每天都在变。 + +场景卡三态由三个条件串起来决定:已授权、已启用、有冻结模板。三者齐备是可作业卡,缺模板是占位行,未授权或未启用不渲染。判定只读 `template.frozenVersion` 是否为空,不读 moduleId,也不读角色。 + +场景区按判定结构分四族:单对象、送检、区域、事件。族内无卡时整族不渲染,包括标题。第一行右侧固定一张「全部场景」入口卡,作用是对冲「系统只支持一类检查」的误读。 + +页面两态,主态是常态:在办 0 且待复核 0,在办块整块不渲染,场景卡不显在办数(画布 P19-a)。在办与待复核态只在异常时出现(在办 ≥1 或待复核 >0,画布 P19):一期无派单,在办块是中断、设备没电、换班后的恢复入口,不是待办列表,不设「待办」字样与红点角标,避免开发做成任务推送。高度账见 §3。 + +说明层 M-05 有两个入口:占位行点击与「全部场景」卡点击,共用同一弹层。层内列六类场景,可作业的排前面并带识别键标签,待开通的显示「尚未开放」;层头一行计数「可检查 N 个场景 · 待开通 M 个」。层内不设起单按钮,底部固定一句「待开通场景仅可查看说明,暂不能开始检查」,说明页不是入口。 + +### 4.4 P02 核对检查对象 + +页面名「核对检查对象」,按钮「开始检查」。基线的「确认」像签收,实际动作是核对一致性。 + +识别键随对象类型变,录入形态随之变:车牌裁掉 I 与 O,机械登记码保留全字符,机构名与信用代码走编码手输,点位与排口走扫码或编码。 + +车辆档案在识别成功后按车牌带出,展示五个字段(车型、品牌型号、排放阶段、燃料类型、注册日期),卡头标来源「档案」。不设独立车型选择区:档案已经给了答案,单摆一个选择区等于暗示还要人工填。发现档案车型与实际不符时点车型行弹三选修正,来源转手输并留痕。 + +两条确认路径:眼镜语音确认是默认路径,手机不点亮;手机界面确认是兜底路径,只在识别失败、复合键缺第二字段、语音确认超时 20 秒三种情况下被拉起。复合键缺第二字段只在复合键对象上出现(堆场场景的统一社会信用代码加点位编号,起单前必须两项齐备);路检路查车牌是单键,一期 M01 不触发该状态,画面照建是为 M04 类场景接入时同一路由直接可用。 + +### 4.5 P03 任务 + +三层外壳不动,内层按判定结构换:对象条、进度摘要、清单主体。四种布局由 `structure` 决定,界面不给手动切换控件。一期只有 L1 单对象清单落地;L2 清单加送检、L3 对象加点位、L4 事件线索是 M03/M04/M05 实装后的同页形态,画布有分镜(P03-b/c/d),一期不实现。 + +分组标题与组内计数取模板的 `groupName` 与 `groupSeq`,不硬编码排气、OBD、装置这类名字。分组一旦硬编码,加一类场景就要改一次前端,模块化指标当场破。 + +任务切换态只在从主页「还有 N 单」进入时出现,从对象核对或填报返回一律不出。切换态回答的是「我手上还有几张单」,起单那一刻这个问题不存在。 + +### 4.6 P04 填报与采集 + +改的不是控件,是取值、落库、标记三件事。五类控件按 `value_type` 分支的机制原样保留,它已经是数据驱动的。 + +来源标记四类全显,包括手输。人工改写后来源转手输,留痕记改前来源。改回原值仍记手输:判定值有没有被人动过,是复核时最想知道的一件事,不能因为改回原样就抹掉。 + +送检类项值区转只读,显示「送检项,结论由科室回填」,素材与备注仍可补。手机端不提供送检推进,给出可点入口就会产生现场自作结论的口子。 + +### 4.7 P20 待复核清单 + +清单在提交之后,不在提交之前。定型主流程是「落库留痕 → 复核」,复核不是第二道校验,是一轮事后核对。 + +只收识别、语音、转抄三类来源(推断:清单过长会被弃用,待现场验证),手输是人亲自敲的,不进清单。 + +跨任务视图不出现批量确认:一次误点会确认掉另一单的条目。这条是本文加的约束,分片未写。 + +### 4.8 P06 提交与回执 + +同路由四阶段:校验、提交中、回执、待送检变体。S4 不是第五个页面,也不是弹层,是同一路由的渲染分支。 + +阻断分三层:必检未查、关键项缺素材、不适用无原因。前两条界面拦一次,第三条界面与服务端各拦一次,因为眼镜语音提交不经过本页。 + +两路提交先进为准。本单已被眼镜提交时,进入即转回执并提示「本单已提交」,不产生第二条记录。 + +## 5 跨页规则 + +| 规则 | 内容 | +| --- | --- | +| 对象类型驱动 | 识别键字段、录入形态、任务布局、列头标签四处都读 `objectType` 与 `structure`,不读 moduleId | +| 来源标记 | 识别、语音、手输、转抄四类全显;缺失标黄,不改写成任何来源 | +| 提交两路 | 眼镜与手机都能提交,先进为准,不产生第二条记录 | +| 复核在后 | 复核在提交之后,改值留痕标已修改,不走审批 | +| 断网 | 可浏览已加载内容;提交直接失败并提示,不进提交中态,因为校验在服务端 | +| 准入 | 只有执法员与中队负责人可登录,其余角色整页拦截 | +| 场景停用 | 任务页顶部出提示,填报页全页只读,提交禁用并给原因 | + +## 6 功能点清单 + +| 编号 | 功能 | 验收 | +| --- | --- | --- | +| F-P25-01 | 品牌露出 | 产品名与版本号常显,不可点 | +| F-P25-02 | 进度转述 | 三句依次替换,每句最短 300 毫秒 | +| F-P25-03 | 就绪跳转 | 三步返回即跳,不等动画播完 | +| F-P25-04 | 超时兜底 | 超 5 秒给「重试」与「先进入」;无登录态时只给「重试」 | +| F-P25-05 | 入场动效 | 淡入 400 毫秒加光带扫过一次,不循环;从后台恢复不重播 | +| F-P01-01 | 品牌小字 | 一行 14px 次要色「现场检查助手」 | +| F-P01-02 | 工号输入 | 记住上次工号,可清空 | +| F-P01-03 | 密码输入 | 密文显示,可切换明文 | +| F-P01-04 | 登录提交 | 提交中按钮内加载,字段禁编辑 | +| F-P01-05 | 登录失败提示 | 账号密码错与角色越权文案分开,不清空工号 | +| F-P01-06 | 待提交队列徽标 | 数量取本地未提交队列,为空不渲染 | +| F-P01-07 | 记住工号 | 开关状态本地保存 | +| F-P19-01 | 账号卡 | 姓名、角色、组织,不做头像,不可点 | +| F-P19-02 | 眼镜卡 | 连接三态、路径、电量、固件版本 | +| F-P19-03 | 眼镜卡点开 | 已连接进详情,未连接为「重试连接」 | +| F-P19-04 | 场景区渲染 | 可作业出卡、已启用无模板出占位行,按四族分组,空族不渲染 | +| F-P19-05 | 可作业卡起单 | 点卡进 P02 并带 moduleId | +| F-P19-06 | 占位行说明 | 点行进说明层,层内无起单按钮 | +| F-P19-07 | 在办单列表 | 最多三条,第 4 条起换「还有 N 单」,跨日整行转红 | +| F-P19-08 | 待复核入口 | 条数大于 0 才显示 | +| F-P19-09 | 手输识别键 | 无可用场景时先弹场景选择 | +| F-P19-10 | 智能问答 | 进 P05,标记来源为主页(from=home) | +| F-P19-11 | 眼镜推送处理 | 连接态、电量、固件变化时刷新眼镜卡 | +| F-P02-01 | 截帧展示 | 带设备时间与来源水印,仅用于核对,不入素材正片 | +| F-P02-02 | 识别结果大字 | 主字段随对象类型;复合键出两个字段位,缺段转黄 | +| F-P02-03 | 开始检查按钮 | 重复在办时不新建,转既有单并提示 | +| F-P02-04 | 修正入口 | 修正后原值与录入值双存,来源转手输 | +| F-P02-05 | 识别键录入器 | 字符集按类型裁,三种形态共用同一提交与留痕 | +| F-P02-06 | 省份简称选择 | 仅车牌形态出现 | +| F-P02-07 | 车型档案卡 | 档案带出五字段;未命中退化为三选手选;仅 M01 渲染 | +| F-P02-08 | 手输入口 | 识别失败时直接展开,不阻断 | +| F-P02-09 | 识别失败兜底 | 三条路径都能落,落完必标来源 | +| F-P02-10 | 重新识别 | 清空结果重新走识别 | +| F-P02-11 | 复合键第二字段 | 独立录入位与格式校验;缺字段时按钮禁用并给原因 | +| F-P03-01 | 对象条 | 主字段 20px 等宽加场景徽标,复合键副行 13px | +| F-P03-02 | 进度摘要 | 四套随 structure 换,圆环与计数同步 | +| F-P03-03 | 清单分组 | 组名与顺序取模板,不硬编码 | +| F-P03-04 | 进入单项填报 | 行可点,返回恢复滚动位置 | +| F-P03-05 | 当前项焦点 | 语音翻项只移动焦点并高亮 2 秒 | +| F-P03-06 | 进入问答 | 带任务号与来源标记(taskId、from=task) | +| F-P03-07 | 进入提交 | 有未查项也进;有待送检加只读条 | +| F-P03-08 | 清单刷新 | 下拉刷新,返回自动静默刷新 | +| F-P03-09 | 电量徽标 | 只留电量百分比,完整信息在主页 | +| F-P03-10 | 布局渲染 | 按 structure 渲染四套之一,无手动切换控件 | +| F-P03-11 | 点位切换与阶段展示 | L3 横滑切点位,L4 阶段时间线;L1、L2 不渲染 | +| F-P03-12 | 任务切换态 | 只从主页「还有 N 单」进入时出现,退出不记忆 | +| F-P04-01 | 项名与依据 | 依据带层号 A 至 D | +| F-P04-02 | 值控件 | 枚举、数值、布尔三类按 value_type 分支 | +| F-P04-03 | 单位与区间 | 字典未到位显示破折号,不显示 0 | +| F-P04-04 | 不适用原因 | 原因为空不允许确认,弹层内即拦 | +| F-P04-05 | 素材采集 | 六行信息齐全,采集与接收时间并排 | +| F-P04-06 | 素材重采与删除 | 删除只标缺失,不物理删 | +| F-P04-07 | 语音提问 | 进 P05,标记来源为填报页(from=item)并自动带入问题 | +| F-P04-08 | 保存 | 写值与来源;未改动保留原来源 | +| F-P04-09 | 已提交可改 | 原提交人可改,留痕标已修改 | +| F-P04-10 | 异常标 | 命中异常判定显示异常,字典未到位不显示 | +| F-P04-11 | 标缺失 | 素材缺失走弹层填原因 | +| F-P04-12 | 备注 | 长文本可录,不做截断提示 | +| F-P04-13 | 来源标记 | 四类全显;人工改写转手输并记改前来源;改回原值仍记手输 | +| F-P04-14 | 送检项只读段 | 值区只读并说明结论由科室回填;素材与备注仍可补 | +| F-P20-01 | 条目列表 | 按录入时间倒序,每页 20 条上滑加载 | +| F-P20-02 | 条目内容 | 值、来源标、所属项、时间四件齐 | +| F-P20-03 | 跨任务识别键 | 无 taskId 时每条显示识别键与场景名 | +| F-P20-04 | 单条确认 | 行渐隐移出,计数减一,不弹轻提示 | +| F-P20-05 | 跳转改值 | 点行其他区域进 P04 并带 from=review | +| F-P20-06 | 批量确认本单 | 仅单任务视图出现,走二次确认 | +| F-P20-07 | 剩余条数 | 「还剩 3 / 21」,随确认实时变 | +| F-P20-08 | 全部确认后返回 | 计数归零后按钮换「完成」回主页 | +| F-P06-01 | 校验清单 | 三类阻断分层展示 | +| F-P06-02 | 三层阻断 | 必检未查、关键项缺素材、不适用无原因 | +| F-P06-03 | 软缺失标缺失 | 行内「标缺失」弹层,不阻断 | +| F-P06-04 | 提交按钮 | 阻断未清禁用并写原因;有待送检加只读条 | +| F-P06-05 | 二次确认 | 文案写明提交后仍可改、改动留痕 | +| F-P06-06 | 提交中 | 清单禁点,按钮加载 | +| F-P06-07 | 提交失败 | 校验不过留原页并高亮差异项;网络失败轻提示可重试 | +| F-P06-08 | 素材待补先交 | 允许,回执标待补数量 | +| F-P06-09 | 回执卡 | 记录号、提交时间、提交人、状态、素材进度 | +| F-P06-10 | 记录号复制 | 长按复制完整任务号并提示已复制 | +| F-P06-11 | 素材补传进度 | 逐项转已传,失败单项可重试 | +| F-P06-12 | 回执后去向 | 有待复核给「去复核 N 项」,无则「回主页」 | +| F-P06-13 | 两路提交冲突 | 已被眼镜提交时直接转回执并提示 | + +## 7 Mock 数据一致性 + +八页共用 `reference/mock-data.md` 的事实集。本次主态的数字链: + +| 页 | 关键数据 | +| --- | --- | +| P19 | 在办 1 条:苏A12345 · 路检路查 · 已查 3/7 · 14:20 起单;待复核 3 项;场景区一张可作业卡加五行占位 | +| P02 | 苏A12345 · 小型轿车 · 汽油 · 国Ⅴ · 大众牌 FV7160 · 注册 2018-06-12 | +| P03 | 七项清单,第 3 项光吸收系数已判不符合并录 1.2,进度已查 3 / 未查 4 / 不适用 0 | +| P04 | 第 3 项光吸收系数,值 1.2 m⁻¹,来源语音,排烟短片 1 张已传 | +| P20 | 跨任务视图 3 条:苏A12345 车牌(识别)、苏A12345 光吸收系数 1.2(语音)、苏A88888 车牌(识别);不出现批量确认 | +| P06 | 校验清单阻断 4 项:OBD 就绪状态未查、尿素使用情况不适用未填原因、OBD 通信未查、车载诊断系统故障指示未查;M01 无送检结构,页面不出现送检条 | + +## 8 验收范围 + +81 个功能点进一期验收,对应 `03-user-stories-and-journey.md` 的 US-05-01 至 US-05-10。启动页离线缓存、P20 批量条数上限、P06 的 S4 催办三项属设计值,客户表态前不作验收判据。 + +## 9 状态覆盖(页内切换) + +状态切换与原型分离,两条入口:一是独立切换台 `prototypes/pages/p-states-mobile.html`(manifest 登记 P-STATES,R4 模块,占画布一张卡位),左列按页分组列出 48 个状态,右侧手机框内嵌对应页面,支持 `?state=` 深链;二是各原型页浏览器单独打开时的左侧固定面板(底座内嵌时隐藏)。登记原则:弹层与可点击触发的状态不设独立页,直接在主原型页内点击体验(M-05 全部场景说明层在 P19 点「全部场景」卡或占位行打开,点遮罩关闭;P02 重新识别与手工录入、P04 不适用切换同此);其余条件态不铺开到画布,统一收进画板导航,标注(M03/M04/复合键场景)的一期 M01 不触发。48 个的清点口径:下表「可切换状态」列之和,页内点击体验项(M-05)不计入,同一状态的按钮变体计 1;纯过程态(重试、先进入、跳转中)不占画面,在面板说明或注释中标注去向。P05 智能问答的状态另见 08 板块 §8。 + +| 页 | 主态 | 可切换状态 | 过程态与页内体验(不占状态画板) | +| --- | --- | --- | --- | +| P25 | 正常就绪 | 超时 5 秒(重试/先进入)、超时且无登录(仅重试) | 无登录态跳 P01、眼镜未连接不阻塞、授权失败进 P19 后重试 | +| P01 | 默认 | 提交中、密码错误、角色越权、网络失败、登录已过期 | 输入中(默认态含已填字段即可审) | +| P19 | 常态(P19-a,无在办块) | 在办与待复核态(P19)、加载中、连接中、未连接、电量低、无场景授权、全部占位、场景加载失败 | 场景停用(卡片消失,落点在 P03 顶部提示)、全部场景说明层(M-05,页内点击体验,不进状态画板;画布 P19-b) | +| P02 | 识别成功 | 识别中、识别失败、复合键缺字段、重复在办、语音确认超时 | 场景无模板(在 P19 即拒)、场景停用、点位超限(M04,一期不触发) | +| P03 | 正常 | 加载中、全部已查、含待送检(M03)、含阻断项、场景停用、已提交只读、模板为空、加载失败、任务切换态(在办 ≥2 从主页进入时) | 眼镜推送同步(静默刷新无画面)、点位超限(防御分支) | +| P04 | 已填 | 未填、不适用、送检项(M03)、已提交修改、未保存离开、保存失败 | 保存中(按钮 loading)、场景停用(同 P03 只读链) | +| P20 | 有数据(跨任务视图) | 加载中、空(本单)、空(跨任务)、加载失败、确认中、场景停用、单任务视图(有批量确认,画布 P20 主图) | 改完返回(条目移出即结果)、并发删除(提示后刷新) | +| P06 | S1 有阻断 | S1 无阻断、S2 提交中、S3 回执、S4 待送检(M03)、已被眼镜提交、网络失败 | — | + +标注(M03)的状态一期 M01 不触发,画面照建并注明出现条件。各状态层是页面内固定定位的完整 375×812 屏。 + +## 10 未闭合 + +| 编号 | 内容 | 本板块的落法 | +| --- | --- | --- | +| — | 启动页离线缓存 7 天 | 分片自定值,需复核;本篇按 7 天写 | +| — | 登录态 8 小时、超时 5 秒 | 设计值,客户未表态 | +| W-03 | 复核与提交先后 | 按定型:先提交后复核 | +| W-07 | 送检项四态标签与手机是否可改判定 | 只读,可进 P04 但送检字段只读 | +| V13-Q27 | 语音识别率 | 影响 P04 改值频次,不改页面 | +| V13-Q45 | 车辆档案数据源 | 一期本地 mock,正式对接另立接口条目 | diff --git a/06-platform-records.md b/06-platform-records.md new file mode 100644 index 0000000..afb1212 --- /dev/null +++ b/06-platform-records.md @@ -0,0 +1,200 @@ +# 06 平台端 · 场景口径与留档 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-04 | +| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` §3、`02-pages/P21 P11 P12 P10`、`prototype/02-pages/P08 P13`(复用)、`04-components.md` C-42 至 C-46 | +| 原型 | p08-login、p21-scene-mgmt、p11-records、p12-task-detail、p12-tab-compare、p10-templates、p13-audit-logs | +| 功能点 | 54(P08 5、P21 10、P11 10、P12 14、P10 8、P13 7) | +| 视口 | 1440×900,左侧六项菜单:检查记录、法规问答、账号与角色、场景管理、操作日志、语音指令配置 | +| 数据来源 | `reference/mock-data.md`,七页示例值取自该文件 | +| 状态 | G4 交付,待评审 | + +P09(11 个功能点)归 07 账号与授权,P14(7 个)归 08 法规问答,不在本板块;54 + 11 + 7 = 72,与 `01-SPEC` §3 平台小计一致。 + +## 1 端的定位 + +平台不发起检查、不派单、不下结论。三件事只有平台能做:定口径(场景启停、模板冻结)、看事实(检查记录与详情)、配权限(07 交付)。平台读的是眼镜与手机产生的事实,所以 G4 顺序里它排在最后。 + +平台页面沿用第一版骨架的决策已写入 `01-SPEC` §6:菜单六项只动一格,「车型与规则」升级为「场景管理」,其余原位。 + +## 2 七页一览 + +| 页面 | 路由 | 一句话 | 入口 | 出口 | 功能点 | +| --- | --- | --- | --- | --- | --- | +| P08 平台登录 | `/login` | 只有本局的人能进 | 浏览器;会话过期 | P11 | 5 | +| P21 场景管理 | `/sys/modules` | 有哪几类检查、启用没启用、模板在哪一版 | 菜单第 4 项 | P10、P11、P09(07 交付) | 10 | +| P11 检查记录 | `/records` | 各场景查了哪些对象、结了多少、卡在哪 | 登录默认页;菜单第 1 项;P21 停用被拒 | P12 | 10 | +| P12 任务详情 | `/records/:taskId?tab=items\|media\|basic\|audit` | 这一次检查的完整事实 | P11 | P14(08 交付,新标签) | 14 | +| P12 Tab 对照 | 同上(多帧) | M04 子记录变体与素材六行卡 | 画布对照 | 无 | 不计 | +| P10 场景模板 | `/sys/modules/:moduleId/templates` | 这类对象查哪些项、生效哪一版 | P21 模板版本列 | 返回 P21 | 8 | +| P13 操作日志 | `/sys/logs` | 谁在什么时间动了什么 | 菜单第 5 项 | 无 | 7 | + +P12 Tab 对照页是 P12 的多帧画板,登记在 manifest 但不另计功能点,导出时随 P12 一并截图。 + +## 3 逐页定义 + +### 3.1 P08 平台登录 + +单卡片居中 400px,政务内网视觉,不做左右分栏插画。与手机 P01 的三点差异:五角色都可登平台(角色拦截只在手机端);无「记住工号」;无待提交队列徽标。忘记密码走管理员在 P09 重置,页面不提供注册、找回密码、验证码入口。 + +失败提示统一「账号或密码错误」,不暴露账号是否存在。会话过期从任意页 401 回本页并轻提示。token 不进 localStorage。 + +### 3.2 P21 场景管理 + +新增页。六行固定,按场景号升序,无新建与删除入口——模块化不等于客户可自建场景。十列表放不下的口径进右侧 480 抽屉(C-43),抽屉全只读,不放「编辑口径」:口径维护走模板导入,一期没有配置界面。 + +启用开关关闭→开启直接生效,无冻结模板时弹提示「启用后只能查看、不能起单」,Toast 与表格黄标双落点。开启→关闭走二次确认;存在在办单时不渲染确认按钮,只给「当前有 N 个在办单,不能停用」加「去检查记录」链接,无强制停用口子。停用时在办单数取不到,按拒绝处理,宁可不给停、不可误停。 + +模板版本列可点进 P10(二级页),空值「未配置」转黄不可点;无「场景与模板查看」权限(`template.view`)时整列不可点。「配授权」跳 P09 并带场景号(07 交付);无「授权配置」权限(`role.grant`)时该列不出现。无「场景启停」权限(`module.toggle`)时开关整列不渲染。 + +判定结构列的中文显示(单对象/送检/区域/事件)必须与手机主页族标题同词。 + +### 3.3 P11 检查记录 + +登录默认页。表格、分页、勾选导出继承基线,改动集中六处:车型筛选换场景多选、车牌筛选换识别键筛选(300ms 防抖)、状态扩为生命周期五态加已修改、加场景列、导出加「按场景汇总」Sheet、表格上方加统计汇总带(C-42)。 + +汇总带八个量:任务数(按任务号去重)、填报项数(结果行数)、问题项数(命中异常判定或不符合;字典 D-06 未到位显示 `—` 不显示 0)、NA 无原因数(恒为 0,非 0 转红加 Tooltip)、结案数、待结论数、结案率、待办积压。计数类量为整数,结案率与待办积压保留一位小数。六个基础量跟随筛选实时刷新,不设独立统计页、不做图表。导出 Sheet 只含原始六量,派生量不进 Excel,避免两个口径。 + +识别键列头读筛选态:未选或多选场景显示「识别键」,单选一个场景显示该场景标签(如「车牌」)。实现读筛选态推列头,不写 `if (moduleId === 'M01')`。默认排序按最近操作时间倒序——在办单没有提交时间,按提交时间排会沉底。 + +「待结论」超期红标需要客户给时限后才会出现(V13-Q05),时限未定不编天数,列表只显示「待结论」。筛选超出授权范围不报错,按权限裁剪并在汇总带尾标「已按权限裁剪」。 + +### 3.4 P12 任务详情 + +四 Tab 不变,检查明细 Tab 内分三段:送检区块(有则显示)→ 检查项表 → 子记录区块(有则显示)。送检与子记录都属「这一次检查的事实」,与检查项共用一条阅读动线,不新增第五个 Tab。 + +页头换识别键主字段加任务号,状态标签支持五态。基本信息字段换为:识别键、场景、对象类型、模板版本加冻结时间、起单人、起单入口(手机/眼镜)。明细表加来源列(C-38)与依据层号 A 至 D;行展开区含判定依据全文、来源历史(改前改后几轮)、该行素材缩略。 + +送检区块七列:送检项、采样时间、送检单位(出具机构)、状态(待采样/已采样/核验合格/核验不合格)、回填结论、回填人加时间、超期。回填弹层只有结论下拉加必填说明加可选附件;出具机构取「送检单位」,不允许手填别的机构名。入口只对有「送检回填」权限(`lab.fill`)的人渲染——现场人员不给自己送出去的样下结论。回填后任务待结论→已结论;核验不合格生成问题项,进 P11 问题项数。 + +子记录区块只在 REGIONAL 结构或对象含排口时渲染,L1 单对象任务整块不出现、不留空标题。点位编号与描述分两列存、分两列显。 + +模板版本锁定:本单按起单时版本校验,页头一行灰字提示最新版差异,只提示不改数据。导出 PDF 加子记录与送检结论两节,素材仍只列清单。 + +### 3.5 P10 场景模板(二级页) + +不占菜单位,入口只在 P21 模板版本列,面包屑「场景管理 / {场景名} / 模板」,首段可点返回并保持原行选中。左栏只剩当前场景的对象分类:M01 三个车型沿用基线,M02 至 M06 单节点也渲染——省掉后第七类场景接入时结构要变。本页不做场景下拉,同一层出现两套导航会分不清「换场景」和「换对象分类」。 + +右栏顶部版本条(C-45):当前版本、冻结时间、制定人、项数,右侧「冻结新版本」(有「模板冻结」权限 `template.freeze` 才可见)与历史版本下拉。冻结 Modal 含在办单数提示「另有 N 个在办单仍使用旧版本」;浏览旧版整页只读加顶部 Alert。起单锁定模板版本,提交校验与详情渲染都按锁定版本跑——改模板不改历史单据。 + +检查项表加分组、建议来源、判定结构三列;依据列显示「{层号} {条款号}」,A/B 层带锁定图标。「建议来源」是模板对该项的预期取值方式,语义(预期 vs 强制)待定,见 §8。表格无行操作列:A/B 层不许删项,不给删除口子。 + +未启用场景可进本页浏览,页头灰标「场景未启用」;无「场景与模板查看」权限(`template.view`)深链进 403。检查项 0 条时空态且冻结按钮禁用(至少 1 项才能冻结)。 + +### 3.6 P13 操作日志 + +与 P12 操作留痕同源不同视角:那边看一条记录的历史,这边看全局流水。只追加,不可修改或删除,两处都不提供。筛选四项:操作人、对象类型、动作、时间范围,服务端分页页长 50 按时间倒序。 + +不提供导出(D-07 已定):日志导出引出脱敏与分发失控,一期无客户需求。不记来源 IP,只记操作人与账号。登录失败也记(`failed_login`,对象为账号),这是审计最常查的一条。V1.3 对象类型扩为四类:检查记录、用户、角色、场景与模板。 + +## 4 跨页规则 + +| 规则 | 内容 | +| --- | --- | +| 模板版本锁定 | 起单锁版本,P10 改模板不改历史单据;P12 按锁定版本校验并提示最新版差异 | +| 场景停用 | 影响起单不影响历史:P21 停用被拒看在办单,P11 可筛未启用场景的历史任务,P12 正常查看 | +| 词族两分 | 检查项「符合/不符合/不适用」,送检「核验合格/核验不合格」且必须带出具机构;「超标」「违法」「应当处罚」不出现 | +| 留痕不可改 | P12 操作留痕与 P13 日志都只追加;来源变更、识别键改动、档案查询三类事件都进留痕 | +| 权限裁剪 | 数据按授权范围裁剪不报错,P11 汇总带尾标提示;无权限的功能点整列或整页不渲染 | +| 统计口径 | 六量跟随筛选实时算;问题项数字典未到位显示 `—`;NA 无原因数恒 0 | + +## 5 功能点清单 + +| 编号 | 功能 | 验收 | +| --- | --- | --- | +| F-P08-01 | 账号密码登录 | 两项非空可点,回车提交;提交中按钮加载、字段禁编辑 | +| F-P08-02 | 密码可见切换 | 密文/明文切换 | +| F-P08-03 | 失败提示 | 统一「账号或密码错误」,保留账号清空密码 | +| F-P08-04 | 登录后跳转 | 带 redirect 回原页,否则进 P11 | +| F-P08-05 | 会话过期 | 任意页 401 回本页并提示 | +| F-P21-01 | 场景表渲染 | 六行固定按场景号升序,无排序筛选 | +| F-P21-02 | 表列展示 | 十列,官方事项名称超长省略加 Tooltip | +| F-P21-03 | 口径抽屉打开 | 点行打开右侧抽屉,不遮表 | +| F-P21-04 | 抽屉内容 | 基本信息加九项余四项加派生属性,全只读 | +| F-P21-05 | 启用开关 | 无模板时弹「启用后只能查看、不能起单」 | +| F-P21-06 | 停用二次确认 | Modal 文案含影响面 | +| F-P21-07 | 停用被拒 | 在办单大于 0 不渲染确认按钮,给「去检查记录」 | +| F-P21-08 | 授权入口 | 跳 P09 带场景号;无「授权配置」权限整列不出现 | +| F-P21-09 | 模板版本跳转 | 进 P10;空值与无「场景与模板查看」权限不可点 | +| F-P21-10 | 只读模式 | 无「场景启停」权限开关列不渲染 | +| F-P11-01 | 列表加载 | 按最近操作时间倒序,服务端分页 | +| F-P11-02 | 识别键筛选 | 300ms 防抖,精确命中优先 | +| F-P11-03 | 场景多选 | 选项为有「任务查看」权限(record.view)的场景 | +| F-P11-04 | 执法人员筛选 | 单选 | +| F-P11-05 | 时间范围 | 范围选择加快捷项 | +| F-P11-06 | 状态筛选 | 五态加已修改标记 | +| F-P11-07 | 进详情 | 点识别键或行末查看,进 P12 | +| F-P11-08 | 导出所选 | 主 Sheet 加按场景汇总 Sheet(原始六量) | +| F-P11-09 | 重置 | 清空全部筛选 | +| F-P11-10 | 统计汇总带 | 八量随筛选实时刷新,权限裁剪带尾标 | +| F-P12-01 | 页头与摘要 | 识别键主字段加场景徽标加任务号加状态加导出 | +| F-P12-02 | Tab 切换 | 只改 query,不重取记录头 | +| F-P12-03 | 基本信息 | 识别键、场景、模板版本加冻结时间、起单人、起单入口 | +| F-P12-04 | 同对象历史 | 按识别键查;Popover 最近 5 次加总数,点开跳 P11 带筛选 | +| F-P12-05 | 检查明细表 | 加来源列与依据层号;异常列字典未到位不渲染 | +| F-P12-06 | 明细行展开 | 依据全文、来源历史、行内素材缩略 | +| F-P12-07 | 素材卡展示 | 六行信息加采集来源列 | +| F-P12-08 | 素材播放 | 图片预览与视频播放 | +| F-P12-09 | 素材下载 | 单文件下载 | +| F-P12-10 | 摘要复制 | 复制任务摘要文本 | +| F-P12-11 | 留痕时间线 | 加识别键改动、来源变更、档案查询三类节点(identity_edit/source_change/vehicle.lookup) | +| F-P12-12 | 导出 PDF | 加子记录与送检结论两节 | +| F-P12-13 | 子记录区块 | 点位表格行可展开到该点位项列表;REGIONAL 才渲染 | +| F-P12-14 | 送检区块 | 四态、超期、回填入口(有送检回填权限才渲染) | +| F-P10-01 | 对象分类列表 | 左栏单节点也渲染;键盘上下键层内移动 | +| F-P10-02 | 检查项表格 | 加分组、建议来源、判定结构三列 | +| F-P10-03 | 展开行看全字段 | 加「为何在这一层」栏 | +| F-P10-04 | 导出 Excel | 文件名 {场景名}-检查项-{版本}.xlsx | +| F-P10-05 | 依据条款占位 | 空值显示 [待业务方指定条款] | +| F-P10-06 | 版本标识 | C-45 版本条含冻结时间与制定人 | +| F-P10-07 | 场景上下文 | 场景名徽标加面包屑加未启用灰标 | +| F-P10-08 | 冻结与历史版本 | 二次确认含在办单数;旧版只读 | +| F-P13-01 | 日志加载 | 服务端分页页长 50,时间倒序 | +| F-P13-02 | 操作人筛选 | 单选 | +| F-P13-03 | 对象类型筛选 | 检查记录/用户/角色/场景与模板 | +| F-P13-04 | 动作筛选 | 创建/修改/提交/导出/登录 | +| F-P13-05 | 时间范围 | 范围选择加快捷项 | +| F-P13-06 | 前后值展示 | 修改前灰修改后黑,空值 — | +| F-P13-07 | 长文本折叠 | 原因超 30 字折叠,Popover 全文 | + +## 6 Mock 数据一致性 + +七页共用 `reference/mock-data.md`。关键数字链: + +| 页 | 关键数据 | +| --- | --- | +| P21 | M01 已启用有模板 v20261026、授权 14 人、在办 2;M02 至 M04 已启用无模板;M05 未启用;M06 已启用无模板 | +| P11 | 汇总带 38 / 214 / — / 0 / 31 / 5 / 81.6% / 13.2%;列表首行 T20261103-0041 苏A12345 在办 | +| P12 | 演示单 T20261102-0033 市顺通机动车检测有限公司(M03 送检变体):送检 5 项,送检单位市环境监测中心,核验合格 1、核验不合格 1、已采样 2、待采样 1;检查项 7 已查 2 | +| P12 对照 | T20261102-0057 堆场扬尘(M04):5 点位完成 3,点位 -01 已查 4/5,第 4 项不适用原因已填 | +| P10 | M01 v20261026 冻结于 2026-10-26 15:40,7 项,在办 7 单用旧版;历史版本 v20260901 | +| P13 | 共 2841 条,含登录失败留痕一条(陈×× c-1007)、模板版本冻结一条 | + +P12 的超期 7 天为渲染验证用 mock(B-11),时限未定(V13-Q05)时超期列整列显示 `—`。P21 在办 2 与 P11 在办列表的数字不做跨页等式(分属不同演示时点),已在 P21 注明取数口径待定(W-08)。 + +## 7 状态覆盖 + +状态呈现两条入口:一是独立切换台 `prototypes/pages/p-states-platform.html`(manifest 登记 P-STATES,R5),左列按页分组列出 22 个状态,右侧 1440×900 框内嵌对应页面,支持 `?state=` 深链;二是各原型页浏览器单独打开时的右侧固定面板(底座内嵌时隐藏)。底座内嵌时页内面板不可用,切换台是平台状态的唯一入口——与手机端 P-STATES(R4)同一机制,平台此前缺这张画板,2026-11-04 补上。弹层与可点击触发的状态(P21 抽屉与停用被拒、P12 回填弹层、P10 冻结确认)同时可在主原型页内点击体验。 + +| 页 | 主态 | 可切换状态 | +| --- | --- | --- | +| P08 | 默认 | 登录中、登录失败、服务不可达(会话过期经 401 流程触发,不占画面) | +| P21 | 主态 | 口径抽屉(六行都可开,内容按行渲染)、停用被拒、停用二次确认(无在办场景)、无模板启用提示 | +| P11 | 主态(未选场景) | 单选场景(列头变车牌)、筛选无结果、加载失败 | +| P12 | 检查明细 | 素材、基本信息、操作留痕三 Tab;科室管理员视角(送检回填);回填弹层 | +| P12 对照 | — | 四帧画板:M04 子记录、素材六行卡、基本信息、留痕 | +| P10 | 主态 | 浏览历史版本(只读)、冻结确认 Modal | +| P13 | 主态 | 筛选无结果 | + +## 8 未闭合 + +| 编号 | 内容 | 本板块的落法 | +| --- | --- | --- | +| W-07 | 送检字段承载与报告附件存储 | 按 §3.4 七列落稿,字段名标 ⚠️,随 `05-data` 定 | +| W-08 | P21 在办单数取数口径 | 按「在办 + 待结论」计,接口字段标 ⚠️ | +| V13-Q05 | 送检时限 | 超期列整列 `—`,不编天数;P11 待结论不显示超期标 | +| V13-Q13 | 检查项与限值 | P10、P12 条号与限值全为示例,待客户确认替换 | +| V13-Q44 | 素材与日志保存期限 | 写「按执法档案长期保留」并标 [未取] | +| — | 「建议来源」语义(预期 vs 强制) | 按「预期」落稿;若实施要强制,文案改「限用来源」并在手机端拦截 | +| — | P21 → P09、P12 → P14 关系 | 均已随 07、08 板块交付补入 manifest(r21-09、r12-14) | diff --git a/07-accounts-and-grants.md b/07-accounts-and-grants.md new file mode 100644 index 0000000..9319401 --- /dev/null +++ b/07-accounts-and-grants.md @@ -0,0 +1,164 @@ +# 07 账号与授权 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-04 | +| 上游 | `prototype/v1.3-多场景模块化/02-pages/P09-账号与授权增量.md`、`prototype/02-pages/P09-账号与角色.md`(用户 Tab 继承)、`01-SPEC.md` §4 第 11 条 | +| 原型 | p09-grants | +| 功能点 | 11(全部在 P09) | +| 视口 | 1440×900 | +| 数据来源 | `reference/mock-data.md` §2 及其演示扩展行 | +| 状态 | G4 交付,待评审 | + +本板块没有自己的页面族:P09 一页承载全部 11 个功能点,其余端只写规则(手机准入拦截在 §5)。平台 72 个功能点里剩下的 11 个在此,54(06)+ 11(07)+ 7(08)= 72。 + +## 1 模型的整块替换 + +基线「三角色 + 8 个权限点」的勾选矩阵作废。多场景下「谁能用哪一类检查」和「能查到哪一级」是两个独立维度,勾选框表达不出来,所以不是加几个勾,是换模型: + +| 项 | 基线 | V1.3 | +| --- | --- | --- | +| 角色 | 3 个 | 5 个:执法员、中队负责人、科室管理员、平台管理员、只读;固定不可新增不可改名 | +| 动作 | 8 个权限点 | 11 个:2 个改名(`model.view`→`template.view`、`role.config`→`role.grant`)、3 个新增(`template.freeze`、`module.toggle`、`lab.fill`) | +| 粒度 | 人 × 权限点 | 人 × 场景 × 动作 × 范围 | +| 范围 | 无 | 三级:本人、本组织、全部 | +| 两层 | 无 | 角色模板(`role_grant`)+ 个人例外(`user_grant`,加授/撤授) | +| 一人多角色 | 不支持 | 支持:权限取并集、范围取最宽、个人撤授优先 | +| 生效时机 | 下次登录 | 即时生效 | + +角色固定五个是设计值,客户未表态可推翻(V13-Q37)。若客户要求自定义角色,模板层直接失去意义,等于回到一人一行,需另立需求——这不是改配置能吸收的变更,立项时要说清。 + +范围只留三级,「本辖区」删掉:一期没有辖区数据结构,摆出这个词就得回答辖区边界怎么算,答不了就先不给。 + +## 2 十一个动作 + +| 动作(名称 权限键) | 说明 | +| --- | --- | +| 任务查看 `record.view` | 列表与详情的可见范围 | +| 记录导出 `record.export` | P11 导出与 P12 导出 PDF | +| 记录修改 `record.edit` | 已提交单据的改值与标缺失 | +| 素材下载 `media.download` | 单文件下载 | +| 场景与模板查看 `template.view` | 只读,检查项名称与依据条号来自公开法典,全角色开放 | +| 模板冻结 `template.freeze` | P10 冻结新版本 | +| 场景启停 `module.toggle` | P21 开关列 | +| 送检回填 `lab.fill` | P12 回填入口 | +| 日志查看 `log.view` | P13 与 P12 留痕 Tab | +| 用户管理 `user.manage` | P09 用户 Tab | +| 授权配置 `role.grant` | P09 授权 Tab | + +`template.view` 全开且范围为全部:它不含素材与当事人信息,藏起来只会让现场问不出条款。 + +## 3 两层授权与判定顺序 + +判定式一条:**角色模板并集 ∪ 个人加授 − 个人撤授**。 + +1. 取此人全部角色的 `role_grant` 记录,按场景 × 动作取并集;范围冲突取最宽(本人 < 本组织 < 全部)。 +2. 叠加此人的 `user_grant` 加授记录(`effect=加授`),并入并集,范围同样取最宽。 +3. 最后套用 `user_grant` 撤授记录(`effect=撤授`):撤授直接移除该场景 × 动作,无视前两步。撤授优先是硬规则——「专项结束收回」必须真的收得回。 +4. 判定即时生效,下次请求即按新权限走;场景未启用时作业类授权不生效(查看类不受影响)。 + +个人例外在界面上必须标「优先」,并写明「个人撤授优先于角色并集」——不标,配的人会以为模板改了就能盖过例外。 + +## 4 P09 页面定义 + +一页两 Tab:用户管人,授权管矩阵。不拆页——配个人例外时必须先看这个人的角色模板,同页才看得见上下文。 + +### 4.1 两条进入路径 + +| 路径 | 表现 | +| --- | --- | +| 菜单进入 | 无上下文条,矩阵六行等权 | +| P21「配授权」带场景号 | 页头下方上下文条「正在配置场景:M04 堆场扬尘」;该场景行加 2px 主色左条与 `#E6F4FF` 行底;条右侧「查看全部场景」清掉上下文 | + +场景名取 `shortName`,不写 moduleId。其余行仍可编辑——用户常常是先配这一类、顺手看下一类,锁死整页等于逼他来回跳。 + +### 4.2 用户 Tab(F-P09-01 至 06) + +筛选三项(关键词 300ms 防抖、角色、状态)加重置;表格列:姓名、账号、角色(多值标签,超两个折叠「+N」)、组织、状态、最后登录、操作(编辑、重置密码、禁用开关)。新增与编辑走右侧抽屉:姓名、账号(编辑不可改)、角色多选、初始密码(自动生成可改,最少 8 位含字母数字)、状态。重置密码 Popconfirm 后生成一次性密码,Modal 显示并提示「仅显示一次」。禁用二次确认,即时失效。一期不做删除:留痕表引用用户,删除会断链。 + +### 4.3 授权 Tab(F-P09-07 至 11) + +上半是角色模板矩阵(C-44):顶部角色下拉(固定五个),矩阵六行场景 × 十一列动作,单元格是范围值(—/本人/本组织/全部),就地改、自动保存。下半是个人例外表:选人、场景、动作、类型(加授/撤授)、范围、说明,行标「优先」。 + +矩阵读法:单元格是该角色在此动作上的**数据范围**,从宽到窄为 全部 > 本组织 > 本人;「无」表示该角色没有此动作,与「本人」的区别是能不能干,与「本组织」的区别是能看多少。角色模板是底数,个人例外在其上加授/撤授(见下半张表)。 + +矩阵默认值(后端初始值,页面可改): + +| 动作 | 执法员(现场作业) | 中队负责人(中队管理) | 科室管理员(业务审核) | 平台管理员(系统运维) | 只读(法务复核) | +| --- | --- | --- | --- | --- | --- | +| 任务查看 `record.view` | 本人 | 本组织 | 本组织 | 全部 | 全部 | +| 记录导出 `record.export` | 无 | 本组织 | 本组织 | 全部 | 全部 | +| 记录修改 `record.edit` | 本人 | 本组织 | 无 | 全部 | 无 | +| 素材下载 `media.download` | 本人 | 本组织 | 本组织 | 全部 | 全部 | +| 场景与模板查看 `template.view` | 全部 | 全部 | 全部 | 全部 | 全部 | +| 模板冻结 `template.freeze` | 无 | 无 | 本组织 | 全部 | 无 | +| 场景启停 `module.toggle` | 无 | 无 | 无 | 全部 | 无 | +| 送检回填 `lab.fill` | 无 | 无 | 本组织 | 全部 | 无 | +| 日志查看 `log.view` | 无 | 本组织 | 本组织 | 全部 | 全部 | +| 用户管理 `user.manage` | 无 | 无 | 无 | 全部 | 无 | +| 授权配置 `role.grant` | 无 | 无 | 无 | 全部 | 无 | + +锁定格:平台管理员行的「授权配置」(`role.grant`)与「用户管理」(`user.manage`)两格置灰加锁,Tooltip「不可自撤,防自锁」。这是全系统唯一一处硬锁——给自己撤授权配置,平台就没有人能管授权了。 + +按角色读(每个角色实际能干什么): + +| 角色 | 一句话 | +| --- | --- | +| 执法员 | 查自己经手的任务、改自己的记录、下载自己任务的素材、看全部模板;不能导出,不能冻结模板,不能碰启停与授权 | +| 中队负责人 | 本中队的任务全可看、可改、可导出、可下载素材,能看日志;模板与授权不归他管 | +| 科室管理员 | 本科室范围的任务可看、可导出、可下载素材;能冻结模板、回填送检结论、看日志;不能改记录,不能启停场景,不能管用户与授权 | +| 平台管理员 | 全部数据、全部动作;唯一例外是「用户管理」「授权配置」两格锁定,不能自己撤自己 | +| 只读 | 全部任务可看、可导出、可下载素材、可看日志与模板;任何数据都不能改 | + +矩阵底部说明:「授权即时生效,下次请求即按新权限判定;场景未启用时作业类授权不生效。」 + +无「授权配置」权限(`role.grant`)登录:授权 Tab 整块不渲染,只剩用户 Tab;深链直进授权 Tab 则 403。 + +## 5 跨端规则 + +| 规则 | 内容 | +| --- | --- | +| 手机准入 | 只有执法员与中队负责人可登录手机端;其余三角色登录即整页拦截,提示「当前账号无现场作业权限」。理由:平台管理员能改授权,现场用高权账号作业是审计隐患 | +| 眼镜绑定 | 眼镜跟随手机账号,无独立账号体系;手机被拦截的角色,眼镜同样不可用 | +| 即时生效 | 授权、禁用、启停全部即时;P08 会话不缓存权限快照 | +| 撤授后果 | 撤掉某人全部场景的「任务查看」(`record.view`):手机主页出空态而非报错——他可能只是今天没被授权某类 | +| 无权限渲染 | 各页按动作裁剪:无「记录导出」(`record.export`)导出按钮不渲染;无「场景与模板查看」(`template.view`)P10 整页 403;无「授权配置」(`role.grant`)P21 授权列不出现 | + +## 6 功能点清单 + +| 编号 | 功能 | 验收 | +| --- | --- | --- | +| F-P09-01 | 用户列表加载 | 服务端分页页长 20;角色列多值全显 | +| F-P09-02 | 筛选 | 关键词 300ms 防抖;角色选项为固定五角色 | +| F-P09-03 | 新增用户 | 抽屉表单;角色多选不设上限;账号重复字段级报错 | +| F-P09-04 | 编辑用户 | 账号不可改;密码留空表示不改 | +| F-P09-05 | 禁用/启用 | 二次确认,即时失效;当前登录人自身开关禁用 | +| F-P09-06 | 重置密码 | 一次性密码仅显示一次 | +| F-P09-07 | 角色切换 | 顶部下拉五角色,矩阵随之刷新 | +| F-P09-08 | 授权矩阵 | C-44 六行 × 十一列,单元格就地改自动保存;保存失败回滚 | +| F-P09-09 | 权限提示 | 即时生效加场景未启用不生效两句,常显 | +| F-P09-10 | 个人例外 | 加授/撤授两段,`effect` 只用中文;行标「优先」 | +| F-P09-11 | 锁定格 | 平台管理员两格置灰加锁不可改 | + +## 7 Mock 数据一致性 + +用户表示例取 `reference/mock-data.md` §2 并加两条演示扩展(周××一人多角色、孙××已禁用),已登记。授权 Tab 演示执法员模板:「任务查看」(record.view)本人、「场景与模板查看」(template.view)全部、其余「无」,与 §4.3 默认矩阵的执法员列一致;M05 行灰标「未启用」。个人例外两行:周×× M04 加授全部(对应 P13 日志「堆场扬尘专项检查临时扩权」的时间线)、张×× M05 撤授。P21 已授权人数(M01 14 人)与用户表行数不做等式——表是全量用户的分页视图,含非授权场景人员,两处口径不同,不互相校对。 + +## 8 状态覆盖 + +| 态 | 内容 | +| --- | --- | +| 用户 Tab(主态) | 筛选加表格七行,含多角色与已禁用示例 | +| 授权 Tab | 角色可切五模板(矩阵按角色重渲染),单元格点击循环范围并自动保存;个人例外可撤销 | +| 场景上下文 | 上下文条加 M04 行高亮(P21 配授权进入的表现) | +| 无授权配置权限 | 授权 Tab 整块不渲染 | + +弹层交互全部做实(页内直接点击体验,不占状态画板):新增/编辑用户为右侧抽屉(角色多选、密码重新生成、账号重复字段级报错);重置密码两步确认后展示一次性密码(仅显示一次);禁用/启用走二次确认且行状态真实切换;平台管理员两格锁定格置灰加锁带 Tooltip。锁定格保存中、403 属过程态不铺画面。 + +## 9 未闭合 + +| 编号 | 内容 | 本板块的落法 | +| --- | --- | --- | +| V13-Q37 | 五角色与一人多角色 | 按设计值落稿,客户可推翻;推翻即另立需求 | +| — | 「本组织」边界(中队 or 科室) | 由用户表组织字段决定,界面统一显示「本组织」 | +| — | P12 → P14 关系 | 已随 08 板块交付补入 manifest(r12-14) | diff --git a/08-law-qa.md b/08-law-qa.md new file mode 100644 index 0000000..acd2de1 --- /dev/null +++ b/08-law-qa.md @@ -0,0 +1,115 @@ +# 08 法规问答与 AI 能力 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-04 | +| 上游 | `prototype/02-pages/P05-智能问答.md`、`prototype/02-pages/P14-法规问答.md`(两页 v1.3 零改动复用)、`01-SPEC.md` §3 功能点分配、`04-components.md` C-11/C-12 | +| 原型 | p05-qa(手机 375×812)、p14-qa(平台 1440×900) | +| 功能点 | 16(P05 9、P14 7) | +| 数据来源 | `reference/mock-data.md`,答案示例取分片数据契约 | +| 状态 | G4 交付,待评审 | + +平台 72 个功能点的最后 7 个在此:54(06)+ 11(07)+ 7(08)= 72。至此三端 205 个功能点全部分板块落稿(04 眼镜 43、05 手机 81、08 手机 9、01–03 基础分析不计点)。 + +## 1 端的定位:问答是独立工具 + +问答不挂检查记录、不进明细、不进导出。手机端会话不落库,关闭即清;平台端只落检索日志(六字段,无任务号),日志不在任何界面呈现。它不知道任何一辆车——记了任务号就能反推记录内容,一期不做。 + +验收标准不是「答得对」,是「答案能追到条款号」:带不出条款号的答案按失败渲染,整体替换为兜底卡。渲染层做一次正则兜底:答案文本不含「第N条 / §N / 表N」时强制替换,即使模型声称给出了答案。「可能是」「一般来说」「根据相关规定」不允许出现。 + +AI 能力的边界:一期只有确定性检索加固定兜底,问答不做生成式自由发挥(`ai-service` 同口径);语音指令解析与唤醒词属眼镜端(04 板块),本板块只承载问句的检索与呈现。 + +## 2 两页一览 + +| 页面 | 路由 | 一句话 | 入口 | 出口 | 功能点 | +| --- | --- | --- | --- | --- | --- | +| P05 智能问答 | `/qa?from=&itemId=` | 现场问一句,拿到能追到条款的答案,或明确的「检索不到」 | P19 底部入口(from=home);P03(from=task);P04(from=item);眼镜语音(from=voice) | 按 from 返回 | 9 | +| P14 法规问答 | `/qa?q=` | 问一句拿到条款;查不到给明确兜底;检索日志落库 | 菜单第 2 项;P12 明细依据链接(新标签) | 无 | 7 | + +P05 路由参数 v1.3 对齐手机端实际入口:from 取 home/task/item/voice(基线的 idle/task/rule/voice 作废,P01 待机入口已随 P01 瘦身移除)。 + +## 3 P05 智能问答(手机) + +条款卡(C-11)五段自上而下:结论句(≤40 字)、出处(法规全称加条款号,主色可点)、原文摘录(引号包裹,最多 5 行超出展开)、页脚(语料版本、检索时间、复制条款)、边界声明「本回答仅提供法规依据,不构成违法认定」。语料版本两处都放:NavBar 短版本日期、答案页脚完整版本。 + +兜底卡唯一文案,两端同一套: + +``` +未检索到直接依据,本条请人工查询对应法规原文。 +可尝试:1、核对检查项名称是否与法规用语一致 2、换一个更具体的问法 +``` + +追问一期不做,但预期管理做在入口:空态与输入区各有一行「每次提问独立检索,请把对象和情形说全」,堵住「系统应该记得上文」的误判——用户问完汽油车限值接一句「柴油车呢」,检索必然兜底,没有这行文案,他会得出「系统笨」的结论然后弃用。 + +追问能力预留二期,分两步走:过渡态是答案卡下的预设追问按钮(命中条款后给同族条款的完整问法,点击发全文,不带上下文,纯检索增强);目标是多轮上下文(指代消解,需生成式改写)。两步都依赖语料按族分组与 V13-Q13 的条款确认,且多轮要过「不落库、不反推记录」这条边界——会话状态只在内存、日志仍只记改写后的完整问法。一期不铺任何中间结构。不落库:不写任务号、不写问答表、不追加问答留痕。 + +语音提问长按说话松手发送,转写文本先回填输入框 1 秒供确认;转写失败提示「没听清,请再说一次」,不发起检索。问题超 200 字发送前截断并提示。 + +网络异常时输入框与发送 disabled,ErrorBlock「当前无网络,问答暂不可用」,不给重试按钮——重试要等到有网,点了也没用。 + +## 4 P14 法规问答(平台) + +平台侧是工作台,不是问答记录列表。R1 页头带语料版本;R2 会话区最大宽 760 居中;R3 右栏本机会话最多 10 条(超出挤掉最旧,点击回填输入框不自动发送,只存浏览器内存刷新即清);R4 输入区吸底。 + +从 P12 明细行展开的条款链接进入时带 `q=` 预填并直接检索,页顶一行灰字「由任务 T20261102-0033 的检查项带入」,仅作提示不写库;来源记录已删除时提示改「来源记录已不可访问」,问题照常检索。 + +检索日志六字段落库:问题(200 字截断)、命中条款(兜底时为空)、是否兜底、语料版本、时间(到秒)、操作人。不存任务号、不存 IP、不存设备号、不存答案全文;保留 6 个月,超期只留月度问题数与兜底率。同一条问题连问两次不做缓存各落一条——缓存会让兜底率统计失真。页头不放「今日提问数」(推断:运营指标放出来会让使用者以为在被考核,待现场验证)。 + +## 5 跨页规则 + +| 规则 | 内容 | +| --- | --- | +| 同一套卡与兜底 | C-11 条款卡与兜底文案两端同源,不允许两套说法 | +| 无任务号 | 两页都不写任务号;P12 带入只在平台侧留一行页顶提示 | +| 依据即法典条号 | 答案出处与 P10 模板依据同源(层号加条款号),旧法条款号不得出现 | +| 眼镜语音回显 | 眼镜上只回结论与条款号,原文摘录在手机(04 板块已定) | +| 无权限 | 无「场景与模板查看」权限(`template.view`)时 P14 整页 403 且菜单项不渲染;手机端无此门槛(已登录即可用) | + +## 6 功能点清单 + +P05 基线 10 条,其中「入口预填」并入「按入口返回」(同一条 `from` 判定逻辑),计 9,与 `01-SPEC` §3 一致。 + +| 编号 | 功能 | 验收 | +| --- | --- | --- | +| F-P05-01 | 文字提问 | 非空可发、回车即发、发送后清空 | +| F-P05-02 | 语音提问 | 长按说话;转写先回填 1 秒;失败提示不检索 | +| F-P05-03 | 检索中 | 三点跳动加「检索法规语料」(检索 0–8 秒为设计值,见 09 §6.3,不作本功能点验收判据) | +| F-P05-04 | 正常答案 | 渲染 C-11 五段 | +| F-P05-05 | 兜底答案 | 固定话术整体替换,含「换个问法」次按钮 | +| F-P05-06 | 复制条款 | 复制法规全称加条款号加原文摘录 | +| F-P05-07 | 示例问题 | 空态 3 条,点击即发 | +| F-P05-08 | 不落库 | 不写任务号与问答表,关闭即清 | +| F-P05-09 | 按入口返回与预填 | 按 from 判定返回页;从 P04 进入预填「{项名} 的判定依据是什么」并置顶条款号 | +| F-P14-01 | 文字提问 | 同 P05,宽屏版 | +| F-P14-02 | 答案卡渲染 | 五段结构同源 | +| F-P14-03 | 兜底卡 | 与手机同一套文案 | +| F-P14-04 | 复制条款 | message「已复制条款」 | +| F-P14-05 | 本机会话栏 | 最多 10 条,回填不重发,刷新即清 | +| F-P14-06 | 检索日志落库 | 六字段,无任务号,界面不呈现 | +| F-P14-07 | 从记录带入问题 | 带 q 预填直接检索,页顶灰字提示 | + +## 7 Mock 数据一致性 + +两端答案示例同一条:问「排气烟度超过林格曼 1 级怎么判定」,结论「林格曼黑度超过 1 级即不符合排放要求」,出处 GB 3847-2018 · 表 2、§8.2.2,摘录「排放有明显可见烟度,或烟度值超过林格曼 1 级」,语料 2026-09-30 · 截止 2026-09-01。兜底示例问「货车加装副油箱怎么认定」。法条名称与条号为示例,随 V13-Q13 客户确认后全量替换。 + +## 8 状态覆盖 + +P05 五态、P14 六态分别进入两个状态画板:手机 P-STATES(R4)补 P05 组,平台 P-STATES(R5)补 P14 组。主态可交互(提问真实走检索动线,演示返回示例答案),弹层与过程态在页内体验,独立切换台承载条件态。 + +| 页 | 主态 | 可切换状态 | +| --- | --- | --- | +| P05 | 空态(示例可点、可真实提问) | 检索中、正常答案、兜底卡、检索失败 | +| P14 | 空态(同上) | 检索中、正常答案、兜底卡、检索失败、由记录带入 | + +语音转写中、转写失败、超 12 秒慢检索、无网络属过程态,在注释与面板说明中标注去向。 + +## 9 未闭合 + +| 编号 | 内容 | 本板块的落法 | +| --- | --- | --- | +| V13-Q13 | 条款号与原文 | 全部为示例,客户确认后替换,不改结构 | +| — | 语音转写位置(手机端 or 眼镜端) | 按手机端转写设计;若眼镜只传音频需增音频耗时与失败态 | +| — | 右栏本机会话是否保留 | 按基线保留;试用后无人用则砍掉只留单栏会话 | +| — | 日志是否记 ruleId | 当前不记(记了能反推记录);语料运营需要时只记 ruleId 不记任务号,业务方定 | +| — | 检索日志保留期限 | 6 个月出明细、留月度汇总;V13-Q44 执法档案口径确认后对齐 | +| 二期 | 追问:预设追问按钮(过渡)→ 多轮上下文(目标) | 一期不做、不留中间结构;空态与输入区放预期管理文案。依赖语料按族分组(V13-Q13)与生成式改写评估;多轮必须守住不落库边界,日志只记完整问法 | diff --git a/09-global-and-acceptance.md b/09-global-and-acceptance.md new file mode 100644 index 0000000..e6ee8c4 --- /dev/null +++ b/09-global-and-acceptance.md @@ -0,0 +1,139 @@ +# 09 全局约束与验收收口 + +| 项目 | 内容 | +| --- | --- | +| 版本 | v1.3,2026-11-04 | +| 上游 | `prototype/v1.3-多场景模块化/01-SPEC.md` §4 全局约束与 §6 决策记录、`shaping/v1.3-多场景模块化/03-scope.md` 成功指标与范围纪律、各板块未闭合表 | +| 原型 | 无(复用各板块原型与 P-STATES 手机/平台两张状态画板) | +| 状态 | G5 交付,待终审 | + +本板块不重复各板块已写的规则:每条全局规则给落点,每项验收给判据,每项未闭合给阻塞面与去向。 + +## 1 全局硬规则与落点 + +基线八条继续有效,其中第 1、6 条由 v1.3 第 13 条分层执行(基线条文不改)。逐条落点如下,任何一条在对应页面不成立即验收不通过: + +| # | 规则 | 落点 | +| --- | --- | --- | +| 1 | 不做底部 Tab、不做多级菜单 | P19 R8 只放两个行内入口,不带选中态;平台菜单六项一层 | +| 2 | 眼镜可判不可选 | P16 至 P24:能起单判定录入提交,唯一场景切换入口在 P19 | +| 3 | 两路提交先进为准 | P06 与 P24:后到一路提示「本单已提交」,不产生第二条记录 | +| 4 | 场景卡三态数据驱动 | P19 读授权、启用、冻结模板三条件,禁止按 moduleId 写分支 | +| 5 | 每个值带来源 | P04 采集、P17 判定、P12 明细列:识别/语音/手输/转抄四类,缺失标黄 | +| 6 | 不适用必填原因 | P04 弹层内拦一次,P06 与 P24 列阻断,服务端再拦一次;P11 汇总带 NA 无原因数恒 0 | +| 7 | 断连可判定不可提交 | P17 推进入队标未同步,说提交播「请先连上手机」 | +| 8 | 空模板拒绝起单 | P16 拒绝并提示联系管理员;P21 启用只提示不拦截 | +| 9 | 两层状态不合并 | 任务生命周期五态与判定结构内部状态分建模;P11 统计、P12 渲染分别取数 | +| 10 | 场景名只作数据值 | 卡片标题、徽标、列值可用;页面名、路由、字段名、事件名一律不用 | +| 11 | 手机端准入 | 仅执法员与中队负责人可登录;其余三角色整页拦截(07 §5) | +| 12 | 眼镜不渲染加载态 | P16 至 P24 无骨架、无进度条、无 loading;刷新 ≤2 秒不可感知 | +| 13 | 判定词两族 | 检查项「符合/不符合/不适用」,送检「核验合格/核验不合格」必带出具机构;语音同义双收留痕原始话语 | + +## 2 术语与禁用词 + +| 类别 | 规定 | +| --- | --- | +| 检查项词族 | 符合/不符合/不适用;主体是执法员;「合格/不合格」只作语音同义词收入,界面与留痕存原始话语、判定值用规范词 | +| 送检词族 | 待采样/已采样/核验合格/核验不合格;主体是检验机构;任何位置必须带出具机构 | +| 全句禁用 | 「超标」「违法」「应当处罚」:系统不作违法认定、不判等级 | +| 组合禁用 | 「合格/不合格」不得单独出现在检查项判定值域;「核验合格」不得出现在检查项判定 | +| 停用词 | 「镜像」(改称清单屏);报告、文书、页面文案不得出现内部结构名(L1–L4、TRISTATE 等,对应指标「结构名隔离」) | +| 对外口径 | 「移动执法」「多场景/模块化」「智能眼镜/AI 眼镜」「监管平台」不进对外材料;产品名「生态环境现场检查智能辅助系统」,简称「现场检查助手」 | + +## 3 数据结构硬规则 + +| 规则 | 内容 | 违反后果 | +| --- | --- | --- | +| 状态两层 | 生命周期五态(在办/待结论/已结案/已结论/已移送)与判定结构内部状态(三态、送检四态、区域两态、事件四态)分开建模 | 统计与结案口径同时错 | +| 来源四类 | 识别/语音/手输/转抄;前三类进 P20 待复核,手输不进;人工改写转手输并记改前来源,改回原值仍记手输 | 复核分不清看过与改过 | +| 模板版本锁定 | 起单锁版本,P10 改模板不改历史单据,P12 按锁定版本校验并提示最新版差异 | 上午起单、中午改模板、下午提交被拒 | +| 识别键双存 | 识别原值与人工录入值双存,改动走 `identity_edit` 留痕 | 复核答不出「系统当时识别成什么」 | +| 点位两列 | 点位编号与描述分两列存显 | 改一次命名规则断一次账 | + +## 4 异常与降级 + +| 情形 | 行为 | 落点 | +| --- | --- | --- | +| 眼镜断连 | 推进入队、该行标未同步、不可提交;补传时逐条消失 | P17、P18 | +| 手机断网 | 可浏览已加载内容;提交直接失败提示,不进提交中态 | P06 | +| 问答断网 | 输入与发送禁用,「当前无网络,问答暂不可用」,无重试按钮 | P05、P14 | +| 重复提交 | 两路先进为准;进入已提交单转回执并提示 | P06、P24 | +| 场景停用 | 在办单可继续填报与提交,新单不可起;详情正常查看 | P03、P04、P21 | +| 送检超期 | 时限未由客户给出(V13-Q05)时超期列显示 `—`,不编天数 | P11、P12 | +| 素材缺失 | 删除只标缺失不物理删;缺失走弹层填原因 | P04、P06 | +| 检索失败 | 兜底卡唯一文案,或「检索服务暂时不可用」可重试;渲染层正则兜底 | P05、P14 | + +## 5 非功能要求 + +| 项 | 要求 | +| --- | --- | +| 部署 | 单局独立部署,数据不上云;代码托管内网 Gitea | +| 留痕 | 操作留痕与日志只追加,不可修改删除;不记来源 IP(D-07) | +| 水印 | 平台数据页全局水印,含账号后四位 | +| 性能 | 眼镜刷新 ≤2 秒无感知;问答检索 0–8 秒、12 秒给慢提示;手机列表每页 20 条、平台日志 50 条 | +| 期限 | 素材与日志「按执法档案长期保留」标注 [未取](V13-Q44),检索日志 6 个月出明细留月度汇总 | +| 安全 | token 不进 localStorage;密码重置一次性仅显示一次;无 `template.view` 深链 403 | + +## 6 验收 + +### 6.1 功能验收 + +205 个功能点全量进一期验收,按板块对账:04 眼镜 43、05 手机 81、06 平台 54、07 授权 11、08 问答 16(手机 9 + 平台 7)。每个功能点带验收列(见各板块 §功能点清单),逐条可执行。三条口径注意: + +1. M02 至 M06 一期不进场景功能验收,不计入场景类指标分母;M02 例外,只验「骨架接入零代码」指标,不验场景功能。 +2. P15 语音指令配置按场景扩行不在一期功能点口径内,随平台菜单交付但单独验收;P15 规格沿用 `prd/v1.1-指令配置管理/`(历史单文件 PRD,保留不改),本目录九板块不重复。 +3. 一期只承诺「结构可扩展」,不承诺「客户自助配场景」:模板由实施导入,配场景仍需工程介入。 + +### 6.2 指标验收 + +| 指标 | 定义 | 目标 | 判定方式 | +| --- | --- | --- | --- | +| 骨架接入零代码 | 用 M02 走完接入,三端业务代码改动行数(不含契约、迁移脚本、模板数据、AI 词表) | 0 行 | `git diff --stat` 按范围取数 | +| 骨架纸面完备 | 只看契约文档重填 M03 全部检查项(条数待客户给,V13-Q13) | 全部填得出且不新增字段 | 双人独立填写比对 | +| 分模块统计对账 | 构造 20 条记录跑统计 | 六个量与手工期望逐格相等 | 工具加人工 | +| 挂起结案分离 | 有项等送检的单据计入结案数 | 0 | 统计 SQL | +| 结构名隔离 | 报告、文书、页面文案出现内部结构名 | 0 次 | grep | +| 录入来源可追 | 抽查 20 条语音录入,来源齐全且进过待复核 | 20/20 | 平台明细 | +| 语音提交成功率 | 不看屏完成语音提交的单数占比 | [未取,待现场实测] | 试运行台账 | + +前三条是「模块化」主张能否成立的证据,不达标即产品上没有兑现;第七条是观测项,不作一期验收判据。 + +### 6.3 不作验收判据的项 + +| 项 | 原因 | +| --- | --- | +| 登录态 8 小时、启动超时 5 秒、离线缓存 7 天 | 设计值,客户未表态 | +| 眼镜判定 1 秒屏面反馈、问答检索 0–8 秒与 12 秒慢提示 | 设计值(03 §7、09 §5),不作验收判据 | +| P20 批量确认条数上限、P06 S4 催办 | 设计值 | +| V13-Q 各未定项(见 §8) | 输入未到,按设计值落稿 | +| mock 数据(B-11 超期 7 天等) | 渲染验证用,非真实时限 | + +### 6.4 交付前置条件 + +M01 检查项依据必须先过客户确认,否则 M01 也不能算交付完成(03-scope 范围纪律)。 + +## 7 未闭合清单(谁取、阻塞什么) + +| 编号 | 内容 | 阻塞什么 | 谁取 | +| --- | --- | --- | --- | +| V13-Q13 | M01 至 M03 检查项与限值 | P10/P12 条号示例替换;指标「骨架纸面完备」执行;二期追问的语料分组 | 客户业务方 | +| V13-Q05 | 送检时限 | P11 超期红标、P12 超期列;未给前一律显示 `—` | 客户业务方 | +| V13-Q25/Q43 | 眼镜实机分辨率、单色或彩色、刷新率 | 眼镜六屏令牌复核(实机复核后只换 `gl-*` 令牌不改结构) | 设备供应商 | +| V13-Q28 | 主页眼镜信息字段集合 | P19 R5 四项(连接态、路径、电量、固件),标可删一行 | 现场试用后定 | +| V13-Q44 | 素材与日志保存期限 | §5 期限条 [未取] | 客户档案与运维 | +| V13-Q45 | 车辆档案正式数据源 | P02 档案卡一期本地 mock,正式对接另立接口条目 | 客户信息中心 | +| W-07 | 送检字段承载与报告附件存储 | P12 送检区块七列的字段名 | 客户业务方 | +| W-08 | P21 在办单数取数口径 | 停用被拒文案的数字 | 平台侧定接口口径 | +| 二期 | 问答追问(预设按钮 → 多轮) | 一期无中间结构 | 语料分组后启动 | + +## 8 G5 收口记录 + +| 检查项 | 结果 | +| --- | --- | +| manifest 校验 | 32 模块 / 28 页 / 37 关系,validate 通过 | +| 功能点对账 | 43 + 81 + 9 + 54 + 11 + 7 = 205,与 `01-SPEC` §3 一致 | +| 画布 | 28 张卡片不重叠、间距达标,关系 37 条与页内 data-nav 一致 | +| 词族 | 检查项与送检两族分立;禁用词全量 grep 仅命中三类合规位置:边界声明「不构成违法认定」、禁用条款自身、prd/01 对外部执法流程与否定式边界的描述,无一处作系统判定值 | +| 裸英文键 | 评审可见文本已中文名前置、键名括注(2026-11-04 整改) | +| 00 计划模块 | 已置 hidden,文件与历史保留,终审后不在底座目录出现 | +| 历史版本 | `prd/v1.1-指令配置管理`、`prd/v1.2-语义意图路由` 保留不改;`shaping/` 根目录 v1.2 基线在底座 S1–S7 隐藏展示 | diff --git a/README.md b/README.md new file mode 100644 index 0000000..0ccdae4 --- /dev/null +++ b/README.md @@ -0,0 +1,28 @@ +# 生态环境现场检查智能辅助系统 v1.3 PRD + +一期标段:一期(路检路查场景)。版本 v1.3,2026-11-04 收口(产品状态 confirmed)。 + +## 阅读顺序 + +| 顺序 | 文档 | 内容 | +| --- | --- | --- | +| 0 | [00-plan](/wudh/lujianlucha-prd/src/branch/main/00-plan.md) | 板块拆分、交付门禁、审核标准、未闭合项约定(过程文档) | +| 1 | [01-product-definition](/wudh/lujianlucha-prd/src/branch/main/01-product-definition.md) | 产品定义、定名、四缺口、六场景与四种判定结构、成功指标 | +| 2 | [02-users-and-needs](/wudh/lujianlucha-prd/src/branch/main/02-users-and-needs.md) | 八类用户、岗位与端、JTBD、需求清单 R01–R24 | +| 3 | [03-user-stories-and-journey](/wudh/lujianlucha-prd/src/branch/main/03-user-stories-and-journey.md) | 三端主旅程、26 条用户故事与验收条件、时间参数 | +| 4 | [04-glasses-field](/wudh/lujianlucha-prd/src/branch/main/04-glasses-field.md) | 眼镜端六屏、语音词表、43 功能点、断连与降级 | +| 5 | [05-mobile-field](/wudh/lujianlucha-prd/src/branch/main/05-mobile-field.md) | 手机端八页、主页高度账、81 功能点、状态覆盖 | +| 6 | [06-platform-records](/wudh/lujianlucha-prd/src/branch/main/06-platform-records.md) | 平台端七页、场景口径与模板冻结、统计八量、54 功能点 | +| 7 | [07-accounts-and-grants](/wudh/lujianlucha-prd/src/branch/main/07-accounts-and-grants.md) | 五角色十一动作、两层授权判定式、P09 页面、11 功能点 | +| 8 | [08-law-qa](/wudh/lujianlucha-prd/src/branch/main/08-law-qa.md) | 法规问答、条款号与兜底、检索日志边界、16 功能点 | +| 9 | [09-global-and-acceptance](/wudh/lujianlucha-prd/src/branch/main/09-global-and-acceptance.md) | 13 条全局硬规则、术语禁用词、验收指标与未闭合清单(先读 §1、§2) | + +## 三条先行的口径 + +1. 判定词两族:检查项用「符合/不符合/不适用」(执法员给),送检用「待采样/已采样/核验合格/核验不合格」并带出具机构(检验机构给);「超标」「违法」「应当处罚」全句禁用,系统不作违法认定。 +2. 功能点对账:眼镜 43 + 手机 90(81 归 05、9 归 08)+ 平台 72(54 归 06、11 归 07、7 归 08)= 205,全部进一期验收。 +3. 场景深度:六个场景只详填 M01(路检路查),M02–M06 一期只建壳占位;模板由实施导入,不承诺客户自助配场景。 + +## 与代码库的关系 + +本仓库只发布 PRD 正文。交互原型(HTML)、原型注释、上游定型稿在私有仓库 `lujianlucha`,需要时向管理员申请访问。