P2_WP04_QUALITY_OPERATIONS.md 3.2 KB
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 完成业务复核。