跳到主要内容
版本:开发中

项目接入职责

项目接入层将自己的业务能力映射到掌序可调用的查询、操作和事件。它是业务规则的入口,不只是一个连接地址。

最小接入范围​

先选择一个只读场景,例如经营摘要或业务列表。定义其输入、输出、权限和错误,再实现项目后端与真实数据的映射。

层次需要提供
项目后端明确的查询/操作 handler、身份校验、存储适配及业务规则
接入配置项目与环境、动作清单、摘要主题、目标函数
部署产物依赖完整且可核对摘要的 ZIP
验证材料成功、无权限、空数据、失败与重复请求的结果

数据流​

摘要采用上报或快照用于概览;明细通过已批准的查询按需读取。状态变化需要事件和恢复策略,不能只依赖偶然触发的一次上报。

业务写操作继续使用项目自己的幂等机制和事务。响应丢失时先查询结果,不把未知响应当作未执行。

项目授权与接口权限​

声明的动作必须在项目端真正实现。连接允许某动作、当前账号有权执行、业务条件允许执行,都需要分别成立。

不要接受客户端自报的 actor、角色或内部调用标志作为身份依据。连接密钥与云配置仅放在受保护的服务端配置中。

下一步​

已有适配器与冻结产物后使用接入教程。需要业务页面时,在已有查询动作之上开发声明式插件。