# P2-WP03 通用术语与标准验证记录

## 1. 工程范围

P2-WP03 在现有 `DataStandardVersion`、数据元素、本体和治理知识能力上补齐跨业务域语义链：

1. 业务术语的定义、别名、责任人、关联资产、标准、数据元素和不可变版本；
2. 通用代码集、父子代码完整性和跨对象代码引用校验；
3. 指标定义、公式、单位、维度、责任人和关联资产，但不提供 BI 计算或分析执行；
4. 活动元数据物理字段到已发布数据元素的受控映射；
5. 草稿、提交、独立审批、发布、修订、追加式回滚和全链路审计；
6. 语义 JSON、受控 RDF/XML 导出，以及既有本体 JSON/OWL 交换能力；
7. 语义对象、数据标准和本体发布事件进入 outbox，并在知识配置就绪后同步 canonical
   治理知识。

本工作包没有复制数据标准、数据元素或本体服务，也没有扩展为分析开发平台。

## 2. 发布、安全与一致性边界

- editor 可创建、修订、提交和建立字段映射；viewer 只读；admin 才能审批、发布和回滚；
- 创建者不得审批同一版本，版本不原地覆盖，回滚追加新发布版本并保存来源版本号；
- 关联物理资产必须是活动主动元数据，数据元素和标准版本必须已发布；
- 代码集内代码唯一，父代码必须存在且不能自引用，跨对象代码引用必须指向已发布代码值；
- 指标请求若携带 SQL、query、script、executable 或 runtime 字段即失败关闭；
- 密码、令牌、密钥、凭据和连接串语义字段禁止进入定义和导出；
- 消费器只领取三类已注册治理发布事件，不会把其他 outbox 事件错误重试或死信；
- 发布事件只有在 canonical 知识同步完成后才由消费者确认；知识配置不完整时保留 pending；
- 本体 JSON/OWL 沿用既有交换接口；通用语义只提供 JSON 与受控 RDF，不伪造 OWL。

## 3. 第二业务域工程样本

真实数据库定向验收使用不含企业秘密的客户主数据样本，完成：

- “客户等级”业务术语；
- “客户等级”代码集及 `VIP → VIP_A` 父子代码；
- “重要客户占比”指标定义、区域维度和两版口径；
- 一项已发布客户主数据标准版本引用；
- `customers.customer_level` 到“客户等级”数据元素的字段映射；
- 三类语义对象从草稿、提交、独立审批到发布；
- 指标 V1 发布、V2 修订发布、再追加 V3 回滚至 V1 口径。

上述是本地工程样本，不是企业正式术语、代码、标准、指标或责任人验收。P2-WP12 仍需绑定
企业真实物料/备件样本和责任矩阵。

## 4. 定向验证范围

遵循工作包级验证策略，本次没有执行全量回归，定向覆盖：

- 核心生命周期、引用完整性、指标执行边界、字段映射、回滚、审计和安全导出；
- viewer/editor/admin API 权限及页面工作流；
- PostgreSQL 六张新增表、约束、迁移头和真实发布闭环；
- 语义知识点构建、发布事件注册和配置缺失时的安全等待；
- 既有 StandardVersion 编辑/管理员分离发布门禁及本体 JSON/OWL 交换；
- OpenAPI 路由清单、发布副本一致性、前端 ESLint 与生产构建。

## 5. 本地工程验证结果（2026-07-31）

- Alembic 已从 `20260730_380` 升级到 `20260731_390`；
- 真实 PostgreSQL 闭环测试通过，验证三类对象、字段映射、九条指标审计、三次指标发布事件、
  一次带审计的数据标准发布事件，以及 V1/V2 `superseded`、V3 `published` 的追加式回滚结果；
- WP03 核心、API、权限、迁移、前端、知识同步和 OpenAPI 定向测试通过；
- 本次触达 Python 文件 Ruff 检查通过，前端新增/触达文件 ESLint 无错误；
- 前端生产构建成功；仅保留项目既有 Browserslist、旧文件 console、CSS 顺序和包体积警告；
- OpenAPI 由当前源码重新生成，共 250 个操作，包含 14 个语义治理操作；
- `app/` 与 `deployment/app/` 的新增和触达后端文件逐字节一致。

以上结论是当前分支的本地工程完成，不代表远端已推送、环境已部署、企业语义已确认或知识
embedding 服务已完成现场验收。