开发指南后端应用开发
后端应用开发
把工作区后端项目主线发布为不可变版本,并通过 Hosted Service 部署为稳定 API。
后端应用用于承载业务规则、数据处理、外部系统集成和稳定 API。本文所说的后端应用,是从工作区项目主线发布不可变语义版本、由 Hosted Service 管理环境和部署的独立服务。
它不等同于:
- 平台应用:面向用户的工作区入口。
- 运行时模块:由 Bundle 物化到 App Runtime、通过模块方法调用的能力单元。
- 平台基础服务:由平台发布系统管理的控制面或运行时基础设施。
标准生命周期
项目源码
-> 主线 HEAD 与 Cargo package.version
-> Release Operation
-> 不可变 hosted_service_release
-> Project Environment
-> Deployment
-> 稳定 Endpoint
-> 健康与业务验证后端应用可以被平台应用、网站、智能体、模块、工作流或外部系统调用。调用方身份、服务 token 和业务用户身份需要分别设计,不能只依赖“知道 URL”作为权限控制。
多租户后端需要随 Bundle 生命周期开通租户或解除绑定时,应同时设计供插件管理服务调用的入口。 AI 在生成清单和服务 listener 前,先阅读 业务、管理与插件生命周期入口, 明确业务、人工管理和平台生命周期各自的路由、凭据与权限。
后端应用独立交付
后端项目版本和 Hosted Service Deployment 不进入 Bundle。Bundle 中的模块可以调用 后端 Endpoint;高级 Bundle 的生命周期插件也可以引用已注册的插件服务,但后端发布 状态必须单独验证。
继续阅读: