核心架构Platform Admin平台运营→Tenant3PL服务商→Owner货主/品牌商→Shop门店/收货点底座yudao-cloud SaaS多租户架构一、SaaS多层级数据隔离模型核心架构1.1 四层数据权限金字塔Level 1: Platform (平台管理员) ├── 管理所有3PL租户 ├── 查看全局营收/系统监控 └── 不涉及具体业务数据 Level 2: Tenant (3PL服务商租户) ← 一个租户就是一个城配公司 ├── 拥有独立的运力池/仓库/员工 ├── 管理下属所有货主Owner ├── 查看本租户所有财务报表 └── 数据与其他3PL租户完全物理隔离 Level 3: Owner (货主/品牌商) ← 3PL的客户如百事可乐、真功夫 ├── 管理自有商品和门店Shop ├── 查看自有库存/订单/账单 └── 数据在本租户内与其他货主隔离 Level 4: Shop (门店/收货点) ← 货主的网点 ├── 仅查看发给自己的订单 └── 仅能签收属于自己的货物1.2 数据库租户隔离策略基于yudao-cloudTenant Isolation: 所有业务表继承tenant_id。Data Permission: 登录用户携带tenant_idMyBatis-Plus 拦截器自动拼接WHERE tenant_id ?。Owner Isolation: 在tenant_id基础上增加owner_id货主ID字段实现租户内多货主隔离。二、SaaS平台运营端Platform Admin平台所有者使用用于管理所有3PL租户。功能模块核心功能点业务意义租户管理​1.3PL入驻开通新的3PL服务商账号租户。2.套餐管理配置租户套餐基础版/专业版/旗舰版限制最大货主数/最大SKU数/最大订单量。3.配额管理分配存储空间/API调用次数/SMS条数。4.状态控制租户启用/禁用/到期提醒。实现SaaS商业化运营控制资源滥用计费与结算​1.租户计费按套餐/按量订单条数/按增值服务收费。2.分账管理平台与3PL的服务费分账如代收货款抽成。3.发票管理向3PL租户开具SaaS服务费发票。4.财务报表全平台GMV/订单量/活跃租户数统计。平台自身的财务闭环系统监控​1.租户监控各租户CPU/内存/DB连接数监控。2.队列监控RabbitMQ/Kafka消息堆积监控。3.慢SQL分析全平台数据库性能优化。4.异常日志全局错误日志归集与分析。保障SaaS平台稳定性公告与工单​1.系统公告向所有租户或指定租户发布维护通知。2.工单系统处理租户报障/需求/咨询。3.知识库帮助文档/API文档/操作视频。提升租户服务体验三、3PL租户端Tenant Portal每个3PL服务商登录后看到的独立管理后台。3.1 租户基础配置3PL个性化功能模块核心功能点业务意义企业信息​1.资质上传营业执照/道路运输许可证/冷链资质。2.品牌定制Logo/登录页背景/主题色白标SaaS。3.域名绑定分配二级域名xxx.otwb.com或绑定独立域名。4.签章管理上传企业电子签章用于合同/回单。塑造3PL专业形象角色权限​1.岗位定义调度经理/仓储主管/财务/客服/司机。2.数据权限控制员工可见范围仅本网点/仅本人订单。3.操作权限控制按钮级权限如财务可见成本调度不可见。适应3PL内部组织架构计费配置​1.报价模板定义仓租/操作费/运费的计价规则。2.分摊规则配置共配分摊权重体积/重量/温层。3.增值服务定义贴标/包装/代收货款的收费标准。4.合同管理与货主签订的电子合同存档。3PL向其货主收费的依据资源池管理​1.自有仓库维护仓库温层/库容/地址。2.自有运力维护车辆/司机/证件/保险。3.外协资源管理挂靠车队/临时运力/价格协议。4.网点管理维护下级配送网点/驿站的容量和时效。3PL核心资产数字化3.2 货主管理Owner Management3PL管理其客户小B品牌商的核心模块。功能模块核心功能点业务意义货主入驻​1.邀请注册3PL发送邀请链接货主自主完善信息。2.资质审核3PL审核货主营业执照/食品经营许可证。3.账号开通为货主分配登录账号可限制IP/设备。4.服务绑定为货主绑定适用的报价模板和服务项目。规范货主准入降低风险货主看板​1.经营概览各货主订单量/库存周转率/毛利率排名。2.贡献分析识别高价值货主VIP和低效货主。3.风险预警监控货主欠费/退货率异常。4.服务评价货主对3PL服务的评分准时率/破损率。辅助3PL进行客户管理和决策数据隔离​1.库存隔离货主A无法查看货主B的库存。2.价格隔离货主A的价格策略不影响货主B。3.单据隔离货主A的单据编号独立生成。4.操作日志记录货主账号的所有操作痕迹。保障货主商业机密四、货主端Owner Portal3PL的客户如康师傅、优衣库使用的门户。功能模块核心功能点业务意义我的商品​1.SKU管理维护自有商品信息条码/规格/温层。2.效期管理设置商品保质期接收临期预警。3.库存查询实时查看在库/在途/冻结库存。4.库存调拨发起仓库间的库存调拨申请。货主掌控自身库存我的订单​1.下单发货向门店/经销商创建发货订单。2.退货管理创建逆向退货单跟踪退货进度。3.订单跟踪查看订单全链路状态在库/在途/签收。4.异常申报对破损/少货/延误订单发起索赔。货主便捷发起物流需求我的账务​1.账单查询查看3PL生成的月度/周度账单。2.在线支付通过微信/支付宝/银企直连支付运费。3.发票申请在线申请开具增值税专用发票。4.费用分析分析物流成本结构仓/运/操。货主财务透明化门店管理​1.门店档案维护收货门店地址/联系人/营业时间。2.配送规则设置门店特定的配送时段/温控要求。3.签收授权维护门店具有签收权限的人员名单。4.满意度评价对每次配送服务进行评分。货主管理下游收货网络五、核心业务系统SaaS化改造5.1 OMS订单中心改造点强化owner_id传递支持货主级个性化规则。功能SaaS化特性订单接入​支持按owner_id隔离API Key防止数据串货。订单规则​支持货主级Owner-level的效期拦截规则、地址黑白名单、配送时段限制。越库预判​算法优先匹配同一owner_id的上下游订单支持跨货主越库需特殊授权。订单池​3PL视角的全局订单池 vs 货主视角的私有订单池。5.2 WMS仓储中心改造点物理共仓逻辑分区精细化货主库存。功能SaaS化特性库位管理​支持库位绑定默认货主default_owner_id也可支持混放需记录owner_id。库存记录​所有库存流水必须记录tenant_idowner_idsku_code。盘点差异​盘点差异自动归属到具体货主生成货主级的盈亏报表。效期管理​临期预警报表支持按货主订阅推送。5.3 TMS运输中心改造点共配分摊的核心发生地。功能SaaS化特性排线算法​输入参数增加owner_id列表支持同温层不同货主拼车。共配分摊​核心功能根据owner_id聚合分摊结果生成每个货主的应收子账单。公式货主A应收 总运费 × (A的体积占比×0.4 A的重量占比×0.3 A的温层系数×0.2 A的点数权重×0.1)电子回单​回单照片关联owner_id货主仅能查看自己的回单。在途监控​轨迹数据对所有相关货主可见脱敏处理如隐藏司机手机号。5.4 BMS计费中心改造点支持“3PL向货主收费”和“平台向3PL收费”两层计费。功能SaaS化特性计费引擎​1.租户级计费平台根据租户的订单量/资源占用收费。2.货主级计费3PL根据与货主的合同约定计费。3.规则隔离不同货主可绑定不同的计费规则模板。账单生成​1.3PL视角一张总账单收入 vs 多张应付账单司机/外协。2.货主视角一张明细账单包含仓租/运费/操作费/增值费。3.分摊明细账单中必须体现共配分摊的详细计算过程。对账核销​支持按货主进行预收充值、信用额度管控、账期管理。六、SaaS化技术架构关键点6.1 数据库表示例强化隔离-- 订单表核心 CREATE TABLE otwb_order ( id BIGINT PRIMARY KEY, tenant_id BIGINT NOT NULL COMMENT 3PL租户ID, owner_id BIGINT NOT NULL COMMENT 货主ID, order_no VARCHAR(64) NOT NULL COMMENT 订单号, shop_id BIGINT COMMENT 门店ID, -- ... 其他业务字段 created_at DATETIME, UNIQUE KEY uk_tenant_owner_no (tenant_id, owner_id, order_no) ); -- 库存表核心 CREATE TABLE otwb_inventory ( id BIGINT PRIMARY KEY, tenant_id BIGINT NOT NULL, owner_id BIGINT NOT NULL, warehouse_id BIGINT NOT NULL, location_code VARCHAR(64), sku_code VARCHAR(64), quantity INT, lock_quantity INT DEFAULT 0, produced_date DATE, expired_date DATE, temp_layer TINYINT, INDEX idx_tenant_owner_sku (tenant_id, owner_id, sku_code) ); -- 共配分摊表 CREATE TABLE otwb_delivery_split ( id BIGINT PRIMARY KEY, tenant_id BIGINT NOT NULL, delivery_task_id BIGINT NOT NULL, owner_id BIGINT NOT NULL COMMENT 被分摊的货主, split_amount DECIMAL(10,2), split_detail JSON COMMENT 分摊因子快照{vol:0.4, wt:0.3, temp:1.2, stop:1}, created_at DATETIME );6.2 缓存与SessionRedis Key设计otwb:{tenant_id}:{module}:{key}。例如otwb:1001:wms:stock:SKU123。Session共享基于Redis的Spring SessionToken中携带tenant_id网关层校验。6.3 API设计内部APIHeader中传递X-Tenant-ID。外部APIURL路径中包含租户标识如https://api.otwb.com/{tenant_id}/order/create或使用独立的API Key关联租户。七、SaaS运营指标体系7.1 平台级指标Platform AdminMRR (月度经常性收入)所有租户月费总和。Churn Rate (流失率)本月流失租户数/上月总租户数。LTV/CAC客户终身价值 / 客户获取成本。资源利用率CPU/内存/存储的平均使用率。7.2 租户级指标3PL视角货主留存率合作的货主数量变化趋势。ARPU (每货主平均收入)租户总收入 / 货主数量。订单密度单位区域内的订单数量决定共配效益。越库率衡量3PL运营效率的核心指标。7.3 货主级指标Owner视角物流成本占比支付给3PL的费用 / 货主销售额。订单满足率3PL准时足量交付的订单比例。库存周转天数货主库存的流转速度。SLA达标率3PL服务承诺的达成情况。八、实施路线图SaaS版阶段一多租户内核改造基于yudao-cloud完成tenant_id全链路透传。开发Platform Admin后台租户管理/计费管理。实现数据隔离数据库/缓存/搜索引擎。阶段二3PL租户端开发开发3PL视角的运营管理功能货主管理/资源池/计费配置。实现BMS两层计费平台收租户 vs 租户收货主。开发货主入驻流程和自助门户。阶段三核心业务SaaS化改造OMS/WMS/TMS支持owner_id逻辑。开发共配分摊引擎SaaS版支持多货主分摊。实现白标功能Logo/域名/主题色。阶段四商业化运营制定SaaS定价策略按单/按月/混合。上线支付/发票/合同功能。总结V6.0版本将系统从企业内部系统升级为行业SaaS平台。核心变化在于引入了Tenant3PL和Owner货主的双重隔离与协作机制。最大的技术挑战在于共配分摊引擎TMS/BMS和库存管理WMS在多货主环境下的准确性和性能。最大的商业价值在于平台可以通过SaaS模式快速复制服务于全省乃至全国的众多区域性城配3PL企业。下一步建议技术评审重点审查多租户数据隔离方案MyBatis拦截器 vs ShardingSphere在高并发下的性能。计费模型细化SaaS平台的两层计费模型平台收租户的钱 vs 租户收货主的钱确保财务逻辑闭环。POC验证选取一个3PL种子客户模拟2-3个货主进行共配分摊的全流程测试。