阅读时间: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 达到经业务批准的目标,并通过恢复演练验证。 |
每阶段共同完成标准
- 机器可读契约已版本化,文档链接到对应契约。
- 数据库迁移可重复执行,并有回滚或前向修复方案。
- 服务健康、指标、日志、追踪和审计事件可观察。
- 安全边界、失败状态和人工处置路径已经测试。
- 文档不把规划能力描述为已上线能力。