Files
lujianlucha-prd/09-global-and-acceptance.md

10 KiB
Raw Permalink Blame History

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 隐藏展示