把变化留在边缘,把公共骨架固定下来
- 接口先标准化,避免每个客户改协议。
- 数据库先标准化,避免每个项目重画表结构。
- 模板先标准化,避免客户自己猜该准备什么。
- 差异放在适配器和映射层,不反复改核心。
Boundary
标准接口:query / feedback / sync / schema / health
标准数据:知识资产、会话记忆、反馈、学习任务、审计事件
标准模板:菜单映射、权限映射、知识导入
标准返回:answer + steps + warnings + sources + learningImpact
标准适配:宿主系统负责把自己的字段翻译到标准协议
Domain Model
按 softwareId 区分不同软件产品。不同软件的菜单结构、术语和业务逻辑不能混在一起。
按 tenantId 区分客户或组织实例。即便是同一套软件,不同租户的菜单开通、规则和知识也可能不同。
按 userId、roleCodes、permissionCodes 收口权限上下文。智引不接账号密码,只消费宿主给出的可信上下文。
Deployment
最稳妥。知识、反馈、审计与宿主业务库隔离,升级和迁移边界清楚,也方便未来多项目复用。
适合客户运维约束较强的场景,但仍要保持 Ziin 自己的表结构和版本治理,不要混进宿主核心业务表。
短期看省事,长期会导致知识、反馈、审计与业务表互相污染,后续升级、迁移和跨项目复用都很难做。
Delivery Pack
SQL、模板、接入清单、2 天接入流程和公开文档链接。
菜单清单、权限码、试点模块、手册/FAQ/错误库、宿主 token 上下文字段。
因为绝大多数业务系统接入时都会遇到菜单不统一、权限不统一、文档不统一、部署不统一这四个问题。
Standard Layers
统一 query、feedback、sync、schema、health 契约,让 Web、App、小程序、宿主智能体共用一套能力出口。
统一知识、记忆、学习任务、审计事件模型,避免每接一个客户就重画数据库。
宿主系统只负责把自身菜单、权限、术语和路由翻译到标准模型,不碰核心返回结构。
通过 SQL、模板、清单、示例代码和运营台,形成可重复交付的产品包。