阅读时间：1 分钟
0 字
架构完整性检查
当前目标架构已经覆盖本体建模、语义执行、数据集成、Action、安全、多租户、血缘证据、开放接口、商业化和运维主域。以下检查用于区分“文档已描述”与“工程已完成”。
覆盖矩阵
| 领域 | 文档状态 | 实现状态 | 主要缺口 |
|---|---|---|---|
| 产品定位与边界 | 已覆盖 | 无产品代码 | 目标行业、首批场景和非功能基线需确认 |
| 元模型与版本 | 已覆盖目标设计 | 待开发 | JSON Schema、兼容性规则、迁移工具 |
| Runtime 与查询 | 已覆盖目标设计 | 待开发 | DSL、计划模型、成本统计、错误契约 |
| 连接器与数据路径 | 已覆盖目标设计 | 待开发 | SPI、能力矩阵、凭据与网络方案 |
| Action 与审批 | 已覆盖目标设计 | 待开发 | 状态机 Schema、审批适配、核验接口 |
| 权限与多租户 | 已覆盖目标设计 | 待开发 | 身份提供方、策略语言、隔离档位默认值 |
| 血缘与证据 | 已覆盖目标设计 | 待开发 | 事件 Schema、证据等级、保留与签名策略 |
| API、MCP、Harness | 已覆盖边界 | 待开发 | OpenAPI、MCP 工具 Schema、委托规范 |
| 订阅、计量和计费 | 已覆盖边界 | 待开发 | 计量单位、价格版本、账单与对账规则 |
| 部署与运维 | 已覆盖原则 | 待开发 | 环境清单、SLO、容量、RPO/RTO、演练 |
| 测试与验收 | 已覆盖阶段门槛 | 待开发 | 可执行契约、集成和端到端测试 |
必须优先补齐的工程产物
contracts/schemas/中的本体元模型和执行事件 Schema。contracts/openapi/中的模型、查询、Action 和状态 API。- 服务拥有的数据表、迁移和保留策略。
- 身份、策略、连接器凭据和租户上下文契约。
- 一个贯通“发布模型—查询真实数据—授权过滤—Action 回写—证据核验”的垂直切片。
- 可复现的本地依赖环境和跨服务端到端测试。
仍待决策
| 决策 | 需要的输入 |
|---|---|
| 首个业务场景与实体集合 | 业务价值、数据可用性、回写风险 |
| 模型 DSL 形式 | 可读性、代码生成、兼容性和可视化编辑需求 |
| 服务同步协议 | 延迟、吞吐、错误语义和组织运维能力 |
| Policy 引擎组合 | RBAC/ABAC/ReBAC 复杂度、性能和部署限制 |
| 工作流实现 | Action 时长、审批系统、补偿复杂度和量级 |
| Standard 租户的数据隔离 | 合规要求、成本和预期规模 |
| 证据保留与签名 | 法规、审计周期、隐私和存储成本 |
| 计费单位 | 产品套餐、成本驱动和客户可解释性 |
| SLO、RPO、RTO | 业务影响、部署规格和预算 |
这些选择一旦确定，应在 docs/adr/ 中记录背景、结论、后果和替代方案。
主要风险
- 把本体等同于图数据库，使语义模型与存储绑定。
- 允许任意 SQL 或先读后过滤，造成越权和资源失控。
- 只在网关鉴权，忽略实例、字段、关系和 Action 权限。
- 直接更新源数据库，绕过业务规则和审计。
- 把网络成功误当作业务成功，缺少回写核验。
- 首期部署全部中间件，增加故障面和交付成本。
- 服务共享表和内部类型，导致边界名义独立、实际耦合。
- 把推断步骤写成实际血缘，降低证据可信度。
完整性的判定
文档完整不等于平台完成。平台达到首个可用里程碑，需要可执行契约、数据迁移、真实连接器、权限测试、可恢复 Action、证据查询和可部署环境同时通过验收。