# P2-WP04 通用质量运营工程说明

## 1. 交付结论

P2-WP04 已完成本地工程实现和定向验证。平台新增跨业务域质量模板、字段角色
绑定、确定性画像、异常与退化识别、新鲜度和质量 SLA，并将质量发现关联到
主动元数据资产、来源、执行批次、血缘、变更、运行及模板责任人证据。

这项结论只代表分支内工程门禁通过，不代表企业业务验收、生产部署或正式阈值
已确认。

## 2. 平台化设计

通用质量模板定义 `identity`、`category`、`measure` 等语义角色，不直接写入
设备域或备件域字段名。每次执行通过字段角色绑定连接物理字段，因此同一模板
可以分别绑定：

- 设备域：`device_code`、`device_type`、`temperature`；
- 备品备件域：`part_code`、`part_category`、`stock_quantity`。

设备质量原有 API、数据和整改链保持不变。通用能力使用主动元数据资产作为
权威资产身份，不复制第二套设备台账或采集服务。

## 3. 功能范围

- 画像：完整率、唯一性、分布、空值、类型、模式和不可逆样例摘要；
- 趋势：批次时间序列、上批对比、同比、环比和得分退化；
- 异常：数据量、分布、模式、重复、异常值及 Schema 变化；
- SLA：新鲜度与质量得分阈值、达标、违约、恢复和升级级别事件；
- 复发：按模板、资产、发现类型和字段计算稳定复发键与发生次数；
- 根因证据：关联主动元数据血缘、变更、采集运行和模板责任人；
- 权限：viewer 只读，editor 可编辑和执行，admin 可发布；
- 安全：每批最多 5,000 行、每行最多 200 字段且总计不超过 200,000 个
  单元格/800 万字符，拒绝秘密字段和高风险正则进入模板，样例与分布值只
  持久化不可逆摘要。

## 4. 明确边界

- 不使用 AI 生成或替代确定性质量结论；
- 不建设任意 SQL、在线分析、BI 计算或自动数据修复；
- 不把客户端提交的血缘或根因作为权威证据，根因关联由服务端读取治理数据；
- 不在本工作包完成质量事故、统一待办和通知送达；分别由 P2-WP05、
  P2-WP07 接续；
- 不将本地备品备件样本当作企业真实数据验收。

## 5. 数据与接口

数据库迁移 `20260731_400` 新增：

- `quality_templates`、`quality_template_versions`；
- `quality_profile_runs`、`quality_profile_metrics`；
- `quality_findings`、`quality_sla_events`。

接口位于 `/api/rules/quality-operations`，覆盖模板创建、修订、发布、执行、
批次明细和资产趋势。前端入口为
`/data-governance/development/quality-operations`。

## 6. 定向验证

本工作包只执行修改范围内验证：

- 通用质量核心契约与统计测试；
- API 权限和响应契约；
- 前端入口与能力文案契约；
- PostgreSQL 双业务域、持久化和根因证据集成测试；
- 迁移升级、OpenAPI 可重现性、前端定向检查和生产构建；
- `app/` 与 `deployment/app/` 发布副本一致性。

企业验收仍需提供真实责任人、脱敏真实数据、正式时间源、质量阈值和统计窗口，
并在 P2-WP12、P2-WP13 完成业务复核。