阅读时间:1 分钟
0 字

实施路线与验收 ​

本页把目标架构拆成可独立验收的阶段。周期需要在团队、数据规模和源系统可用性明确后估算;本文不承诺交付日期。

各阶段具体任务、交付物和依赖见分阶段开发任务清单;外部项目的复用与成本见开源项目选型与接入成本。

阶段 0:场景与工程基线 ​

交付范围:确定首个可量化业务场景、数据所有者和可访问测试源;建立版本化契约、身份与租户边界、本地基础设施及候选组件 PoC。

验收条件:

  • 业务所有者确认场景范围、现状基线、成功指标和源系统访问方式。
  • contracts/ 中的接口、事件和标识契约可生成服务桩,并在 CI 中检查兼容性。
  • 干净环境可启动空服务,完成数据库迁移、备份与还原演练。
  • 候选开源组件有版本、许可证、接入成本和是否采用的决策记录。

阶段 1:本体核心与单源读取 ​

交付范围:租户基础、Ontology Core、Registry、JDBC/HTTP 连接器、单源查询 Runtime、REST API 和最小管理端。

验收条件:

  • 可定义实体、属性、关系、数据绑定和版本。
  • 草稿经过校验后发布为不可变快照,Runtime 不读取草稿。
  • 连接 PostgreSQL、MySQL 和 HTTP 测试源中的至少两类。
  • 通过统一 API 查询真实数据,并返回模型版本、数据来源、读取时间和 traceId。
  • 对未授权字段在执行前拒绝或改写查询。

阶段 2:权限与 Action 闭环 ​

交付范围:RBAC/ABAC/ReBAC、Action 定义、规则、审批、幂等、Outbox、重试、补偿、核验和执行证据。

验收条件:

  • 不同主体对同一实体获得符合策略的实例和字段结果。
  • 同一个业务幂等键不会重复产生可见副作用。
  • 审批通过前不能执行回写;执行前再次校验关键权限和业务状态。
  • 源系统响应丢失时进入“结果未知”,通过查询或对账核验,不直接标记成功。
  • executionId 可查询到规则、授权、审批、回写、核验和证据引用。

阶段 3:跨源、MCP 与治理 ​

交付范围:受限跨源查询、CDC/ETL、Tool Registry、MCP Server、静态和动态血缘、模型影响分析、执行观测。

验收条件:

  • 至少两种不同客户端复用同一语义查询和 Action 定义。
  • MCP 工具发现按租户、主体、委托范围和策略过滤。
  • 跨源查询受扫描量、结果量、超时、内存和关系深度预算约束。
  • 字段级静态映射与实例级动态执行可以关联到同一个模型版本。
  • 源端不可观测步骤被明确标记,不生成虚假血缘。

阶段 4:商业化与生产强化 ​

交付范围:订阅、配额、计量、计费账本、租户隔离档位、备份恢复、安全评估、容量测试和服务等级。

验收条件:

  • 用量事件可去重、对账并追溯到租户、订阅、调用和价格版本。
  • 配额在入口和执行路径同时生效,超额行为可解释。
  • 完成跨租户越权、故障恢复、备份还原和密钥轮换演练。
  • 核心查询与 Action 的 SLO、告警和错误预算有基线数据。

建议验收指标 ​

以下指标用于首轮工程基线,最终数值必须基于样本数据、网络和部署规格压测确认。

指标建议目标
单源简单查询测试环境 P95 不高于 300 ms;同时报告源系统延迟。
跨源查询支持受限的两源关联,超预算请求在执行前拒绝。
Action 幂等相同租户、Action 和幂等键只产生一次业务副作用。
租户隔离自动化跨租户读写越权用例全部失败关闭。
发布兼容性破坏性模型变更在发布前识别并阻断。
执行追踪关键读取和写入均可关联主体、租户、模型版本和 traceId;Action 还需关联 executionId。
证据完整性所有成功回写都有可验证响应或后续核验记录。
恢复能力RPO、RTO 达到经业务批准的目标,并通过恢复演练验证。

每阶段共同完成标准 ​

  • 机器可读契约已版本化,文档链接到对应契约。
  • 数据库迁移可重复执行,并有回滚或前向修复方案。
  • 服务健康、指标、日志、追踪和审计事件可观察。
  • 安全边界、失败状态和人工处置路径已经测试。
  • 文档不把规划能力描述为已上线能力。