DataOps-platform/docs/phase2/P2_WP00_SCOPE_BASELINE.md

P2-WP00 范围与第二业务域基线

1. 基线结论

P2-WP00 已形成第二阶段工程进入基线：

• 第二阶段分支为 codex/dataops-phase2-platformization，起点提交为 ff42feec7dda1b8bd80d0ba0f17ea31f9ffb4d2d。
• 第一阶段远端发布分支 codex/dataops-phase1-release 和版本 v0.2.0-phase1 均指向 1b926255374191b25716a947c44f121a0e327dd5。
• 第二业务域默认采用“备品备件/物料主数据”。
• 对象、来源、术语、质量规则、责任角色、流程样本、指标和裁剪线已建立稳定编号。
• 第一阶段 OpenAPI、迁移、发布副本和本地数据状态已形成可机读基线。

本基线允许 P2-WP01 开展通用治理对象和领域模板的工程开发。企业真实人员、 数据源和脱敏样本仍须在第二业务域正式复制与 UAT 前绑定。本地工程基线 不能替代企业真实数据验收。

2. 范围冻结

2.1 当前阶段目标

第二阶段只解决“设备域能力如何成为可复用数据运营平台能力”。新增业务域必须 通过通用对象、模板、策略、事件和任务契约接入，不得复制设备域核心服务。

本阶段建设主动元数据、通用术语与标准、通用质量运营、数据可观测、统一责任 与任务、基础数据产品治理、Agent 基础治理、通用安全底座和产品工程。

2.2 明确边界

• 产品继续专注数据运营与治理，不扩展为分析开发平台。
• 不建设 NL2SQL、在线分析、BI 开发或无代码应用平台。
• 不建设 OIDC SSO、IdP、Claims 映射和企业通讯录同步。
• 不建设 Kubernetes、HA、SaaS 多租户和完整企业连接器集合。
• 不开放高风险 Agent 自动执行，不建设自动数据修复。
• 不把页面、接口或本地演示数据单独作为功能完成证据。

范围新增必须标注功能模块编号、业务价值、样本、责任角色、验收标准和被替换 的团队容量；不满足这些条件的需求进入后续待办。

3. 第二业务域

3.1 默认领域

默认验证域为“备品备件/物料主数据”。它与设备运行维护具有业务关联，可以 复用第一阶段证据与责任能力；同时其对象标识、分类标准、库存质量、供应商映射 和流程责任明显不同，能够发现设备域硬编码。

企业如选择其他领域，替换必须保留以下最小复杂度：

• 至少一个关系数据库或受控文件/API 来源；
• 至少三类核心治理对象；
• 至少一组术语或代码集；
• 至少五条可执行质量规则；
• 至少一个跨责任人的整改或审批流程；
• 可在本阶段提供验收用户和脱敏样本。

3.2 选择状态

当前状态为 DEFAULT_BASELINE。平台团队可据此开展通用契约开发；企业需要在 P2-WP12 启动前确认实际业务域、数据源、样本和责任人。若企业替换业务域， 必须更新可机读需求台账并通过同一契约测试。

4. 对象与样本

4.1 治理对象

编号	对象	稳定业务键	用途
OBJ-MATERIAL	物料主数据	物料编码	验证通用资产、版本、术语和质量
OBJ-MATERIAL-CATEGORY	物料分类	分类编码	验证标准、层级和引用完整性
OBJ-STORAGE-LOCATION	仓库与库位	仓库编码 + 库位编码	验证位置对象和责任
OBJ-INVENTORY-BALANCE	库存余额	物料 + 仓库 + 库位 + 快照时间	验证增量、新鲜度和 SLA
OBJ-SUPPLIER-MATERIAL	供应商物料映射	供应商 + 供应商物料编码	验证跨来源映射
OBJ-EQUIPMENT-COMPATIBILITY	设备备件适配关系	物料 + 设备类型	验证跨域关系和证据

4.2 来源样本

编号	类型	范围	当前边界
SRC-MATERIAL-POSTGRES	PostgreSQL	物料、分类、单位和状态	本地模板就绪，企业只读样本待提供
SRC-INVENTORY-MYSQL	MySQL	仓库、库位、库存和快照	本地模板就绪，企业只读样本待提供
SRC-SUPPLIER-FILE	受控 CSV/XLSX	供应商物料映射	Schema 已冻结，企业脱敏文件待提供

平台不记录或假定企业密码、令牌和真实网络地址。

4.3 术语与代码样本

• 物料分类术语与代码集；
• 计量单位代码集；
• 物料生命周期状态代码集；
• 备件关键度术语。

4.4 质量规则样本

