# 点餐系统

**Repository Path**: Blank_5230/ordering-system

## Basic Information

- **Project Name**: 点餐系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-07
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 菜品制作与下单小程序 - 内部运营系统

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![JeecgBoot](https://img.shields.io/badge/JeecgBoot-3.6.3-brightgreen.svg)](http://jeecg.com)
[![Vue](https://img.shields.io/badge/Vue-3.4.19-green.svg)](https://vuejs.org)
[![uni-app](https://img.shields.io/badge/uni--app-3.0-blue.svg)](https://uniapp.dcloud.io)

## 项目简介

这是一个基于 JeecgBoot 低代码平台开发的菜品下单与采购管理系统，面向内部运营使用，核心流程包括：菜品分类/材料配置 → 菜品下单 → 订单管理 → 采购单生成。无独立管理端，所有操作在用户端完成，无支付环节。

## 技术栈

### 后端
- **框架**: Spring Boot 2.7.18 + Spring Cloud Alibaba 2021.0.1.0
- **数据库**: MyBatis-Plus 3.5.3.2 + MySQL 5.7+
- **安全**: Apache Shiro 1.12.0 + JWT
- **微服务**: Nacos + Gateway + Sentinel

### 前端管理后台
- **框架**: Vue 3.4.19 + Vite 5.2.11 + TypeScript 4.9.5
- **UI 库**: Ant Design Vue 4.1.2
- **状态管理**: Pinia 2.1.7

### 小程序
- **框架**: uni-app 3.0
- **平台**: 微信小程序

## 项目结构

```
orderFood/
├── backend/              # Spring Boot 后端
│   ├── jeecg-boot-base-core/          # 核心基础模块
│   ├── jeecg-module-system/           # 系统管理模块
│   ├── jeecg-module-orderfood/        # 菜品订单模块（核心业务）
│   └── jeecg-server-cloud/            # 微服务模块
├── background/           # Vue3 管理后台
├── miniProgram/          # uni-app 微信小程序
├── db/                   # 数据库脚本
└── docs/                 # 项目文档
```

## 快速开始

### 环境要求

- **JDK**: 8+ (支持 Java 17)
- **Node.js**: 14.18+ / 16+
- **MySQL**: 5.7+
- **Redis**: 3.0+
- **Maven**: 3.6+

### 后端启动

```bash
# 1. 导入数据库
mysql -u root -p < db/init.sql

# 2. 修改配置
# 编辑 backend/jeecg-module-system/jeecg-system-start/src/main/resources/application-dev.yml
# 配置数据库连接、Redis 等信息

# 3. 启动后端（单体模式）
cd backend
mvn clean install
# 运行 JeecgSystemApplication (端口 8080)
```

### 前端管理后台启动

```bash
cd background
pnpm install
pnpm dev  # 默认端口 3100
```

### 小程序启动

```bash
cd miniProgram

# 1. 配置环境（本地测试/线上发布）
# 方式1: 双击运行 切换环境.bat (Windows)
# 方式2: 修改 src/config/env.ts

# 2. 使用微信开发者工具打开项目目录
# 3. 编译运行
```

## 核心功能

### 1. 菜品管理
- ✅ 菜品分类管理
- ✅ 菜品信息维护（名称、价格、图片、描述）
- ✅ 食材配方配置
- ✅ 制作步骤管理
- ✅ 菜品搜索（支持模糊匹配）

### 2. 订单管理
- ✅ 菜品下单
- ✅ 购物车功能
- ✅ 订单状态跟踪（待完成/待采购/已完成/已取消）
- ✅ 订单详情查看

### 3. 采购管理
- ✅ 采购单生成（自动汇总食材需求）
- ✅ 菜单列表管理（可调整菜品份数）
- ✅ 食材清单管理（自动重新计算）
- ✅ 单个食材采购状态标记
- ✅ 采购单状态管理

## 接口文档

启动后端后访问：`http://localhost:8080/jeecg-boot/doc.html`

## 部署说明

### Docker 部署

```bash
# 构建后端镜像
cd backend
docker build -t orderfood-backend .

# 构建前端镜像
cd background
docker build -t orderfood-frontend .

# 使用 Docker Compose 启动
docker-compose up -d
```

### 小程序发布

1. 修改环境配置：`src/config/env.ts` 改为 `'production'`
2. 微信小程序后台配置服务器域名：`https://ceshi.fzzhengxinyun.com`
3. 微信开发者工具上传代码
4. 提交审核

## 开发文档

详细文档请查看：
- [CLAUDE.md](CLAUDE.md) - 开发规范和项目说明
- [docs/菜品制作与下单小程序内部运营.md](docs/菜品制作与下单小程序内部运营.md) - 业务需求文档
- [miniProgram/环境配置说明.md](miniProgram/环境配置说明.md) - 小程序环境配置

## 更新日志

### 2025-12-07
- ✨ 新增采购单菜品明细功能
- ✨ 支持调整菜品份数并自动重新计算食材需求
- ✨ 小程序首页新增菜品搜索功能（支持模糊匹配）
- ✨ 新增小程序环境配置切换工具
- 🐛 修复菜品列表接口 dishName 精确匹配问题

### 2025-12-06
- ✨ 初始版本发布
- ✨ 实现菜品管理、订单管理、采购管理核心功能

## 技术支持

- 官方文档：https://help.jeecg.com
- QQ 群：808791225

## 开源协议

[MIT License](LICENSE)

## 贡献者

感谢所有为本项目做出贡献的开发者！

---

**注意**：本项目基于 JeecgBoot 低代码平台开发，感谢 JeecgBoot 团队提供的优秀框架！