DataOps-platform/docs/phase2/P2_WP04_QUALITY_OPERATIONS.md

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 完成业务复核。