专线TMS管理系统产品系统

1、立项原因：跨境物流货代长期依赖 Excel 和多套零散表格管理运单、整柜、派送与应收应付，普遍存在运单状态分散在多人手中、整柜（提单）与运单归属靠人工核对、几千票批量操作时系统卡顿、业务单据与财务结算脱节、多客户共用系统导致数据混看等问题。立项目标是做一套覆盖「揽收—集货—整柜出运—拆柜—派送—签收—结算」全链路的物流管理系统，用统一数据模型把运单、提单、仓库、派送、财务串联起来，减少人工对账与错单。

2、行业场景与业务背景：面向跨境电商物流中的澳洲专线 / 集运货代及海外仓企业。业务特点是「小票集货、整柜出运」：国内揽收后按柜（提单）集货，海运到港后拆柜、入仓、按派送区域分车派送，最终按客户与代理分别结算应收应付。系统需同时服务货代内部操作人员、海外仓作业人员与客户三类角色，并支持多租户（多分公司/多客户）数据隔离运营。

1、功能模块：运单管理、整柜/提单管理、仓库作业、派送管理、财务结算、报价管理、基础资料、系统与权限、数据看板。

2、主要功能描述： ① 运单管理：下单与批量导入（标准运单 / FBA 装箱单）、模板化导出、面单打印与 PDF 合并、子单/箱唛/卡板/柜号提单号批量设置、批量预报/收货/派送、轨迹自动抓取、澳洲地址校验、回收站； ② 整柜与提单：主单/分提单、装柜明细、柜号与船名航次、到港拆柜、整柜费用分摊与结算； ③ 仓库作业：扫码收货、批量确认收货、入仓/出库、库位管理、集袋装箱与拆袋、仓库运单分组统计； ④ 派送管理：派送阶段流转、地图派送规划与派送顺序编排、签收凭证（POD）、地址校验； ⑤ 财务结算：按重量/方数/件数/分区计费，燃油附加、预估与实收、客户结算与代理成本结算、账单、收款核销、发票、预扣管理； ⑥ 基础资料与配置：客户/代理/承运商/渠道/仓库/站点、下单与查件接口配置（认证方式、字段映射可视化配置）、标签模板设计器、字段/列/筛选设置； ⑦ 系统与权限：多租户、用户/角色/权限组（菜单级 + 按钮级）、操作日志、开放 API 凭据； ⑧ 数据看板、报表与 AI 查询助手。

1、"我"负责的具体任务：负责系统整体架构与数据库模型设计；独立完成运单、提单、仓库作业、派送、财务结算等核心模块的后端服务与前端页面；实现批量导入导出、面单打印与标签模板、第三方下单/查件接口对接；负责性能优化（大批量操作的 SQL 批处理、列表查询瘦身）、多租户改造及上线部署运维。

2、技术栈与架构：后端 Spring Boot 3.2.5 + Java 17 + MyBatis-Plus + MySQL，Sa-Token 做认证授权，dynamic-datasource 支撑多租户，EasyExcel/POI 处理导入导出与 PDF 合并；前端 React 18 + Vite 5 + Ant Design 5 + zustand，Leaflet 实现地图派送。前后端分离、按业务域分层（Controller-Service-Mapper），配置化的第三方接口引擎。

3、实现亮点与难点： ① 多租户：采用「全局平台库 + N 个租户业务库」的动态数据源方案，通过租户上下文与拦截器自动路由，解决跨库读取平台级接口配置时事务绑定导致的切库失效问题； ② 大批量性能：把批量单号设置从「逐行查询 + 逐票更新」重构为「一次 IN 预取 + 按目标值分组批量 UPDATE」，N+1 往返降为常数条 SQL，数千票操作从分钟级降到秒级； ③ 接口对接：将下单/查件接口做成可配置（请求响应字段映射、OAuth2/MD5 签名/API Key/厂商特殊签名），新增承运商无需改代码；面单 PDF 逐页合并、打印 Agent 支持本地静默打印； ④ 数据可核对：批量输入单号时返回「命中/未命中」对账回执并可一键复制，解决用户只能回 Excel 人工比对的痛点。