一、项目简介
本项目是一套面向校园场景的点餐平台，基于 Spring Boot 3 + Vue 3 + MySQL 构建，采用前后端分离架构。系统覆盖用户端、商家端、管理员端三种角色：普通用户可浏览食堂与菜品、管理购物车、下单支付（模拟）、评价投诉；商家（食堂店铺）可管理店铺信息、菜品、订单、评价及经营数据；管理员负责用户审核、食堂与店铺配置、内容管理（轮播图/公告）以及全局运营数据监控。系统内置实时客流统计、经营趋势分析、食材安全追溯等特色功能，适合作为毕业设计、课程设计或 Java 全栈学习项目的参考源码。
二、技术栈
| 技术 | 说明 |
|---|---|
| 后端框架 | Spring Boot 3.x |
| ORM | MyBatis-Plus（含分页插件、逻辑删除、自动填充） |
| 权限认证 | JWT（HS256 算法）+ 自定义拦截器 |
| 密码加密 | BCryptPasswordEncoder |
| 前端框架 | Vue 3 |
| 状态管理 | Vuex / Pinia |
| 构建工具 | Vite |
| 数据库 | MySQL（逻辑删除字段、createTime/updateTime 自动填充） |
| 文件上传 | MultipartFile 本地存储（配置 upload.path） |
| 工具类 | Hutool（雪花 ID 生成） |
三、功能模块
管理员端
- 用户管理：支持按用户名/昵称搜索、按角色筛选，可新增、编辑、删除用户，并可启用或禁用账号。
- 身份审核：查看待审核的用户实名认证列表（真实姓名+学号），通过或拒绝并填写拒绝原因。
- 商家入驻审核：查看待审核/已拒绝的商家申请，审核通过或拒绝；通过后可为商家创建店铺（指定店铺名称与所属食堂）。
- 食堂管理：新增/编辑食堂名称、位置、楼层、图片、营业时间、排序字段。
- 店铺管理：查看全部店铺列表，支持启用/禁用店铺、删除店铺。
- 轮播图管理：新增/编辑/删除轮播图，设置标题、图片链接、排序、启用状态。
- 系统公告管理：新增/编辑/删除公告，设置标题、内容、类型、启用状态。
- 系统概览统计：展示总用户数、总店铺数、总订单数、今日订单数、上架菜品数、待审核认证数。
- 实时运营数据：今日订单数、近 1 小时订单数、今日营收、待处理订单数、制作中订单数。
- 食堂客流管理：查看各食堂最新客流记录（人数+拥堵等级 LOW/MEDIUM/HIGH），支持手动输入人数自动判定等级。
- 食材安全记录：查看所有食材记录（按时间倒序），含供应商、产地、批号、生产/过期日期、证书。
普通用户端
- 浏览食堂列表：按排序展示食堂，查看名称、位置、楼层、营业时间。
- 查看店铺列表：查看某食堂下所有营业中的店铺，含名称、描述、评分、销量、公告。
- 菜品浏览与筛选：按分类筛选、关键词搜索、销量排序浏览店铺内菜品。
- 菜品详情：查看名称、价格、图片、描述、口味、营养标签。
- 购物车管理：添加菜品（选择数量、备注），同一菜品累加数量；查看列表（菜品名、图片、单价、数量、备注），修改数量或清空指定店铺购物车。
- 提交订单：选择收货地址、填写备注，下单前需完成实名认证（提交真实姓名与学号）。
- 订单管理：按状态筛选个人订单，查看订单详情（菜品明细、总价、状态）；待处理或制作中订单（状态 0/1）可取消。
- 订单评价：对已完成订单进行评分、填写文字内容、上传图片；可查看商家回复。
- 收货地址管理：新增/编辑/删除地址，支持设置默认地址。
- 个人消费统计：总订单数、总金额、本月订单数、本月金额、最近 10 笔订单。
- 通知中心：查看系统通知（取餐提醒、投诉处理结果），支持标记全部已读。
- 投诉管理：关联店铺与订单提交投诉，查看处理结果。
- 个人资料：更新昵称、头像、手机号、口味偏好。
- 首页内容：查看轮播图（按排序展示启用项）、系统公告（最新 10 条）、推荐菜品（isRecommend=1 按销量降序取前 12）、各食堂实时客流。
商家端
- 店铺信息管理：查看/编辑店铺名称、描述、公告、营业时间、图片、起送价；切换营业状态（开业/打烊）。
- 菜品分类管理：新增/编辑/删除分类，按排序展示。
- 菜品管理：新增/编辑/删除菜品，支持按分类筛选、关键词搜索；上架/下架菜品。
- 订单管理：按状态筛选本店订单（时间倒序），查看订单详情（订单信息+菜品明细）。
- 订单状态流转：接单、制作完成、配送/取餐完成；制作完成时自动发送取餐通知给用户。
- 评价管理：查看本店评价列表（时间倒序），回复用户评价。
- 投诉处理：查看本店投诉列表（按状态筛选），填写处理结果，处理完成后通知用户。
- 经营概览：总订单数、今日订单数、待处理订单数、总收入。
- 经营趋势：近 30 天每日订单数与营收趋势、近 12 个月每月订单数与营收趋势。
- 菜品销量排行：Top 10 菜品，含销量与营收。
- 订单状态分布：各状态订单数量统计。
- 食材安全管理：新增食材记录（名称、供应商、产地、批号、生产/过期日期、证书），查看历史记录。
四、项目总结
本项目技术栈覆盖 Java 后端与 Vue 3 前端的完整全栈链路，代码结构清晰，注释完整，适合作为学习 Spring Boot 3 + MyBatis-Plus + JWT 认证 + Vue 3 组合开发的实战参考。项目亮点包括：三端角色权限隔离、订单状态机流转（含自动通知）、基于 JWT 的无状态认证、经营数据可视化统计、实时客流判定逻辑、食材安全溯源记录。适用场景为校园食堂数字化管理、餐饮类系统的二次开发基础，以及毕业设计/课程设计的完整源码参考。
界面展示
交付内容
本项目为完整交付，包含：
- 完整后端源码
- 完整前端源码
- 数据库初始化脚本（SQL）
- 万字项目文档（设计文档 / 论文，可作课程设计、毕业设计参考）
获取完整源码
完整前后端源码 + 数据库脚本 + 万字项目文档见 Gitee 仓库：https://gitee.com/kangxihuang/src-K233