专业技术 · 导游

扩展和定制集成

选择外部后端服务,嵌入式ReactUI和服务器端市场或交付模块.

5 部分开发人员指南

→

大多数集成应该从使用公开API的外部后端开始.用户必须直接在SelSup内操作该功能时,嵌入式UI是合适的.

应用程序开发人员和技术合作伙伴

选择集成类型

开始用一个薄的垂直切片

首先实现一个完整的工作流程及其可观察性. 调整后添加大量进口,UI和更多事件类型是稳定的.

存储代币在秘密管理器中,只从后端调用SelSup. 浏览器应用程序应该与API交谈,并且永远不会接收SelSup代币.

隔离SelSup适配器,工作队列和域名模型.

对于进来的事件使用收件箱和出发的变更,使用输入箱.

数据流 · Text

SelSup webhook → inbox → domain worker → ERP/WMS
ERP/WMS change → outbox → SelSup API → reconciliation

组件运行在SelSup接口内.外部域必须允许 selsup.ru 的请求并正确处理浏览器限制.

永远不要将永久的 API 代币放入包中.通过后端和扩展架构定义的短暂用户背景进行特权工作.

匹配产品交互模式,覆盖可访问的空格,加载和error状态.

无限使用

允许的源控制浏览器访问,但不验证用户. 每个敏感操作仍然需要服务器方面的权限检查.

演示组件 · URL

https://github.com/SelSup/component

交付服务通常包括代币,卡片,价格,股票,订单和背景状态更新.

本模块改变了主要SelSup后端,并遵循其审查,测试,本地化和发布过程. 在实施之前,同意接口和数据界限.

将外部API故障转换为稳定的ApplicationError值和撤销或无效的外部代币,根据后端项目规则转换成AccessException.

共享数据兼容性

没有添加市场特定的领域到共享实体. 保持原始合同的集成DTO和地图它们在边界.