09 全局约束与验收收口
| 项目 |
内容 |
| 版本 |
v1.3,2026-11-04 |
| 上游 |
prototype/v1.3-多场景模块化/01-SPEC.md §4 全局约束与 §6 决策记录、shaping/v1.3-多场景模块化/03-scope.md 成功指标与范围纪律、各板块未闭合表 |
| 原型 |
无(复用各板块原型与 P-STATES 手机/平台两张状态画板) |
| 状态 |
G5 收口,终审通过(confirmed) |
本板块不重复各板块已写的规则:每条全局规则给落点,每项验收给判据,每项未闭合给阻塞面与去向。
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)。每个功能点带验收列(见各板块 §功能点清单),逐条可执行。三条口径注意:
- M02 至 M06 一期不进场景功能验收,不计入场景类指标分母;M02 例外,只验「骨架接入零代码」指标,不验场景功能。
- P15 语音指令配置按场景扩行不在一期功能点口径内,随平台菜单交付但单独验收;P15 规格沿用
prd/v1.1-指令配置管理/(历史单文件 PRD,保留不改),本目录九板块不重复。
- 一期只承诺「结构可扩展」,不承诺「客户自助配场景」:模板由实施导入,配场景仍需工程介入。
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 隐藏展示 |