DoD 验收清单(Definition of Done Checklist)
关联工单:#90 [M5] DoD 验收清单逐条核对
父 Issue:#15 [M5] 文档与验收(DoD 核查 + UAT 支撑)
里程碑:iAOP v1.0 · Template-Ti 一期
验收依据:《产品设计文档_iAOP.md》§9 NFR 指标 + §10 验收标准(Definition of Done)
1. 目的与用法
本文档把《产品设计文档_iAOP.md》§9(非功能性需求 NFR)、§10(验收标准 Definition of Done)
及 §7.7(一期交付物清单与验收节点)中可量化、可核对的验收项,逐条拆成勾选式清单,
供 M4 内部集成测试 → M5 客户 UAT → 上线 → 1 个月质保观察 闭环逐条核对。
状态口径:
| 状态 |
含义 |
| ☐ 未开始 |
模块/功能尚未达到可验收状态 |
| ◐ 待验证 |
已实现,待 M4 集成测试 / NFR 压测 / 客户 UAT 验证 |
| ✅ 通过 |
已按指标实测达标,附验证证据(脚本输出 / 截图 / 报告) |
| ⛔ 阻塞 |
因依赖(标注数据 / 客户配合 / 环境)暂不达标,已登记风险 |
核对流程(对齐 PRD §10 验收流程):
自测(bot_dev)→ 内部评审(bot_pm + bot_po)→ 客户 UAT(王主任 / 李工确认)→ 上线 → 1 个月质保观察期 → 闭环。
2. iAOP-Core 内核验收(§10 内核 + §9 NFR)
2.1 ① 边缘采集网关(edge-gateway)
| 编号 |
验收项 |
目标指标(首厂验收口径) |
状态 |
验证证据 |
| C-01 |
600 点位 1Hz 采集 P99 延迟 |
P99 ≤ 1.8s |
◐ |
core/data-bus/scripts/bench_write.py 压测输出 |
| C-02 |
断点续传丢失率 |
≤ 0.02% |
◐ |
core/edge-gateway/scripts/verify_resilience.py |
| C-03 |
采集网只读隔离 |
零控制指令下发 |
◐ |
docs/采集网只读隔离与网闸配置.md |
| C-04 |
采集配置外置(点位/采样率/协议参数化) |
去硬编码,换点位只改 CSV |
◐ |
core/edge-gateway/config/point_dict.example.csv |
| C-05 |
DCS 点位字典导入校验 |
校验通过、表头与内核 schema 一致 |
◐ |
docs/_check_dcs_template.py |
| C-06 |
LIMS 质检接口字段对齐 |
字段清单覆盖关键质检项 |
◐ |
docs/LIMS质检接口字段清单.md |
2.2 ② 数据总线(data-bus)
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| C-07 |
批量写入吞吐 |
P99 ≤ 1.8s(与 C-01 同口径) |
◐ |
batch_writer.py + bench_write.py |
| C-08 |
Kafka topic 命名/分区模板化 |
按模板+点位维度,去硬编码 |
◐ |
core/data-bus/kafka_naming.py |
| C-09 |
PostgreSQL 关系表 schema |
模板/模型/用户/权限齐备 |
◐ |
postgres_schema.py |
| C-10 |
数据保留/归档/降采样策略 |
可配置,与 TDengine schema 对齐 |
◐ |
retention_policy.py |
| C-11 |
TDengine 时序 schema |
模板化、降采样配置化 |
◐ |
tdengine_schema.py |
2.3 ③ AI 模型框架(model-framework,RISK 配置化重构)
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| C-12 |
模型框架配置化重构 |
切换行业模板零改码 |
◐ |
core/model-framework(feature/issue-5..42 分支) |
| C-13 |
同一框架切换行业模板运行新模型 |
仅改配置即可 |
◐ |
feature/issue-42 端到端 PoC |
| C-14 |
新增行业不新增模型代码 |
配置资产驱动 |
◐ |
Model Recipe / FeatureSpec 机制 |
2.4 ④ LLM 网关(llm-gateway)
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| C-15 |
敏感度路由准确率 |
≥ 96.5% |
◐ |
core/llm-gateway/router.py + 路由准确率评估脚本 |
| C-16 |
DLP 拦截率 |
100% |
◐ |
dlp.py + test_dlp.py |
| C-17 |
本地首 token 延迟 |
≤ 1.5s |
◐ |
local70b.template.yaml(OpenAI 兼容 vLLM) |
| C-18 |
数据不出厂 |
敏感/核心内容走本地后端 |
◐ |
backends.py Local70BBackend |
2.5 ⑤ 配置化驾驶舱(cockpit)
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| C-19 |
切换行业模板后驾驶舱自动重排 |
无需改前端代码 |
◐ |
core/cockpit(布局 JSON Schema + RenderPlan) |
| C-20 |
首屏性能 |
≤ 2s,图表懒加载 |
◐ |
perf 压测(feature/issue-54) |
| C-21 |
组件数 ≥ 30 性能策略 |
虚拟滚动/采样降频/WebWorker |
◐ |
renderer.py 性能策略 |
2.6 ⑥ 一键部署 / 推理后端
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| C-22 |
一键 Helm 部署 |
内核 + 模板一键部署 |
◐ |
deploy/k8s/helm/iaop |
| C-23 |
昇腾 NPU 后端切换 |
仅适配层,不改业务代码 |
◐ |
core/inference-backend/npu_backend.py |
| C-24 |
可用性 |
≥ 99.8% |
◐ |
可用性监控探针(feature/issue-61) |
| C-25 |
回滚机制 |
一键部署脚本支持回滚 |
◐ |
feature/issue-60 |
2.7 ⑤.7 模板配置台(Template Console)
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| C-26 |
配置台可用 |
新人 2–4 周完成新行业模板 |
◐ |
feature/issue-9 / 62–67 |
| C-27 |
三级 RBAC 权限 |
平台 / 行业 / 运营 分权 |
◐ |
feature/issue-62 |
| C-28 |
"完成"定义达标 |
生产环境上线 Meta,非仅 Demo |
☐ |
待 M3 首模板上线后核对 |
3. iAOP-Template-Ti 一期首模板验收(§10 首模板)
| 编号 |
验收项 |
目标指标 |
状态 |
验证证据 |
| T-01 |
① 质量预测上线 |
准确率 ≥ 90%,误报率 ≤ 5% |
☐ |
待标注数据 ≥ 6 个月(LIMS 对接后补标) |
| T-02 |
③ 炉层杂质预警上线 |
提前 ≥ 30 分钟,误报率 ≤ 8% |
◐ |
templates/ti-cl4/impurity-forecast(阈值+无监督先行,feature/issue-70~72) |
| T-03 |
LLM 报警解释 |
可用,路由准确率 ≥ 96.5% |
◐ |
core/llm-gateway(同 C-15) |
| T-04 |
交接班报告生成 |
≤ 2 分钟 |
◐ |
feature/issue-75 |
| T-05 |
NL 查询 |
可用 |
◐ |
feature/issue-76 |
| T-06 |
驾驶舱按 Ti 布局渲染 |
四状态流程视图 |
◐ |
feature/issue-55 |
| T-07 |
移动端交接班摘要 |
可用 |
◐ |
feature/issue-53 |
| T-08 |
客户 DCS 点位字典导入 |
校验通过 + 采集达标 |
◐ |
同 C-04/C-05/C-01 |
4. NFR 量化底线核对表(§9)
所有指标均来自已交付化工 AI 平台的真实基线或工业现场通用要求,作为验收测试输入。
| 维度 |
指标 |
底线 |
验收归类 |
状态 |
| 性能-采集 |
采集 P99 延迟 |
≤ 1.8s(600 点位 1Hz) |
C-01 |
◐ |
| 性能-前端 |
驾驶舱首屏 |
≤ 2s |
C-20 |
◐ |
| 性能-LLM |
本地首 token |
≤ 1.5s |
C-17 |
◐ |
| 性能-LLM |
交接班报告生成 |
≤ 2 分钟 |
T-04 |
◐ |
| 可靠性-采集 |
丢失率 |
≤ 0.02% |
C-02 |
◐ |
| 可靠性-平台 |
可用性 |
≥ 99.8% |
C-24 |
◐ |
| 安全-网络 |
边缘网关只读、不反控;mTLS;等保 2.0 三级路线 |
安全合规验收 |
C-03 |
◐ |
| 安全-数据 |
路由 96.5%、DLP 100%;敏感数据本地闭环;审计日志全量 |
安全合规验收 |
C-15/C-16/C-18 |
◐ |
| 可扩展 |
切换模板零改码 |
平台化验收 |
C-12/C-13/C-19 |
◐ |
5. 验收流程与节点(§7.7 / §10)
| 节点 |
阶段 |
责任人 |
DoD 勾选门槛 |
状态 |
| N-01 |
自测 |
bot_dev |
内核 6 模块 + 首模板 5 项自测通过 |
◐ |
| N-02 |
内部评审 |
bot_pm + bot_po |
NFR §9 全部 ◐→✅,附验证证据 |
☐ |
| N-03 |
客户 UAT |
王主任 / 李工 |
首模板 T-01~T-08 客户确认 |
☐ |
| N-04 |
生产上线 |
bot_pm + 客户成功 |
上线 Meta(非仅 Demo) |
☐ |
| N-05 |
质保观察 |
客户成功 |
上线后 1 个月无 P0 故障 |
☐ |
| N-06 |
闭环交付 |
bot_pm |
质保期满、签收 |
☐ |
6. 阻塞与风险登记(§12)
| 风险 |
影响 |
当前缓解 / 触发条件 |
关联验收项 |
| 客户标注数据不足 |
①质量预测准确率不达标 |
①③先无监督/阈值上线,3 月后转监督;监督前标注 < 1000 条触发 |
T-01 |
| 客户配合度(UAT) |
M5 节奏延迟 |
M1 即签订 UAT 排期与责任矩阵;必要时按内部验收标准先行上线 |
N-03 |
| 网络/机房环境 |
无法部署本地 GPU |
提供云端 SaaS 演示环境或租赁方案 |
C-17/C-22 |
7. 一致性说明
- 本清单所有量化指标与《产品设计文档_iAOP.md》§9(NFR 表)、§10(DoD)、§7.7(交付物清单)逐字对齐,
_check_dod.py 用于程序化核对本文档的完整性(必备章节、关键指标短语、NFR 指标量化、状态口径)。
- 任一条目从 ◐ 升级为 ✅ 时,须在「验证证据」列补可追溯的脚本输出 / 截图 / 报告链接。