已固化八条规则样本：物料编码必填、编码唯一、名称与规格完整、计量单位有效、 物料分类引用有效、库存快照新鲜、库存数量非负、设备备件适配关系可追溯。

4.5 流程样本

已固化物料主数据纠错审批、物料质量问题整改、术语与代码集变更三类流程。

所有编号和详细字段见 docs/phase2/P2_WP00_REQUIREMENTS.json。

5. 责任与验收

责任角色	最终责任	当前绑定
phase2_product_owner	范围、优先级、指标和变更控制	平台角色已建立
material_domain_owner	领域对象、术语、标准和业务验收	企业正式指定
material_data_steward	数据样本、质量规则和整改运营	企业正式指定
phase2_technical_owner	架构、契约、迁移、安全和发布	平台角色已建立
phase2_acceptance_owner	验收、缺陷和移交结论	企业正式指定

P2-WP01 的工程验收由平台产品负责人和技术负责人承担；P2-WP12、P2-WP13 的 业务验收必须由企业领域负责人、数据责任人和验收负责人参加。没有具体人员时 保留空绑定，不用开发人员姓名替代企业责任。

6. 指标与裁剪

第二阶段采用计划中的14项指标，包括对象入账、来源追溯、增量准确率、字段 血缘、责任覆盖、质量模板复用、问题闭环、任务追溯、事故影响、数据产品证据、 Agent越权阻断与审计、设备专用代码修改次数以及交付演练。

关键结构性指标为：第二业务域核心功能修改设备域专用代码次数等于 0。

容量不足时优先缩减 P2-WP08 和 P2-WP09 的管理页面与场景数量，不得取消：

• P2-WP12 第二业务域复制；
• P2-WP13 第二阶段验收；
• 权限与安全门禁；
• 迁移、升级和回滚；
• 真实用户和真实数据验收。

指标定义、目标和完整裁剪线见 docs/phase2/P2_WP00_REQUIREMENTS.json。

7. 不可变基线

7.1 源码版本

• 第一阶段发布：v0.2.0-phase1 / 1b926255374191b25716a947c44f121a0e327dd5。
• 第二阶段起点： ff42feec7dda1b8bd80d0ba0f17ea31f9ffb4d2d。
• 第二阶段开发分支：codex/dataops-phase2-platformization。

7.2 API 与迁移

• OpenAPI：219 个操作。
• 已提交文件与重新生成文件 SHA-256 均为 3c578c0db381ea5a47da9e4aa46d0fbd3a721a686fef2d425a288afa9c486ab7。
• Alembic 迁移头：20260730_360。
• 迁移文件：42 个。
• app/ 与 deployment/app/ Git 树均为 f859b4fd882f311a245ebeec5312e234d20f6658。

7.3 本地数据状态

只读快照记录116张公共表、4个用户、4个设备资产、4个来源映射、2次质量运行、 1个质量问题、4个运行事件和2个审计封印。4个用户中2个启用、2个为已停用的 WP14临时验收账号。

以上计数只用于发现第二阶段开发引入的非预期变化，不表示企业生产规模。 完整机器清单见 docs/phase2/P2_WP00_BASELINE_MANIFEST.json。

8. P2-WP01 进入门禁

门禁	结果	证据
第二阶段独立分支	通过	codex/dataops-phase2-platformization
第一阶段远端版本	通过	远端分支和标签均解析到 1b92625
默认第二业务域	通过	备品备件/物料主数据
最小对象与样本	通过	6类对象、3类来源、4组术语、8条规则、3个流程
P0 需求追踪	通过	5项需求均绑定模块、责任角色、样本和验收标准
指标与裁剪线	通过	14项指标和不可裁剪门禁
API、迁移和发布副本	通过	哈希、迁移头、文件数和Git树
本地数据只读快照	通过	公共表和代表性记录精确计数

P2-WP01 可以进入工程开发。企业人员和真实数据绑定不是通用对象契约开发的 前置，但属于 P2-WP12 企业复制和 P2-WP13 正式验收的强制门禁。

9. 外部确认边界

以下信息只有企业能够提供，当前不虚构：

• 实际第二业务域是否采用备品备件/物料主数据；
• 企业领域负责人、数据责任人和验收负责人的姓名；
• 企业数据源网络、只读账号、字段字典和脱敏样本；
• 企业术语、代码集、质量阈值和问题处置时限；
• 第10～12周可参加UAT的真实用户和签字安排。

外部信息到位后只更新人员绑定、来源配置和验收样本，不改变已经冻结的平台化 目标。若要求扩展为分析开发平台、提前建设 OIDC SSO 或取消第二业务域复制， 必须按范围变更流程重新评估，不能直接插入当前工作包。