项目接入职责
项目接入层将自己的业务能力映射到掌序可调用的查询、操作和事件。它是业务规则的入口,不只是一个连接地址。
最小接入范围
先选择一个只读场景,例如经营摘要或业务列表。定义其输入、输出、权限和错误,再实现项目后端与真实数据的映射。
| 层次 | 需要提供 |
|---|---|
| 项目后端 | 明确的查询/操作 handler、身份校验、存储适配及业务规则 |
| 接入配置 | 项目与环境、动作清单、摘要主题、目标函数 |
| 部署产物 | 依赖完整且可核对摘要的 ZIP |
| 验证材料 | 成功、无权限、空数据、失败与重复请求的结果 |
数据流
摘要采用上报或快照用于概览;明细通过已批准的查询按需读取。状态变化需要事件和恢复策略,不能只依赖偶然触发的一次上报。
业务写操作继续使用项目自己的幂等机制和事务。响应丢失时先查询结果,不把未知响应当作未执行。
项目授权与接口权限
声明的动作必须在项目端真正实现。连接允许某动作、当前账号有权执行、业务条件允许执行,都需要分别成立。
不要接受客户端自报的 actor、角色或内部调用标志作为身份依据。连接密钥与云配置仅放在受保护的服务端配置中。