# 课间达

**Repository Path**: carocall/during-break

## Basic Information

- **Project Name**: 课间达
- **Description**: 基于springboot，vue，uniapp的校园零食售卖系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-04-28
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园零食销售系统

一个基于 Spring Boot + Vue 3 的校园零食销售平台，包含管理端后台系统和微信小程序端，为校园零食销售提供完整的解决方案。

## 项目结构

```
campus-sncak-sale-system/
├── rear-end/                 # 后端服务（Spring Boot）
│   ├── src/main/java/        # Java 源代码
│   │   └── com/carocall/
│   │       ├── config/       # 配置类（OSS、Web、JWT等）
│   │       ├── controller/   # 控制器（admin管理端、user用户端）
│   │       ├── service/      # 业务逻辑层
│   │       ├── mapper/       # 数据访问层（MyBatis）
│   │       ├── entity/       # 实体类
│   │       ├── dto/          # 数据传输对象
│   │       ├── vo/           # 视图对象
│   │       ├── interceptor/  # 拦截器（权限验证）
│   │       ├── exception/    # 自定义异常
│   │       └── utils/        # 工具类（JWT、OSS等）
│   └── pom.xml               # Maven 依赖配置
├── web/                      # 管理端前端（Vue 3）
│   ├── src/
│   │   ├── api/              # 接口请求封装
│   │   ├── views/            # 页面组件
│   │   ├── components/       # 公共组件
│   │   ├── layouts/          # 布局组件
│   │   ├── router/           # 路由配置
│   │   ├── stores/           # Pinia 状态管理
│   │   └── utils/            # 工具类（axios封装）
│   └── package.json          # npm 依赖配置
├── images/                   # 项目截图
└── README.md                 # 项目说明文档
```

## 技术栈

### 后端技术

| 技术 | 说明 |
|------|------|
| Spring Boot 2.7.5 | 核心框架 |
| MyBatis Plus 3.5.3 | ORM 框架 |
| MySQL / SQL Server | 数据库 |
| Redis | 缓存服务 |
| JWT | 身份认证 |
| Knife4j | API 文档生成 |
| 阿里云 OSS | 文件存储 |
| PageHelper | 分页插件 |
| Hutool | 工具类库 |
| Lombok | 简化代码 |

### 前端技术（管理端）

| 技术 | 说明 |
|------|------|
| Vue 3.5 | 核心框架 |
| Vite 7.3 | 构建工具 |
| Element Plus | UI 组件库 |
| Vue Router 4.6 | 路由管理 |
| Pinia 3.0 | 状态管理 |
| Axios | HTTP 请求 |
| ECharts 6.0 | 数据可视化 |
| VueUse | 组合式工具库 |
| Sass | CSS 预处理器 |

### 小程序端技术（UniApp）

| 技术 | 说明 |
|------|------|
| UniApp 3.0 | 跨平台应用开发框架 |
| Vue 3 | 核心框架（Composition API） |
| Vite 4.0 | 构建工具 |
| 微信小程序 | 目标发布平台 |
| SCSS | CSS 预处理器 |
| 本地存储 | uni.setStorageSync 数据持久化 |

## 系统功能展示

### 管理端

#### 登录界面

![管理端登录界面](images/管理端_登录界面.png)

#### 首页仪表盘

![管理端首页](images/管理端首页.png)

#### 员工管理

![管理端员工管理](images/管理端员工管理界面.png)

#### 分类管理

![管理端分类管理](images/管理端分类管理界面.png)

#### 订单管理

![管理端订单管理](images/管理端订单管理界面.png)

### 小程序端

#### 首页

![小程序端首页](images/小程序端首页.png)

#### 分类浏览

![小程序端分类界面](images/小程序端分类界面.png)

#### 购物车

![小程序端购物车界面](images/小程序端购物车界面.png)

#### 订单确认

![小程序端订单确认界面](images/小程序端订单确认界面.png)

#### 个人主页

![小程序端个人主页](images/小程序端个人主页.png)

## 核心功能模块

### 管理端功能

