项目概览

企业级本体平台面向多租户、多数据源和业务应用、Agent 等多种调用方，目标是在现有系统之上提供统一的业务语义、受控操作和可追溯的执行记录。目前处于架构设计阶段；仓库中可运行的是文档站，平台服务尚未实现。

平台解决什么问题

不同系统对同一业务对象的命名、字段和关系往往不一致。平台计划用本体模型描述实体类型、属性、关系和 Action，再把这些语义定义映射到实际数据源。调用方按业务概念查询或发起操作，无需分别理解每个源系统的接口。

本体是业务语义层，不要求把所有业务数据复制到图数据库。外部数据默认留在源系统；虚拟化查询、缓存和物化按数据源能力与时效要求选择。

能力	目标
本体建模	定义实体、关系、属性、数据映射和不可变发布版本。
语义读取	按已发布模型解析请求、检查权限、规划查询并跨源组装结果。
受控 Action	执行规则校验、审批、幂等回写、失败补偿和结果核验。
安全与证据	隔离租户，控制对象、实例、字段和动作权限；关联血缘、审批与实际执行证据。
开放与运营	通过 API、MCP 和工具目录接入调用方，并管理配额、用量与订阅。

**读取：**调用方通过 API 或 MCP 查询业务对象；平台按模型定位数据源、执行权限检查，返回语义实体及其关系。
**回写：**调用方发起 Action；平台完成规则与权限检查、必要的审批和源系统回写，核验结果后关联执行证据。无法确认源端结果时保留“未知”状态，不视为成功。

具体服务边界和流程图见技术架构；九个服务的职责见服务架构。

状态	内容
已完成	项目目录骨架、职责说明、VitePress 文档站。
设计中	服务间契约、持久化边界、部署方式和验收指标。
待实现	React 管理端、后端服务、连接器、权限、Action、血缘、计费及实际部署。

目录占位不代表功能可用。目前尚无已发布的业务 API、事件或 Schema；后续机器可读契约以仓库根目录的 contracts/ 为准。