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

140 lines
10 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.
# 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 隐藏展示 |