Appearance
业务微服务
业务服务按领域独立维护 API/Biz、数据库迁移和部署配置。服务间优先通过 Feign/API 或事件协作,跨域读取必须经过公开契约,避免共享 Mapper 和直接写入他域表。
| 领域 | 服务 |
|---|---|
| 文档与知识 | DocSpace、AI、SPG、Accounting |
| 审计与标准 | Audit、Standard、HMC |
| 过程协作 | WFlow、Expert |
| 交易运营 | Pay、Billing、Growth |
| 应用与扩展 | MBTI、Vehicle MCP、Doc Compliance |
服务协作原则
每个服务包含自己的 API/Biz、迁移脚本和部署配置;跨域读写通过 Feign/API、MQ 事件或 MCP 工具完成,不共享 Mapper,也不直接写入他域表。服务发现使用 Nacos,入口通常经过 Gateway,服务内部仍必须校验租户和资源权限。
AI 是能力编排方,不是所有业务数据的拥有者:它通过公开契约读取 DocSpace 文件、Audit 材料、Standard 控制点、WFlow 任务和 Billing 用量。一个长任务要同时记录业务 taskId、agent sessionId、traceId 和消息幂等键,避免业务完成但 Agent 页面没有结果。
| 调用方式 | 适用场景 | 关键要求 |
|---|---|---|
| Feign/API | 同步查询、短操作 | 超时、租户透传、错误映射 |
| MQ/事件 | 支付、向量化、解析、审计异步任务 | 幂等键、重试、死信、状态回查 |
| MCP/工具 | Agent 动态发现的能力 | Schema、权限、审计、调用超时 |
| 共享对象存储 | 大文件和产物 | 对象键 ACL、哈希、生命周期 |