# 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 或取消第二业务域复制，
必须按范围变更流程重新评估，不能直接插入当前工作包。