- **数据看板**：实时展示销售数据、订单统计、用户增长等关键指标，支持按日/周/月维度查看销售趋势图表，快速掌握运营状况
- **商品管理**：零食商品的增删改查、上下架管理、价格调整，支持商品图片上传（阿里云 OSS）、库存管理、商品详情编辑，支持按分类/名称搜索筛选
- **套餐管理**：组合套餐创建与管理，可灵活搭配多款零食组成优惠套餐，设置套餐价格、折扣力度、库存数量，支持套餐详情查看与编辑
- **分类管理**：商品分类的层级管理，支持多级分类结构，分类排序调整，分类图标上传，便于用户快速浏览商品
- **订单管理**：订单查看、状态更新、发货处理、退款审核，支持按订单状态（待付款、待发货、配送中、已完成、已取消）筛选，订单详情查看（商品清单、收货地址、支付信息），支持订单导出
- **用户管理**：用户信息管理、账户状态控制，查看用户注册信息、历史订单记录、消费统计，支持用户账户冻结/解冻操作
- **员工管理**：员工账号管理、权限分配，支持新增员工账号、设置角色权限（管理员/普通员工）、密码重置、员工状态管理
- **优惠券管理**：优惠券发放、使用规则配置，支持创建满减券、折扣券，设置优惠券面额、使用门槛、有效期、发放数量，查看优惠券领取与使用情况统计
- **轮播图管理**：首页轮播广告管理，支持上传轮播图片、设置跳转链接、排序调整、启用/禁用控制，提升活动曝光率
- **消息通知**：系统通知推送管理，创建系统公告、活动通知，支持定向推送给特定用户群体，查看通知阅读状态
- **数据统计**：销售报表、趋势分析、数据导出，生成商品销量排行、用户消费排行、营收统计报表，支持图表可视化展示与数据导出
- **建议反馈**：用户建议查看与处理，收集用户提交的意见建议，支持标记处理状态、回复用户，持续优化服务体验

### 小程序端功能

- **首页浏览**：轮播图广告展示、热销商品推荐、新品上架推荐、分类快捷入口，支持商品搜索功能，快速定位目标商品
- **分类浏览**：左侧分类导航栏、右侧商品列表展示，支持按分类筛选商品，商品卡片展示图片、名称、价格、销量信息，点击商品进入详情页
- **商品详情**：商品图片轮播、详细信息展示（名称、价格、库存、描述）、规格选择、加入购物车、立即购买，支持收藏商品功能
- **购物车管理**：已加购商品列表展示，支持商品数量增减、单选/全选结算、商品删除操作，实时计算选中商品总价，支持清空购物车
- **订单流程**：
  - **下单**：选择收货地址、选择优惠券抵扣、备注信息填写、配送时间选择
  - **支付**：微信支付集成，支持订单金额确认、支付密码验证
  - **订单跟踪**：订单状态实时更新（待付款、待发货、配送中、已完成），物流信息查看
  - **订单评价**：完成订单后可对商品进行评分与评价
- **优惠券中心**：可领取的优惠券列表展示，查看已领取优惠券（未使用/已使用/已过期），优惠券使用规则说明，下单时自动匹配可用优惠券
- **个人中心**：
  - **订单管理**：全部订单列表，按状态筛选订单，订单详情查看，取消订单、确认收货操作
  - **地址管理**：收货地址新增、编辑、删除，设置默认地址，支持从微信地址簿导入
  - **个人信息**：头像修改、昵称设置、手机号绑定、账号安全设置
  - **我的收藏**：查看已收藏商品，快速跳转商品详情
- **消息通知**：接收系统通知、订单状态变更通知、优惠活动通知，支持消息列表查看与已读标记
- **客服反馈**：在线提交意见建议、问题反馈，支持文字描述与图片上传，查看反馈处理进度与回复

## 快速开始

### 环境要求

- JDK 1.8+
- Node.js 16+
- MySQL 5.7+ / SQL Server
- Redis 6+
- Maven 3.6+

### 后端启动

```bash
cd rear-end

# 配置数据库连接（修改 application.yml）
# 配置 Redis 连接
# 配置阿里云 OSS（如需文件上传功能）

# 编译运行
mvn clean package
java -jar target/rear-end-0.0.1-SNAPSHOT.jar
```

### 前端启动

```bash
cd web

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build
```

## 项目特点

- **前后端分离**：RESTful API 设计，便于维护和扩展
- **权限控制**：基于 JWT 的身份认证和拦截器权限验证
- **分页查询**：集成 PageHelper 实现高效分页
- **文件存储**：支持阿里云 OSS 云存储
- **定时任务**：订单超时自动处理、优惠券过期管理
- **数据可视化**：ECharts 图表展示统计数据
- **响应式设计**：管理端适配不同屏幕尺寸