架构设计
本章介绍柠檬跨境ERP 的整体架构和关键设计。阅读顺序建议:先看 模块与依赖 了解电商模块如何复用仓库、供应链、财务,再看 连接器设计、OAuth 授权与凭证加密、同步与定时任务 了解第三方平台的接入方式,最后按需阅读其他页面。
| 页面 | 内容 |
|---|---|
| 模块与依赖 | Gradle 模块、单向依赖、模块间契约,电商业务与仓库 / 供应链 / 财务的联动 |
| SaaS 多租户 | 共享库按租户隔离、租户套餐与行业模板、新租户初始化 |
| 权限与店铺数据权限 | 菜单 / 按钮 / 接口权限、部门数据权限、按店铺隔离电商数据、内置角色 |
| 连接器设计 | 渠道、刊登、客服、广告、物流商、海外仓、1688 七类连接器的 SPI |
| OAuth 授权与凭证加密 | 授权回调、签名 state、外网地址、授权信息加密与只写不读 |
| 同步与定时任务 | 拉单、回传发货与库存、同步商品、令牌维护、同步日志、全部电商定时任务 |
| 利润口径与多币种 | 原币与本位币、费用两阶段、头程与尾程成本、费用分摊、两种利润口径 |
| 工作流 | Flowable 集成、设计器到 BPMN、业务单据接入审批 |
设计原则
- 电商模块不另建库存和往来:店铺对应一个客户,平台订单出库就是销售出库单,退货入库就是销售退货单,头程货件就是在途调拨单,平台结算生成收款单。库存、成本、应收、凭证都由 wms / scm / fin 原有机制处理,电商模块只负责平台侧的数据和利润口径。
- 平台 SKU 与物料解耦:订单只记平台 SKU,出库时按在线商品的映射换成物料(含多件装、组合商品),映射改错可以重新匹配。
- 外部调用不在事务中:平台、海外仓、物流商、大模型的接口在事务之外调用;批量出库、定时同步逐条处理,每条一个事务,一条失败不影响其他;同步按业务键幂等,重复拉取不会重复入库。
- SPI 按能力声明:每类第三方对接是一个接口,实现类声明授权字段、正式 / 沙箱地址和支持的能力,页面按声明动态生成表单和按钮,新增平台不改页面。