基于Vue+SpringBoot的农村物流配送系统开源项目

news2025/1/22 12:55:29

在这里插入图片描述

一、摘要
- 1.1 项目介绍
- 1.2 项目录屏
二、功能模块
- 2.1 系统登录、注册界面
- 2.2 系统功能
- - 2.2.1 快递信息管理：
  - 2.2.2 位置信息管理：
  - 2.2.3 配送人员分配：
  - 2.2.4 路线规划：
  - 2.2.5 个人中心：
  - 2.2.6 退换快递处理：
  - 2.2.7 客户评价：
三、系统展示
四、核心代码
- 4.1 查询商家
- 4.2 退换快递
- 4.3 新增路线规划
- 4.4 查询乡镇村社
- 4.5 查询配送位置
五、免责说明

一、摘要

1.1 项目介绍

基于Vue+SpringBoot+MySQL的农村物流配送系统，包含快递客户管理模块、配送位置管理模块、配送人员模块、路线规划模块、商家管理模块、商品退换模块，还包含系统自带的用户管理、部门管理、角色管理、菜单管理、日志管理、数据字典管理、文件管理、图表展示等基础模块，农村物流配送系统基于角色的访问控制，给物流管理员、配送人员使用，可将权限精确到按钮级别，您可以自定义角色并分配权限，系统适合设计精确的权限约束需求。

1.2 项目录屏

源码下载

二、功能模块

2.1 系统登录、注册界面

1、快递员注册、登录此系统。
2、建立员工数据库，管理员工信息。

2.2 系统功能

2.2.1 快递信息管理：

（1）添加客户信息：输入收货人，取件码，快递单号。
（2）查询客户信息：输入收货人，ID。
（3）删除客户信息：
（4）修改客户信息;

2.2.2 位置信息管理：

（1）添加位置信息：输入起始地点，输入终点
（2）删除位置信息：
（3）修改位置信息：
（4）定位信息：请输入地点信息

2.2.3 配送人员分配：

（1）添加配送人员：输入性别，输入姓名，输入年龄
（2）删除配送人员信息：
（3）修改配送人员信息：

2.2.4 路线规划：

（1）划分路线图：输入乡镇名，村名，
（2）为每个配送人员添加自己的路线：
（3）删除路线：
（4）修改路线：

2.2.5 个人中心：

（1）员工个人信息管理：添加员工信息，输入姓名，性别，年龄；删除员工信息；查询员工信息；修改员工信息
（2）关于系统：系统版本
（3）退出系统：

2.2.6 退换快递处理：

（1）输入退换产品理由；
（2）输入商家信息：输入商家姓名，位置信息，联系方式
（3）输入客户信息：输入客户姓名，联系方式：
（4）删除商家信息：
（5）删除客户信息：
（6）修改商家信息：
（7）修改客户信息：

2.2.7 客户评价：

（1）非常满意，满意，一般，差评。

三、系统展示

在这里插入图片描述

四、核心代码

4.1 查询商家

@RequestMapping(value = "/getByPage", method = RequestMethod.GET)
@ApiOperation(value = "查询商家")
public Result<IPage<Business>> getByPage(@ModelAttribute Business business ,@ModelAttribute PageVo page){
    QueryWrapper<Business> qw = new QueryWrapper<>();
    if(!ZwzNullUtils.isNull(business.getUserName())) {
        qw.like("user_name",business.getUserName());
    }
    if(!ZwzNullUtils.isNull(business.getAddress())) {
        qw.like("address",business.getAddress());
    }
    IPage<Business> data = iBusinessService.page(PageUtil.initMpPage(page),qw);
    return new ResultUtil<IPage<Business>>().setData(data);
}

4.2 退换快递

@RequestMapping(value = "/insert", method = RequestMethod.POST)
@ApiOperation(value = "新增退换快递")
public Result<Exchange> insert(Exchange exchange){
    Business b = iBusinessService.getById(exchange.getBusinessId());
    if(b == null) {
        return ResultUtil.error("商家不存在");
    }
    exchange.setBusinessName(b.getUserName() + "-" + b.getAddress());
    Express e = iExpressService.getById(exchange.getExpressId());
    if(e == null) {
        return ResultUtil.error("快递客户不存在");
    }
    exchange.setExpressName(e.getUserName() + "-" + e.getAddress());
    iExchangeService.saveOrUpdate(exchange);
    return new ResultUtil<Exchange>().setData(exchange);
}

4.3 新增路线规划

@RequestMapping(value = "/insert", method = RequestMethod.POST)
@ApiOperation(value = "新增路线规划")
public Result<Route> insert(Route route){
    Department d1 = iDepartmentService.getById(route.getTownshipId());
    if(d1 == null) {
        return ResultUtil.error("乡镇不存在");
    }
    route.setTownshipName(d1.getTitle());
    Department d2 = iDepartmentService.getById(route.getVillageId());
    if(d2 == null) {
        return ResultUtil.error("村社不存在");
    }
    route.setVillageName(d2.getTitle());
    User user = iUserService.getById(route.getDispatcherId());
    if(user == null) {
        return ResultUtil.error("配送员不存在");
    }
    route.setDispatcherName(user.getNickname());
    iRouteService.saveOrUpdate(route);
    return new ResultUtil<Route>().setData(route);
}

4.4 查询乡镇村社

@RequestMapping(value = "/getTopDepartment", method = RequestMethod.GET)
@ApiOperation(value = "查询乡镇")
public Result<List<Department>> getTopDepartment(){
    QueryWrapper<Department> qw = new QueryWrapper<>();
    qw.eq("parent_id",0);
    return new ResultUtil<List<Department>>().setData(iDepartmentService.list(qw));
}

@RequestMapping(value = "/getSonDepartment", method = RequestMethod.GET)
@ApiOperation(value = "查询村社")
public Result<List<Department>> getSonDepartment(@RequestParam String parentId){
    QueryWrapper<Department> qw = new QueryWrapper<>();
    if(!ZwzNullUtils.isNull(parentId)) {
        qw.eq("parent_id",parentId);
    } else {
        qw.ne("parent_id",0);
    }
    return new ResultUtil<List<Department>>().setData(iDepartmentService.list(qw));
}

4.5 查询配送位置

@RequestMapping(value = "/getByPage", method = RequestMethod.GET)
@ApiOperation(value = "查询位置")
public Result<IPage<Position>> getByPage(@ModelAttribute Position position ,@ModelAttribute PageVo page){
    QueryWrapper<Position> qw = new QueryWrapper<>();
    if(!ZwzNullUtils.isNull(position.getTitle())) {
        qw.like("title",position.getTitle());
    }
    if(!ZwzNullUtils.isNull(position.getStartAddress())) {
        qw.like("start_address",position.getStartAddress());
    }
    if(!ZwzNullUtils.isNull(position.getEndAddress())) {
        qw.like("end_address",position.getEndAddress());
    }
    IPage<Position> data = iPositionService.page(PageUtil.initMpPage(page),qw);
    return new ResultUtil<IPage<Position>>().setData(data);
}