三方物流平台(3PL)业务技术方案(基于wms-ruoyi)

发布时间:2026/5/23 15:37:07

三方物流平台(3PL)业务技术方案(基于wms-ruoyi) 一、项目背景与定位1.1 背景中小三方物流3PL普遍存在多货主隔离难、仓运配脱节、计费对账复杂、库存追溯弱、数字化成本高五大痛点。本方案基于开源项目wms-ruoyiRuoYi-Vue-Fast 架构快速扩展打造多货主 WMSTMSOMS 计费结算一体化平台满足 3PL“一仓多客、仓运协同、按单计费、全程追溯” 核心需求。1.2 定位基础复用 wms-ruoyi 成熟仓储能力多仓库 / 库区、批次 / SN / 效期、条码打印、库存台账。扩展新增多货主隔离、订单管理OMS、运输管理TMS、智能计费、货主门户、PDA 作业六大模块。目标低成本、快速落地支撑10 货主、日单 500、多仓协同、运配全程可视的中小 3PL 业务。1.3 核心价值多货主隔离数据 / 权限 / 库存 / 报表完全隔离避免货主间数据混淆。仓运一体化订单→仓储→运输→签收→结算全流程打通减少人工对接。智能计费按货主合同自动计算仓储费、操作费、运输费、增值服务费。全程追溯批次 / SN / 入库 / 出库 / 运输 / 签收全链路追踪满足货主审计需求。降本增效开源底座 低代码扩展缩短实施周期、降低 license 成本。二、业务架构设计OWTB 模型采用订单OMS 仓储WMS 运输TMS 计费Billing一体化架构覆盖 3PL 全业务链。2.1 核心业务流程货主下单OMS货主通过门户 / API 下达入库 / 出库 / 调拨 / 退货订单系统自动校验库存 / 信用额度。仓储执行WMS入库收货→质检→上架→库存入账→生成批次 / 条码。出库拣货→复核→打包→出库→库存扣减→联动 TMS 派单。库内移库→盘点→批次调整→库存冻结 / 解冻。运输配送TMS运单生成→智能调度运力匹配→司机 APP 接单→在途跟踪→签收→回单上传。计费结算Billing按合同规则自动计费→生成对账单→货主确认→收款→财务对账。数据看板BI货主看板库存 / 订单 / 费用、运营看板仓容 / 履约率 / 毛利、司机看板运单 / 轨迹 / 收入。2.2 多货主模型设计核心货主隔离维度数据隔离所有业务表订单 / 库存 / 单据加owner_id货主 ID查询自动过滤。权限隔离RBAC 数据权限货主仅可见自身数据管理员全局可见。库存隔离wms_inventory按owner_idwarehouse_idmaterial_id唯一货主库存独立核算。配置隔离货主独立配置条码模板、打印模板、计费规则、预警阈值。货主档案货主编码 / 名称 / 联系人 / 地址 / 结算方式 / 信用额度 / 合同附件 / 计费模板。三、技术架构设计基于 wms-ruoyi3.1 技术栈复用 扩展后端Java核心框架Spring Boot 2.7.x Spring Security Redis JWT复用 wms-ruoyi。ORMMyBatis 分页插件复用。扩展组件多租户隔离自定义拦截器 数据权限插件新增。运输模块TMS 服务运单 / 调度 / 轨迹新增。计费引擎规则引擎Groovy / 表达式解析新增。消息推送WebSocket 短信 邮件新增。地图服务高德 / 百度地图 API轨迹 /geocoding新增。前端Vue核心框架Vue3 Element Plus Vite复用 wms-ruoyi advance 分支。扩展模块货主门户独立登录 专属看板 订单管理 费用查询新增。TMS 前端运单管理 调度看板 轨迹地图 司机管理新增。PDA 作业Vue3uniapp兼容安卓支持扫码 / 拍照 / 离线作业新增。可视化大屏ECharts 地图可视化展示仓容 / 运单 / 履约率新增。数据库MySQL 8.0核心库wms_ruoyi原有表 新增货主 / 订单 / 运输 / 计费表。缓存Redis 6.2库存缓存、会话缓存、分布式锁。存储MinIO单据附件、回单照片、轨迹文件新增。3.2 系统模块划分1. 基础模块复用 wms-ruoyi系统管理用户 / 角色 / 菜单 / 权限 / 日志。基础资料仓库 / 库区 / 货架、物料 / 分类 / 单位、供应商 / 客户。条码打印入库单 / 出库单 / 物料标签 / 批次标签Lodop 网页打印。2. 多货主管理模块新增货主档案新增 / 编辑 / 禁用 / 合同管理。货主配置条码模板、打印模板、预警规则、计费规则。数据权限货主数据隔离、角色分配、菜单可见性。3. OMS 订单管理模块新增订单类型入库订单、出库订单、调拨订单、退货订单。订单生命周期创建→审核→执行→完成→关闭→作废。订单关联订单→入库单 / 出库单→库存→运单→费用。订单预警超期未执行、库存不足、异常订单提醒。4. WMS 仓储作业模块复用 增强入库管理采购入库、退货入库、货主入库增强多货主支持。出库管理销售出库、领料出库、货主出库增强多货主支持。库内管理移库、盘点、库存调整、批次管理、SN 管理复用。库存管理实时库存、库存明细、库存流水、库龄分析、库存预警增强多货主隔离。5. TMS 运输管理模块新增运力管理承运商、车队、司机、车辆档案证件 / 保险 / 状态。运单管理运单创建、审核、派单、装车、在途、签收、回单。智能调度自动匹配司机 / 车辆、路线优化、配载计算重量 / 体积。在途跟踪GPS 轨迹、实时位置、温度监控冷链、异常上报。回单管理电子回单上传、审核、归档、对账凭证。6. 计费结算模块新增计费规则按货主配置仓储费按托 / 件 / 体积 / 天、操作费入库 / 出库 / 打包、运输费重量 / 体积 / 里程 / 阶梯价、增值服务费贴标 / 组装 / 质检。自动计费定时任务按规则生成费用单关联订单 / 运单 / 库存。对账单管理费用汇总、对账单生成、货主确认、开票管理。财务结算收款登记、核销、对账、毛利分析。7. 货主门户模块新增专属看板库存汇总、订单状态、费用明细、履约率。订单操作下单、查询、取消、跟踪、导出。库存查询实时库存、批次 / 效期、库龄、流水。费用管理费用单查询、对账单确认、开票申请。8. PDA 作业模块新增入库作业扫码收货、质检、上架、批次录入。出库作业扫码拣货、复核、打包、装车确认。库内作业移库、盘点、库存调整、条码打印。运输作业司机接单、扫码装车、在途打卡、签收、回单上传。3.3 核心数据库模型扩展设计原有核心表复用新增 owner_idwms_warehouse仓库不变。wms_material物料不变。wms_receipt入库单新增 owner_id。wms_receipt_item入库明细新增 owner_id。wms_shipment出库单新增 owner_id。wms_shipment_item出库明细新增 owner_id。wms_inventory库存新增 owner_id联合主键 owner_idwarehouse_idmaterial_idbatch_no。wms_inventory_history库存流水新增 owner_id。新增核心表货主表wms_ownerowner_id BIGINT PK, -- 货主ID owner_code VARCHAR(32) UNIQUE, -- 货主编码 owner_name VARCHAR(64), -- 货主名称 contact VARCHAR(32), -- 联系人 phone VARCHAR(20), -- 联系电话 address VARCHAR(255), -- 地址 settle_type TINYINT, -- 结算方式1月结 2周结 3现结 credit_limit DECIMAL(10,2), -- 信用额度 status TINYINT, -- 状态1正常 0禁用 create_time DATETIME, update_time DATETIMEOMS 订单表oms_orderorder_id BIGINT PK, order_no VARCHAR(32) UNIQUE, -- 订单号 owner_id BIGINT, -- 货主ID order_type TINYINT, -- 1入库 2出库 3调拨 4退货 warehouse_id BIGINT, -- 仓库ID status TINYINT, -- 1暂存 2审核 3执行中 4完成 5作废 total_qty DECIMAL(10,2), -- 总数量 total_amount DECIMAL(10,2), -- 总金额 receiver_id BIGINT, -- 关联入库单ID shipment_id BIGINT, -- 关联出库单ID transport_id BIGINT, -- 关联运单ID create_by VARCHAR(32), create_time DATETIME, update_time DATETIMETMS 运单表tms_transporttransport_id BIGINT PK, transport_no VARCHAR(32) UNIQUE, -- 运单号 order_id BIGINT, -- 关联订单ID owner_id BIGINT, -- 货主ID carrier_id BIGINT, -- 承运商ID driver_id BIGINT, -- 司机ID vehicle_id BIGINT, -- 车辆ID from_address VARCHAR(255), -- 出发地 to_address VARCHAR(255), -- 目的地 weight DECIMAL(10,2), -- 重量 volume DECIMAL(10,2), -- 体积 freight DECIMAL(10,2), -- 运费 status TINYINT, -- 1待派单 2已派单 3运输中 4已签收 5已回单 sign_time DATETIME, -- 签收时间 receipt_photo VARCHAR(255), -- 回单照片 create_time DATETIME, update_time DATETIME计费规则表bill_rulerule_id BIGINT PK, owner_id BIGINT, -- 货主ID rule_type TINYINT, -- 1仓储费 2操作费 3运输费 4增值服务费 charge_unit VARCHAR(16), -- 计费单位托/件/吨/方/天 price DECIMAL(10,2), -- 单价 min_charge DECIMAL(10,2), -- 最低收费 status TINYINT, create_time DATETIME费用单表bill_feefee_id BIGINT PK, fee_no VARCHAR(32) UNIQUE, owner_id BIGINT, order_id BIGINT, -- 关联订单 transport_id BIGINT, -- 关联运单 rule_id BIGINT, -- 关联规则 fee_type TINYINT, qty DECIMAL(10,2), -- 计费数量 amount DECIMAL(10,2), -- 费用金额 status TINYINT, -- 1待确认 2已确认 3已开票 4已收款 confirm_time DATETIME, create_time DATETIME四、核心功能详细设计4.1 多货主隔离实现数据层所有业务表加owner_idMapper 层自动拼接where owner_id #{ownerId}避免硬编码。权限层基于若依数据权限插件货主角色仅分配自身owner_id数据权限管理员分配全部权限。接口层统一拦截器从 Token 中解析owner_id自动注入请求上下文接口无需传参。4.2 智能计费引擎设计规则配置货主维度配置计费规则支持固定单价、阶梯单价、按天计费、最低收费等模式。自动计费定时任务每日凌晨扫描完成的订单 / 运单匹配货主规则自动生成费用单。费用核算支持手动调整、费用减免、合并开票满足货主特殊需求。4.3 仓运协同流程设计出库单审核通过后系统自动生成运单关联出库单信息。调度员在 TMS 模块进行智能派单分配司机 / 车辆。司机 APP 接收运单扫码装车系统自动扣减库存。运输途中实时上传 GPS 轨迹异常情况堵车 / 破损及时上报。客户签收后司机上传电子回单系统自动更新运单状态。运单完成后自动触发计费生成运输费用单。4.4 PDA 离线作业设计离线缓存PDA 作业数据订单 / 库存 / 条码本地缓存断网时可正常作业。自动同步网络恢复后自动上传作业数据同步服务器库存 / 订单状态。扫码适配支持一维码 / 二维码扫描兼容主流 PDA 设备安卓。五、部署方案5.1 部署架构开发环境本地部署JDK17MySQL8.0Redis6.2IDEA。测试 / 生产环境Docker 容器化部署Nginx 反向代理前后端分离部署。服务器配置生产后端2 核 4G×2负载均衡。数据库4 核 8G×1主从复制。Redis2 核 4G×1集群。文件存储2 核 4G×1MinIO。5.2 实施步骤环境搭建部署基础环境JDK/MySQL/Redis导入 wms-ruoyi 基础 SQL。代码扩展基于 wms-ruoyi advance 分支新增多货主 / OMS/TMS/ 计费模块代码。数据库扩展执行新增表 SQL配置多货主数据隔离。前端开发开发货主门户、TMS 前端、PDA 作业页面。联调测试单元测试→接口联调→业务流程测试→性能测试。上线部署生产环境部署数据迁移用户培训试运行。六、风险与应对6.1 技术风险风险多货主隔离不彻底数据泄露。应对严格数据权限设计代码审计测试环境模拟多货主场景验证。风险高并发下库存超卖。应对库存操作加分布式锁扣减前校验库存事务回滚机制。6.2 业务风险风险计费规则复杂对账错误。应对规则配置可视化自动计费日志可追溯支持手动核对调整。风险仓运协同脱节履约延迟。应对流程自动化节点超时预警异常工单及时提醒。七、项目优势低成本落地基于开源 wms-ruoyi无需支付 WMS 授权费二次开发成本低。快速迭代若依框架低代码能力代码生成器快速开发新模块缩短实施周期。成熟稳定复用 wms-ruoyi 经过验证的仓储核心能力减少 bug 风险。高度可扩展模块化设计支持后续扩展WCS 自动化设备对接、RFID 盘点、跨境物流、财务系统对接等功能。全链路追溯批次 / SN / 仓 / 运 / 费全流程追踪满足 3PL 货主审计与合规需求。八、总结本方案基于wms-ruoyi开源项目通过多货主隔离、OMS 订单、TMS 运输、智能计费、货主门户、PDA 作业六大模块扩展构建了一套低成本、成熟稳定、高度可扩展的三方物流平台。方案覆盖 3PL “仓运配结算” 全业务链解决行业核心痛点适合中小三方物流企业快速数字化转型。

相关新闻