P2_WP03_SEMANTIC_GOVERNANCE_EVIDENCE.md 4.2 KB

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 服务已完成现场验收。