# 物流管理系统

**Repository Path**: Ppwindf/logistics-management

## Basic Information

- **Project Name**: 物流管理系统
- **Description**: Spring MVC + MyBatis 项目练习
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-22
- **Last Updated**: 2025-11-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 物流管理系统功能模块详述

### 一、系统架构

采用 Spring MVC + MyBatis，分层包括：
- Controller：处理 HTTP 请求
- Service：业务逻辑
- Dao/Mapper：数据访问
- Entity：实体模型
- 前端：HTML + JavaScript（AngularJS）+ Bootstrap

---

### 二、核心功能模块

#### 1. 用户管理模块 (UserController)
功能：
- 用户登录/退出：邮箱+密码，验证码，记录登录 IP 地址
- 用户注册：邮箱注册
- 用户查询：支持条件查询
- 用户增删改：新增、修改、删除
- 个人信息管理：查看与修改
- 用户角色关联：支持角色分配

相关实体：
- `User`：用户基本信息（姓名、邮箱、密码、手机、生日、性别、公司、部门等）
- `UserRole`：用户角色关联表

#### 2. 订单管理模块 (OrdersController)
功能：
- 订单创建：创建采购订单（含货物、收货、审核、采购价格、物流价格）
- 订单查询：支持条件查询，普通用户仅查看自己的订单
- 订单修改：更新订单、货物、收货信息
- 订单删除：删除订单及关联数据
- 采购询价：发起采购询价，关联供应商与价格信息
- 物流询价：发起物流询价，关联物流公司与价格信息
- 采购询价管理：撤销采购询价
- 物流询价管理：撤销物流询价
- 采购发起：发起采购流程
- 采购撤销：撤销采购申请
- 合同管理：发起与撤销物流合同
- 订单查询（物流）：查询物流订单
- 订单跟踪：查询订单位置与配送状态

相关实体：
- `Orders`：订单主表
- `Goods`：货物信息
- `Receipt`：收货信息
- `OrderExam`：订单审核信息
- `PurPrice`：采购价格
- `LogPrice`：物流价格

#### 3. 采购管理模块 (PurchaseController)
功能：
- 采购价格管理：查询、添加、修改、删除采购价格
- 采购审核：查询待审核采购、审核、撤销审核
- 发起采购：审核通过后发起采购流程

相关实体：
- `purchasePriceManage`：采购价格管理表
- `PurPrice`：采购价格表

#### 4. 物流管理模块 (LogisticController)
功能：
- 物流审核：查询待审核订单、审核、撤销审核
- 物流计费管理：回复物流询价、撤销回复

相关实体：
- `OrderExam`：订单审核表
- `LogPrice`：物流价格表

#### 5. 车辆管理模块 (VehicleController)
功能：
- 车辆信息管理：
  - 查询、添加、修改、删除
  - 记录车牌号、类型、容积、载重、每公里价格、空闲状态
- 车辆类型管理：查询、添加、修改、删除
- 车辆需求管理：
  - 查询车辆需求
  - 记录需求类型、数量、审核状态、审核人、审核部门

相关实体：
- `Car`：车辆信息表
- `CarType`：车辆类型表
- `CarNeed`：车辆需求表

#### 6. 配车方案模块 (CarSController)
功能：
- 配车方案查询：根据用户地址与物流订单查询
- 配车方案更新：配车并更新车辆需求
- 出车管理：查询待出车订单、确认出车
- 最优装载计算：根据货物信息计算所需车辆数量

相关工具类：
- `BestLoading`：最优装载算法工具类

#### 7. 仓储管理模块 (RepertoryController)
功能：
- 仓库信息管理：查询、添加、修改、删除
- 库存管理：记录商品在仓库中的存储情况

相关实体：
- `Repertory`：仓库信息表

#### 8. 位置跟踪模块 (PositionController)
功能：
- 配送查询：查询配送中的订单
- 位置登记：登记配送位置信息
- 订单查询：查询订单信息
- 订单跟踪：查询订单的完整配送轨迹

相关实体：
- `PositionTracking`：位置跟踪表

#### 9. 部门管理模块 (DepartmentController)
功能：
- 部门信息管理：查询、添加、修改、删除
- 部门组织结构维护

相关实体：
- `Department`：部门信息表

