P2-WP03 通用术语与标准验证记录
1. 工程范围
P2-WP03 在现有 DataStandardVersion、数据元素、本体和治理知识能力上补齐跨业务域语义链:
- 业务术语的定义、别名、责任人、关联资产、标准、数据元素和不可变版本;
- 通用代码集、父子代码完整性和跨对象代码引用校验;
- 指标定义、公式、单位、维度、责任人和关联资产,但不提供 BI 计算或分析执行;
- 活动元数据物理字段到已发布数据元素的受控映射;
- 草稿、提交、独立审批、发布、修订、追加式回滚和全链路审计;
- 语义 JSON、受控 RDF/XML 导出,以及既有本体 JSON/OWL 交换能力;
- 语义对象、数据标准和本体发布事件进入 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 服务已完成现场验收。