# 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)。每个功能点带验收列(见各板块 §功能点清单),逐条可执行。三条口径注意: 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 隐藏展示 |