SpringBoot3+Vue3+MySQL外卖配送系统前后端分离源码实战
一、项目简介本项目是一套基于 Spring Boot 3 Vue 3 前后端分离架构的外卖配送管理系统面向中小型外卖平台的日常运营管理场景。系统采用 RESTful API 设计前端通过 JWT Token 进行身份认证与权限控制后端按业务域划分为订单、商家、配送、用户、配置等模块。系统支持管理员、商家、配送员三种角色协同工作覆盖从用户下单到商家接单、备餐再到配送员抢单、取餐、送达的完整订单生命周期同时包含配送区域与计费规则配置、投诉工单处理、订单异常上报、转单协调等运营支撑功能。二、技术栈技术说明后端框架Spring Boot 3.xORMMyBatis-Plus 3.x权限认证JWT手动拦截器校验 Token前端框架Vue 3Composition API script setup状态管理Pinia路由Vue Router 4Hash 模式UI 组件库Element Plus构建工具Vite数据库MySQL 8.x文件上传本地文件存储 MultipartFile三、功能模块管理员端系统总览仪表盘实时统计在线配送员数量、配送中人数、离线人数及总人数以卡片形式展示核心运营指标。订单管理查看全部订单列表支持按订单状态、订单编号进行筛选与分页查询点击可查看订单详情含订单项明细。商家管理查看所有商家列表支持按店铺名称关键词搜索、按启用状态筛选可一键启用或停用店铺。配送员管理查看所有配送员列表支持按工作状态筛选可查看配送员详情并编辑其基础信息。菜品管理查看所有菜品列表支持按店铺、分类、状态、关键词多条件筛选可对菜品执行上架/下架及库存修改操作。配送区域管理新增、编辑、删除配送区域配置区域名称、边界坐标、基础配送费、每公里附加费。配送费规则管理为每个配送区域配置不同时段的基础配送费支持按距离区间设置分段计费规则。投诉工单处理查看投诉列表按状态筛选查看投诉详情填写处理结果并标记为已处理。订单异常处理查看异常列表按状态筛选查看异常详情填写处理结果并标记为已处理。超时配置管理新增、编辑、删除超时规则设置超时类型、阈值分钟数及描述说明。用户管理查看用户列表按角色/关键词筛选新增用户支持创建配送员并自动生成关联的 RiderInfo 记录编辑用户信息启用/禁用账号。入驻审核审核待审核的配送员和商家注册申请通过或拒绝其入驻请求。订单调度手动为订单指派配送员或使用强制指派功能处理异常订单。运力概览查看配送运力总览统计在线、配送中、离线配送员人数。商家端订单管理查看本店订单列表支持按订单状态筛选查看订单详情含订单项。接单操作将订单状态从未接单更新为已接单确认接受用户订单。备餐完成将订单状态从已接单更新为已备餐完成通知配送员可到店取餐。菜品分类管理为店铺新增、编辑、删除菜品分类支持自定义排序。菜品管理新增菜品设置名称、图片、价格、原价、描述、库存、所属分类编辑菜品信息上下架菜品调整库存数量。促销活动管理新增促销活动设置名称、类型满减/折扣、满减门槛、折扣金额或折扣率、活动起止时间编辑促销启用或停用促销。店铺信息管理查看和编辑店铺资料包括店铺名称、Logo、Banner、描述、地址、电话、营业时间。经营数据查看本店月度销量统计和用户评分。配送员端可抢订单列表查看所有待配送的订单支持分页浏览。抢单操作从可抢订单列表中选择订单并抢单成功后订单自动绑定当前配送员。我的配送订单查看当前配送员名下的订单列表支持按订单状态筛选。取餐操作输入取餐码进行验证验证通过后将订单状态更新为配送中。配送完成确认送达后将订单状态更新为已完成。收入记录分页查看每笔收入明细包含金额、类型、描述、时间字段。收入统计查看总收入、本月收入、今日收入等汇总数据。配送统计获取总订单数、完成订单数、累计配送里程等个人配送数据。工作状态切换在线/离线/配送中三种工作状态自由切换。订单异常提交对配送中的订单提交异常报告填写异常类型、描述并上传图片。转单请求将已接订单转给其他配送员填写转单原因同时可查看待处理的转单请求列表接受或拒绝其他配送员的转单。四、项目总结本项目技术选型主流且前后端完全分离后端基于 Spring Boot 3 与 MyBatis-Plus 提供了清晰的模块化分层前端采用 Vue 3 Pinia Element Plus 实现了组件化开发。从业务角度看系统覆盖了外卖平台核心的订单流转、配送调度、计费规则、异常处理等完整链路角色权限划分明确适合作为中小型外卖平台的管理后台原型。从学习角度看项目包含了 JWT 认证、多角色权限控制、复杂业务状态机流转、文件上传、数据统计聚合等常见开发场景代码结构清晰适合 Java 全栈学习者用于毕业设计或作为二次开发的基线工程。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K226