| 多家承运商各自有 API、报价规则、面单格式 | 统一对接 10+ 上游渠道，一套界面完成比价、下单、打单 |
| 折扣价体系复杂（分区、重量段、附加费、燃油附加费） | 内置计费引擎：价格模板 + 分区/重量段/附加费/燃油费率 + 偏远/超规规则 |
| 聚合商发展代理商分销，代理又发展自己的客户，多级分润对账困难 | 多级代理商体系 + 点位定价链，每级利润实时入账 |
| 客户预充值扣费，充值、扣款、退款、冻结对账复杂 | 钱包账户体系 + 财务明细流水 + 预冻结三段式扣款 |
| 面单上承运商信息需要按客户定制（隐藏发货人等） | 面单覆盖/遮挡引擎（PDF 规则化覆写） |
| 大客户要系统级对接 | 开放 API（appKey/appSecret + 签名 + Token） |
### 3.1 渠道与供应商管理
- **渠道组/渠道/渠道服务三级结构**：渠道组归属供应商（铭腾 MT、环至美 HZM、嘉谷万邑 JGWY、跨销宝 KXB、航南 HN、通邮 TY、OMS、StraightShip、SLM 等），每个供应商账号独立 token 管理
- **供应商多账号**：同一供应商下按大客户开通独立账号（如 MT_JD、MT_WKL、HZM_NEW、HZM_4L、HZM_JD、HZM_WKL），按**渠道组名**路由到对应 token 与计费身份
- **api_config 表驱动的接口地址**：上游接口 URL/路径存库，无需改代码即可调整
### 3.2 询价报价
- **实时比价**：并发调用各上游报价接口（多发货地并行询价），自动取最优
- **双定价模式**：
- **价格模板**：平台为账户配置费用模板（分区 × 重量段 × 单价 + 附加费），模板价即该账户的采购成本价
- **点位（返点加价）**：`客户价 = 成本价 ÷ (1 − 点位%)`，沿代理链**逐级复利上浮**
- **模板+点位组合**：代理商 A 配模板、下游 C 配点位时，C 的底价自动取**上级代理商的模板价**再套点位（模板利润向下游传导，询价展示价与下单扣费价一致）
- 偏远地区附加费（DAS/EAS/RAS/SAS）、超长超重附加、住宅地址识别（航南地址解析接口）、燃油附加费自动重算
- 报价记录落库，下单时直接引用
### 3.3 订单管理（打单）
- **单笔/批量下单**：大包订单、小包订单（通邮/OMS）、SSL 批量导入下单、Excel 批量导入（各渠道）
- **下单流程**：客户单号查重 → 预冻结资金 → 调上游"创建订单+获取面单" → 面单覆盖处理 → 确认实扣 → 订单落库
- **订单状态机**：异常(0)/已打印(1)
| 语言/框架 | Java 21、Spring Boot 3.5.11（Web/Validation/Actuator/Mail/Redis） |
| ORM | MyBatis-Plus 3.5.15 + mybatis-plus-join + PageHelper 分页 |
| 数据库/缓存 | MySQL 8（Druid 1.2.23 连接池）、Redis（Lettuce 池化） |
| 任务调度 | XXL-Job 3.4.2（独立 admin 控制台） |
| 认证 | JWT（java-jwt，HS256）：Web 端 3 天 / 开放 API 1 小时 |
| 文档 | SpringDoc OpenAPI（Swagger UI） |
| PDF | iText7 7.2.5（覆写）、PDFBox 2.0.30（解析渲染） |
| Excel | EasyExcel 4.0.3（导入导出） |
| 工具 | Hutool 5.8.40、Guava、MapStruct（待启用）、fastjson 1.2.83 |
| 构建/CI | Maven、Jenkins（构建 + 部署脚本） |
评论