DataOps-platform/docs/phase2/P2_WP00_REQUIREMENTS.json

{
  "schema_version": "1.0",
  "work_package": "P2-WP00",
  "title": "范围与第二业务域基线",
  "baseline_status": "ENGINEERING_BASELINED",
  "second_business_domain": {
    "code": "spare_parts_material_master",
    "name": "备品备件/物料主数据",
    "selection_status": "DEFAULT_BASELINE",
    "selection_rationale": "与设备运行维护存在业务关联，但对象、标准、质量规则和责任关系不同，可用于验证平台通用化且不重复建设设备域。",
    "enterprise_confirmation_gate": "P2-WP12 企业复制验收前，由企业确认实际业务域、负责人、数据源和脱敏样本。",
    "governance_objects": [
      {
        "id": "OBJ-MATERIAL",
        "name": "物料主数据",
        "business_key": "material_code",
        "required_fields": [
          "material_code",
          "material_name",
          "category_code",
          "base_uom",
          "status"
        ]
      },
      {
        "id": "OBJ-MATERIAL-CATEGORY",
        "name": "物料分类",
        "business_key": "category_code",
        "required_fields": [
          "category_code",
          "category_name",
          "parent_category_code",
          "status"
        ]
      },
      {
        "id": "OBJ-STORAGE-LOCATION",
        "name": "仓库与库位",
        "business_key": "warehouse_code+location_code",
        "required_fields": [
          "warehouse_code",
          "location_code",
          "location_name",
          "status"
        ]
      },
      {
        "id": "OBJ-INVENTORY-BALANCE",
        "name": "库存余额",
        "business_key": "material_code+warehouse_code+location_code+snapshot_at",
        "required_fields": [
          "material_code",
          "warehouse_code",
          "location_code",
          "quantity",
          "snapshot_at"
        ]
      },
      {
        "id": "OBJ-SUPPLIER-MATERIAL",
        "name": "供应商物料映射",
        "business_key": "supplier_code+supplier_material_code",
        "required_fields": [
          "supplier_code",
          "supplier_material_code",
          "material_code",
          "status"
        ]
      },
      {
        "id": "OBJ-EQUIPMENT-COMPATIBILITY",
        "name": "设备备件适配关系",
        "business_key": "material_code+equipment_type_code",
        "required_fields": [
          "material_code",
          "equipment_type_code",
          "compatibility_status",
          "evidence_source"
        ]
      }
    ],
    "sources": [
      {
        "id": "SRC-MATERIAL-POSTGRES",
        "name": "物料主数据关系库",
        "type": "PostgreSQL",
        "scope": "物料、分类、计量单位和状态",
        "read_mode": "只读元数据与受控样本",
        "readiness": "LOCAL_TEMPLATE_READY_ENTERPRISE_SAMPLE_REQUIRED"
      },
      {
        "id": "SRC-INVENTORY-MYSQL",
        "name": "库存与库位关系库",
        "type": "MySQL",
        "scope": "仓库、库位、库存余额和快照时间",
        "read_mode": "只读元数据与受控样本",
        "readiness": "LOCAL_TEMPLATE_READY_ENTERPRISE_SAMPLE_REQUIRED"
      },
      {
        "id": "SRC-SUPPLIER-FILE",
        "name": "供应商物料映射文件",
        "type": "受控 CSV/XLSX",
        "scope": "供应商编码、供应商物料编码和平台物料编码",
        "read_mode": "脱敏文件导入",
        "readiness": "SCHEMA_BASELINED_ENTERPRISE_SAMPLE_REQUIRED"
      }
    ],
    "terms_and_code_sets": [
      {
        "id": "TERM-MATERIAL-CATEGORY",
        "name": "物料分类术语与代码集",
        "type": "TERM_AND_CODE_SET",
        "owner_role": "material_domain_owner"
      },
      {
        "id": "CODE-UOM",
        "name": "计量单位代码集",
        "type": "CODE_SET",
        "owner_role": "material_data_steward"
      },
      {
        "id": "CODE-MATERIAL-STATUS",
        "name": "物料生命周期状态代码集",
        "type": "CODE_SET",
        "owner_role": "material_data_steward"
      },
      {
        "id": "TERM-SPARE-PART-CRITICALITY",
        "name": "备件关键度术语",
        "type": "TERM",
        "owner_role": "material_domain_owner"
      }
    ],
    "quality_rule_samples": [
      {
        "id": "QR-MAT-001",
        "name": "物料编码必填",
        "dimension": "COMPLETENESS",
        "target_object": "OBJ-MATERIAL"
      },
      {
        "id": "QR-MAT-002",
        "name": "物料编码全局唯一",
        "dimension": "UNIQUENESS",
        "target_object": "OBJ-MATERIAL"
      },
      {
        "id": "QR-MAT-003",
        "name": "物料名称与规格完整",
        "dimension": "COMPLETENESS",
        "target_object": "OBJ-MATERIAL"
      },
      {
        "id": "QR-MAT-004",
        "name": "计量单位符合代码集",
        "dimension": "VALIDITY",
        "target_object": "OBJ-MATERIAL"
      },
      {
        "id": "QR-MAT-005",
        "name": "物料分类引用有效",
        "dimension": "REFERENTIAL_INTEGRITY",
        "target_object": "OBJ-MATERIAL"
      },
      {
        "id": "QR-MAT-006",
        "name": "库存快照新鲜度",
        "dimension": "FRESHNESS",
        "target_object": "OBJ-INVENTORY-BALANCE"
      },
      {
        "id": "QR-MAT-007",
        "name": "库存数量非负",
        "dimension": "VALIDITY",
        "target_object": "OBJ-INVENTORY-BALANCE"
      },
      {
        "id": "QR-MAT-008",
        "name": "设备备件适配关系可追溯",
        "dimension": "TRACEABILITY",
        "target_object": "OBJ-EQUIPMENT-COMPATIBILITY"
      }
    ],
    "workflow_samples": [
      {
        "id": "WF-MAT-001",
        "name": "物料主数据纠错审批",
        "trigger": "用户提交物料字段纠错",
        "owner_role": "material_data_steward",
        "review_role": "material_domain_owner"
      },
      {
        "id": "WF-MAT-002",
        "name": "物料质量问题整改",
        "trigger": "质量规则产生违规记录",
        "owner_role": "material_data_steward",
        "review_role": "phase2_acceptance_owner"
      },
      {
        "id": "WF-MAT-003",
        "name": "术语与代码集变更",
        "trigger": "术语、分类或计量单位发生变更",
        "owner_role": "material_domain_owner",
        "review_role": "phase2_product_owner"
      }
    ]
  },
  "responsibility_assignments": [
    {
      "role": "phase2_product_owner",
      "accountability": "第二阶段范围、优先级、指标和变更控制",
      "binding_status": "PLATFORM_ASSIGNED",
      "person_name": null
    },
    {
      "role": "material_domain_owner",
      "accountability": "第二业务域对象、术语、标准和业务验收",
      "binding_status": "ENTERPRISE_TO_ASSIGN",
      "person_name": null
    },
    {
      "role": "material_data_steward",
      "accountability": "物料数据样本、质量规则和整改运营",
      "binding_status": "ENTERPRISE_TO_ASSIGN",
      "person_name": null
    },
    {
      "role": "phase2_technical_owner",
      "accountability": "架构、契约、迁移、安全和发布门禁",
      "binding_status": "PLATFORM_ASSIGNED",
      "person_name": null
    },
    {
      "role": "phase2_acceptance_owner",
      "accountability": "验收用例、缺陷门禁和移交结论",
      "binding_status": "ENTERPRISE_TO_ASSIGN",
      "person_name": null
    }
  ],
  "requirements": [
    {
      "id": "P2-WP00-R01",
      "name": "确认第二业务域与责任角色",
      "priority": "P0",
      "module_ids": [
        "P2-11",
        "CAT-03",
        "GOV-03",
        "GOV-04"
      ],
      "owner_role": "phase2_product_owner",
      "sample_refs": [
        "OBJ-MATERIAL",
        "OBJ-MATERIAL-CATEGORY",
        "OBJ-INVENTORY-BALANCE",
        "material_domain_owner",
        "material_data_steward"
      ],
      "acceptance_criterion": "默认第二业务域、治理对象和责任角色已经固化；企业姓名在正式复制验收前绑定，不虚构人员。",
      "status": "BASELINED"
    },
    {
      "id": "P2-WP00-R02",
      "name": "建立对象、来源、术语、质量和任务样本",
      "priority": "P0",
      "module_ids": [
        "CAT-03",
        "SEM-04",
        "DQA-02",
        "WFC-08"
      ],
      "owner_role": "material_data_steward",
      "sample_refs": [
        "SRC-MATERIAL-POSTGRES",
        "TERM-MATERIAL-CATEGORY",
        "QR-MAT-001",
        "QR-MAT-008",
        "WF-MAT-001"
      ],
      "acceptance_criterion": "至少三类对象、一个来源、一组术语、五条质量规则和一个跨责任流程均有稳定编号与验收用途。",
      "status": "BASELINED"
    },
    {
      "id": "P2-WP00-R03",
      "name": "固化验收指标和容量裁剪线",
      "priority": "P0",
      "module_ids": [
        "GOV-10",
        "GOV-11"
      ],
      "owner_role": "phase2_acceptance_owner",
      "sample_refs": [
        "P2-M01",
        "P2-M13",
        "P2-WP12",
        "P2-WP13"
      ],
      "acceptance_criterion": "所有核心结果均有指标、目标和不可裁剪门禁，容量不足时不会取消复制、权限、安全、迁移和验收。",
      "status": "BASELINED"
    },
    {
      "id": "P2-WP00-R04",
      "name": "建立第二阶段分支和需求追踪",
      "priority": "P0",
      "module_ids": [
        "PLT-16",
        "PLT-17"
      ],
      "owner_role": "phase2_technical_owner",
      "sample_refs": [
        "codex/dataops-phase2-platformization",
        "P2-WP00-R01",
        "P2-WP00-R05"
      ],
      "acceptance_criterion": "第二阶段在独立分支执行，每项需求可追溯到功能台账模块、样本、责任角色和验收标准。",
      "status": "BASELINED"
    },
    {
      "id": "P2-WP00-R05",
      "name": "固定第一阶段接口、迁移和数据状态",
      "priority": "P0",
      "module_ids": [
        "PLT-09",
        "PLT-10",
        "PLT-16",
        "PLT-17",
        "PLT-26"
      ],
      "owner_role": "phase2_technical_owner",
      "sample_refs": [
        "v0.2.0-phase1",
        "OPENAPI-219",
        "ALEMBIC-20260730-360",
        "LOCAL-DATA-SNAPSHOT"
      ],
      "acceptance_criterion": "第一阶段发布提交、OpenAPI、迁移、发布副本和本地数据状态均由哈希或精确计数固定。",
      "status": "BASELINED"
    }
  ],
  "acceptance_metrics": [
    {
      "id": "P2-M01",
      "definition": "第二业务域核心对象入账率",
      "target": ">=95%"
    },
    {
      "id": "P2-M02",
      "definition": "来源身份和版本可追溯率",
      "target": "100%"
    },
    {
      "id": "P2-M03",
      "definition": "增量采集变更识别准确率",
      "target": ">=99%"
    },
    {
      "id": "P2-M04",
      "definition": "核心字段血缘覆盖率",
      "target": ">=90%"
    },
    {
      "id": "P2-M05",
      "definition": "核心术语、标准和代码集责任覆盖率",
      "target": ">=95%"
    },
    {
      "id": "P2-M06",
      "definition": "通用质量规则模板复用率",
      "target": ">=80%"
    },
    {
      "id": "P2-M07",
      "definition": "质量问题按流程闭环率",
      "target": ">=85%"
    },
    {
      "id": "P2-M08",
      "definition": "四类统一任务状态可追溯率",
      "target": "100%"
    },
    {
      "id": "P2-M09",
      "definition": "数据事故责任与影响覆盖率",
      "target": "100%"
    },
    {
      "id": "P2-M10",
      "definition": "数据产品合同和合格证完整率",
      "target": "100%"
    },
    {
      "id": "P2-M11",
      "definition": "Agent 越权动作阻断率",
      "target": "100%"
    },
    {
      "id": "P2-M12",
      "definition": "Agent 关键动作审计覆盖率",
      "target": "100%"
    },
    {
      "id": "P2-M13",
      "definition": "第二业务域核心功能修改设备域专用代码次数",
      "target": "0"
    },
    {
      "id": "P2-M14",
      "definition": "安装、迁移、升级和回滚演练",
      "target": "各至少1次"
    }
  ],
  "capacity_cut_line": {
    "p0_must_keep": [
      "P2-WP00",
      "P2-WP01",
      "P2-WP02",
      "P2-WP03",
      "P2-WP04",
      "P2-WP06",
      "P2-WP07",
      "P2-WP10",
      "P2-WP11",
      "P2-WP12",
      "P2-WP13"
    ],
    "p1_reducible": [
      "P2-WP08 数据产品治理缩减为一个真实合同与合格证场景",
      "P2-WP09 Agent 治理缩减为只读与建议级验证场景"
    ],
    "never_remove": [
      "P2-WP12",
      "P2-WP13",
      "权限门禁",
      "安全门禁",
      "迁移回滚",
      "真实验收"
    ]
  }
}