docs: 发布 v1.3 PRD 全文(00-09,2026-11-04 收口版)

This commit is contained in:
wudh committed 2026-11-04 13:49:03 +08:00
commit 7559a9aa61
11 files changed
+1805

No files matched your search

+200
View File
@@ -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) |