Files
lujianlucha-prd/06-platform-records.md
T

201 lines
17 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 交付,已确认(confirmed) |
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) |