模块与依赖
模块依赖
模块依赖只允许单向,由各模块的 build.gradle 声明、Gradle 强制,不能形成循环:
wms ← scm ← fin ← ecom:电商依赖财务、供应链、仓库;system ← monitor ← dashboard;workflow、ai只依赖 framework。- 上游需要下游的能力时,由 framework 定义接口或事件、下游模块实现。例如电商取汇率用
framework/finance/ExchangeRateProvider(财务实现),校验负责人用framework/org/UserLookup(系统实现),工作流用framework/workflow/FlowApi,AI 问数工具实现framework/ai/AiTool。 - 跨模块访问数据:Java 代码只注入本模块的 Mapper,读写其他模块的表一律调用所属模块的 Service。例如订单出库调用
ScmTradeDocService.create生成销售出库单,头程货件发运调用WmsStockDocService.createConfirmed生成在途调拨单,平台结算调用FinSettlementService.create生成收款单。mapper XML 中跨模块的只读 JOIN(看板、利润报表、进销存报表)允许保留,写操作必须经过所属模块的 Service。
业务联动
- 由业务单据生成的仓库单据保存即确认,
wms_stock_doc.source_no记录来源单号;库存不足、序列号不在库等错误会让整张业务单据回滚。平台订单批量出库时每张订单一个事务,失败的订单记为异常并返回原因。 - 平台订单出库生成的销售出库单不能修改删除,订单层面的撤销走退货退款。
- 店铺新建时自动建立对应的客户(编码
ST-店铺编码,改名同步),平台订单的出库、应收都挂在它下面;平台结算的净额生成收款单核销这个客户的应收,平台费用作为折让,多出部分转预收。 - 头程货件发运生成在途调拨单(调入平台仓或海外仓),签收后调拨收货;运费、关税、其他费用 ÷ 数量为单件头程成本,计入平台配送订单的物流成本。
- 海外仓的入库、一件代发、退件、调拨同样落到 ERP 的在途调拨、销售出库、销售退货上,见 新增海外仓 / 物流商。
模块内的公共机制
| 机制 | 位置 | 说明 |
|---|---|---|
| 引用检查 | framework/ref/ReferenceChecker | 物料、仓库、客户、供应商、用户被店铺、在线商品、订单、货件、物流渠道引用时不能删除(EcomReferenceChecker + EcomRefMapper.xml) |
| 往来单位合并 | framework/ref/PartnerMergeHandler | 合并客户 / 供应商时迁移店铺对应的客户、物流渠道的供应商(EcomPartnerMergeHandler) |
| 首页待办 | framework/todo/TodoProvider | 待处理 / 异常 / 逾期未发货订单、在途货件、待处理退货等(EcomTodoProvider) |
| 单据编号 | DocNoService | 头程货件 HJ、退货退款 TK、采购计划 CJ、开发项目 KF、海外仓单据 OWI / OWO / OWR / OWT 等,在 EcomDocNos 等类中声明 |
| AI 问数工具 | framework/ai/AiTool | 电商销售与利润、补货建议(EcomSalesTool、EcomReplenishTool) |