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

17 KiB
Raw Blame History

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)