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 为准。
|
||||
@@ -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 现状作业方式与痛点 | 其余场景的清单与话术 |
|
||||
@@ -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 只显示同对象同日已有记录 |
|
||||
| 眼镜发起切场景请求 | 一期不做。眼镜上唯一能做的是播报当前场景与复用上次场景;一个点了没反应的请求横幅会被现场当成故障,且它要求在眼镜侧维护「请求中、被忽略、被拒绝」三个状态,没有验收资源 | 场景切换走手机主页卡片;等厂商词表能力书面确认后,连请求带本地切换一起进二期 |
|
||||
| 完整离线作业 | 只做提交队列,不做本地全量副本 | 断连可判定,提交等恢复链路 |
|
||||
| 电子签名签章 | 客户未提出,场景是否要签未定 | 编码化留痕加复核清单 |
|
||||
| 客户自助配场景 | 一期只承诺结构可扩展 | 实施导入模板 |
|
||||
| 个人绩效统计 | 数据可用于复核,不能直接当考核 | 结案数与待办积压只到组织级 |
|
||||
@@ -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 实装时不改表也不改页面。
|
||||
|
||||
验收以故事为最小单元,每个故事至少一条可复现的判定动作。不可判定的表述(系统应友好提示、体验流畅)不进验收表。
|
||||
@@ -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 秒,不做翻页。
|
||||
@@ -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,正式对接另立接口条目 |
|
||||
@@ -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) |
|
||||
@@ -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) |
|
||||
+115
@@ -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)与生成式改写评估;多轮必须守住不落库边界,日志只记完整问法 |
|
||||
@@ -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 隐藏展示 |
|
||||
@@ -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`,需要时向管理员申请访问。
|
||||
Reference in new issue
Block a user