核心功能模块
围绕"录得进、算得清、对得准、导得出"四条主线，覆盖专线物流月底对账的完整闭环。
运单导入与管理
按业务日期录入运单：运单号、客户名称、出发地、目的地、货量与单位、应收运费、备注共 11 个字段，运单号唯一校验防重复，支持按月份与客户筛选。
费用录入
司机运费、油费、过路费、装卸费、其他 5 类费用分类记账，金额必填校验；每笔费用可绑定运单形成单票成本，也可作为公共费用独立记录。
自动对账
支持按客户对账与按月对账两种视图，系统自动汇总应收、支出与净利润，无需手工加总，结果可逐笔下钻到明细。
差异追溯
对账结果与明细表联动，哪一单、哪一笔费用导致差额一目了然；结合备注字段记录异常原因，快速定位并修正对账差异。
报表生成
客户对账行与月度对账行均包含应收 / 支出 / 净利润三指标，自动生成对账汇总卡片与明细表，替代手工 Excel 汇总公式。
4 种 Excel 导出
基于 Apache POI 一键导出运单明细 / 费用明细 / 客户对账表 / 月度对账表四类标准 Excel，可导出全部或按月份筛选数据，直接用于对账与归档。
多承运商 / 多客户
客户名称维护为统一下拉选项，支持多客户并行对账；同一平台可管理专线日常的多个客户与多条线路，避免名称不一致导致的对账错乱。
权限管理
前后端分离架构，后端统一响应包装与全局异常处理，接口按业务域划分；标准版提供账号登录，私有化版可基于源码扩展多账号 / 子账号与角色权限。
数据总览看板
首页展示本月应收 / 支出 / 毛利三张统计卡片，并给出近 3 个月毛利趋势，经营状况一屏掌握，异常月份及时预警。
数据校验与健壮性
运单号唯一、金额必填、日期与枚举校验均在后端强制；统一响应结构与全局异常捕获让操作有明确反馈，避免脏数据流入对账结果。
技术架构（前后端分离 · 四层结构）
🖥️ 前端
- · Vue 3 组合式 API
- · Element Plus 中文组件库
- · Vite 构建 / 热更新
- · Vue Router 四页面路由
- · Axios 统一 API 封装
⚙️ 后端
- · Spring Boot 2.5.3
- · Java 8 运行环境
- · Spring Data JPA 数据访问
- · 统一 Result<T> 响应包装
- · 全局异常处理 + 参数校验
🗄️ 数据
- · MySQL（utf8mb4）
- · 运单表（11 字段）
- · 费用表（7 字段，运单可空）
- · JPA 自动建表（ddl-auto: update）
- · Apache POI 5.2.3 导出 Excel
🚀 部署
- · 私有化部署，数据不出企业
- · 后端 Maven 打包 / spring-boot:run
- · 前端 npm run build 静态托管
- · 开发环境代理 /api → localhost:8080
- · 普通 Linux / Windows 服务器即可运行
常见问题
关于物流对账工具 LogisticsReconciliation 的常见疑问与解答
物流对账工具主要解决什么问题？
它面向专线 / 三方小物流老板，解决月底对账算不清、运费费用杂的痛点。把运单、费用集中录入后，系统自动按客户和月份汇总应收、支出与净利润，一张表看清谁欠多少、每个月赚多少，不再靠手工 Excel 反复核对。
支持哪几种 Excel 导出？
支持 4 种一键导出：运单明细、费用明细、客户对账表（按客户汇总应收 / 支出 / 净利润）、月度对账表（按月汇总应收 / 支出 / 净利润），可导出全部或按月份筛选的数据，直接用于对账与归档。
费用有哪些分类？可以记录公共费用吗？
内置司机运费、油费、过路费、装卸费、其他 5 类费用分类。每笔费用既可绑定到具体运单（关联费用），也可不绑运单单独记录（公共费用），灵活覆盖专线的真实记账场景。
价格是多少？两档有什么区别？
标准部署版 ¥1,980，含完整系统部署与功能开通；含源码私有化版 ¥4,800，在标准版基础上交付全部前后端源码，支持二次开发与深度定制。两档均为私有化部署一次性报价，数据不出企业。
部署方案与价格
私有化部署，数据不出企业；两档方案按需选择，支持二次开发
标准部署版
适合小物流团队快速上手，直接开箱对账
- ✔ 完整系统部署（后端服务 + 数据库初始化）
- ✔ 运单管理 / 费用管理 / 对账报表全功能开放
- ✔ 客户对账 + 月度对账两种视图
- ✔ 4 种 Excel 导出（运单 / 费用 / 客户 / 月度）
- ✔ 部署文档 + 1 年免费 Bug 修复与技术支持
含源码私有化版
适合需要二次开发与深度定制的企业
- ✔ 含标准部署版全部内容
- ✔ 全部前后端源代码交付（Vue3 + Spring Boot）
- ✔ 支持二次开发与功能扩展
- ✔ 接口 / 字段 / 报表按需定制改造
- ✔ 部署文档 + 代码讲解 + 1 年技术支持
以上均为私有化部署一次性报价；数据全部本地存储，不出企业。如需对接现有系统或增购模块，可另行沟通。