# 点餐小程序

**Repository Path**: ttzhanshen/ordering-mini-program

## Basic Information

- **Project Name**: 点餐小程序
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🍽️ 点菜系统 - 完整开发文档

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![SpringBoot](https://img.shields.io/badge/SpringBoot-2.7.14-green.svg)](https://spring.io/projects/spring-boot)
[![UniApp](https://img.shields.io/badge/UniApp-Vue3-brightgreen.svg)](https://uniapp.dcloud.io/)
[![MySQL](https://img.shields.io/badge/MySQL-8.0-blue.svg)](https://www.mysql.com/)

## 📖 项目简介

这是一个**完整、规范、实用**的点菜系统解决方案，采用前后端分离架构，包含用户端和管理端。

### ✨ 特色

- 🎯 **完整功能** - 从点菜到订单管理的完整流程
- 📱 **跨平台支持** - H5、微信小程序、App多端运行
- 🔐 **安全可靠** - JWT认证、密码加密、权限控制
- 📚 **文档齐全** - 100+页详细文档，API、数据库、部署全覆盖
- 🚀 **开箱即用** - 一键启动脚本，5分钟快速体验
- 💡 **易于扩展** - 清晰的代码结构，便于二次开发

## 技术栈

### 后端
- SpringBoot 2.7.x
- MySQL 8.0
- MyBatis-Plus 3.5.x
- JWT 认证
- Lombok
- Swagger 3.0

### 前端
- UniApp
- Vue 3
- uView UI

## 项目结构

```
ordering-system/
├── backend/                    # SpringBoot 后端
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/ordering/
│   │   │   │   ├── controller/    # 控制器
│   │   │   │   ├── service/       # 服务层
│   │   │   │   ├── mapper/        # 数据访问层
│   │   │   │   ├── entity/        # 实体类
│   │   │   │   ├── dto/           # 数据传输对象
│   │   │   │   ├── config/        # 配置类
│   │   │   │   └── utils/         # 工具类
│   │   │   └── resources/
│   │   │       ├── application.yml
│   │   │       └── mapper/        # MyBatis XML
│   │   └── test/
│   └── pom.xml
├── frontend-user/              # UniApp 用户端
│   ├── pages/
│   │   ├── menu/              # 点菜页面
│   │   ├── order/             # 订单页面
│   │   └── profile/           # 我的页面
│   ├── static/
│   ├── components/
│   └── App.vue
├── admin-frontend/             # Vue3 管理端
│   ├── src/
│   │   ├── api/               # API接口
│   │   ├── views/             # 页面组件
│   │   ├── layout/            # 布局组件
│   │   ├── router/            # 路由配置
│   │   ├── stores/            # 状态管理
│   │   └── utils/             # 工具函数
│   ├── vite.config.js
│   └── package.json
└── docs/                       # 文档
    ├── API.md                  # API 文档
    ├── DATABASE.md             # 数据库设计
    └── DEPLOY.md               # 部署文档
```

## 功能模块

### 用户端
1. **点菜页面**
   - 左侧菜品分类导航
   - 右侧菜品列表（图片、名称、价格、描述）
   - 添加到购物车功能
   - 底部购物车和结算按钮

2. **订单页面**
   - 全部订单列表
   - 购物车信息
   - 订单详情查看

3. **我的页面**
   - 用户头像显示
   - 修改资料功能
   - 退出登录

### 管理端 (Vue3)
1. **工作台**
   - 数据统计卡片
   - 最近订单列表
   - 可视化数据展示

2. **分类管理**
   - 添加/编辑/删除分类
   - 排序管理

3. **菜品管理**
   - 添加/编辑/删除菜品
   - 图片上传
   - 搜索筛选
   - 分页展示

4. **订单管理**
   - 订单列表
   - 订单详情
   - 状态更新
   - 新订单消息提示

5. **个人中心**
   - 个人信息编辑
   - 修改密码
   - 退出登录

## 快速开始

### 后端启动

1. 创建数据库
```sql
CREATE DATABASE ordering_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 修改配置文件 `application.yml`
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ordering_system
    username: root
    password: your_password
```

3. 启动项目
```bash
cd backend
mvn spring-boot:run
```

### 用户端启动 (UniApp)

**⚠️ 重要提示**：UniApp项目不能直接在浏览器中打开HTML文件！

**方式A：使用HBuilderX（推荐，最简单）**
1. 下载HBuilderX：https://www.dcloud.io/hbuilderx.html
2. 导入 `frontend-user` 文件夹
3. 点击"运行" → "运行到浏览器" → "Chrome"

**方式B：使用命令行**
```bash
cd frontend-user
npm install
npm run dev:h5         # H5浏览器
npm run dev:mp-weixin  # 微信小程序
```

**详细说明**：查看 `UNIAPP_SETUP_GUIDE.md` 或 `frontend-user/TROUBLESHOOTING.md`

### 管理端启动 (Vue3)

**方式A：使用启动脚本（推荐）**
```bash
# Windows
cd admin-frontend
start-admin.bat

# Linux/Mac
cd admin-frontend
./start-admin.sh
```

**方式B：使用命令行**
```bash
cd admin-frontend
npm install
npm run dev
```

管理端将在 http://localhost:8081 运行

## API 接口

详见 `docs/API.md`

## 数据库设计

详见 `docs/DATABASE.md`

## 部署说明

详见 `docs/DEPLOY.md`

## 开发者

开发时间：2026年5月

## 许可证

MIT License