#### 10. 角色权限管理模块 (RoleSetController)
功能：
- 用户角色配置：
  - 查询用户角色
  - 添加/修改/删除用户角色关联
- 角色权限配置：
  - 查询角色权限
  - 添加/修改/删除角色权限关联
- 角色菜单配置：
  - 查询角色菜单
  - 添加/修改/删除角色菜单关联

相关实体：
- `UserRole`：用户角色关联表
- `roleAction`：角色权限关联表
- `RoleMenu`：角色菜单关联表
- `Role`：角色表
- `Action`：权限表
- `Menu`：菜单表

#### 11. 菜单管理模块 (MenuController)
功能：
- 菜单查询：查询系统菜单
- 菜单添加：新增菜单项（自动关联默认角色）
- 菜单修改：编辑菜单信息
- 菜单删除：删除菜单及角色关联
- 左侧菜单加载：根据用户角色权限动态加载左侧导航菜单

相关实体：
- `Menu`：菜单表
- `RoleMenu`：角色菜单关联表

#### 12. 地址管理模块 (AddressController)
功能：
- 地址信息查询：查询省市区县信息
- IP 地址解析：根据登录 IP 获取用户地理位置

相关工具类：
- `AddressUtils`：地址工具类
- `IpAddress`：IP 地址解析工具类

---

### 三、辅助功能模块

#### 1. 通用工具类 (common 包)
- `JsonResult`：统一 JSON 响应格式
- `JsonUtil`：JSON 工具类
- `VerifyCode`：验证码生成工具
- `BestLoading`：最优装载算法
- `Constant`：系统常量定义

#### 2. 系统配置
- `LoginInterceptor`：登录拦截器（验证用户登录状态）
- `BaseController`：基础控制器（提供通用方法）
- `UserException`：用户异常类

#### 3. 数据库设计
主要业务表：
- `user`：用户表
- `orders`：订单表
- `goods`：货物表
- `car`：车辆表
- `car_plan`：配车方案表
- `car_need`：车辆需求表
- `repertory`：仓库表
- `position_tracking`：位置跟踪表
- `department`：部门表
- `role`：角色表
- `menu`：菜单表
- `action`：权限表
- `provinces`、`cities`、`areas`：省市区县表

---

### 四、业务流程

#### 订单流程
1. 创建订单 → 2. 发起采购询价 → 3. 供应商回复价格 → 4. 采购审核 → 5. 发起采购 → 6. 发起物流询价 → 7. 物流公司回复价格 → 8. 物流审核 → 9. 签订物流合同 → 10. 配车方案 → 11. 出车 → 12. 位置跟踪 → 13. 订单完成

#### 权限控制
- 基于角色的访问控制（RBAC）
- 菜单权限：控制可见菜单
- 功能权限：控制功能操作
- 数据权限：普通用户只能查看自己的数据

---

### 五、技术特点

1. 分层架构：Controller-Service-Dao
2. 统一响应：使用 JsonResult
3. 动态菜单：根据角色权限加载
4. 位置服务：IP 地址解析与位置跟踪
5. 优化算法：最优装载计算
6. 权限控制：基于 RBAC 的多级权限管理

---

### 六、前端页面

主要视图页面（位于 `WEB-INF/views/`）：
- `index.html`：系统主框架
- `home.html`：首页
- `login.html`：登录页
- `register.html`：注册页
- `user.html`：用户管理
- `logisticsOrder.html`：物流订单管理
- `purchaseOrder.html`：采购订单管理
- `purchasePlan.html`：采购计划管理
- `purchase.html`：采购管理
- `logExamine.html`：物流审核
- `logCharge.html`：物流计费管理
- `carscheme.html`：配车方案
- `vehicleInfo.html`：车辆信息管理
- `vehicleType.html`：车辆类型管理
- `vehicleDemand.html`：车辆需求管理
- `repertory.html`：仓储管理
- `department.html`：部门管理
- `roleSet.html`：角色设置
- `roleAction.html`：角色权限配置
- `menu.html`：菜单管理
- `position.html`：位置跟踪
- `usercenter.html`：用户中心

系统涵盖订单、采购、物流、车辆、仓储、权限等核心业务，形成了完整的物流管理解决方案。