# 点餐

**Repository Path**: seakomy/order-food

## 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**: 2026-01-12
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 餐饮点餐系统

一个完整的微信小程序餐饮点餐解决方案，包含用户端小程序、后台管理系统和服务端API。

## 项目结构

```
diancan/
├── mini-app/          # UniApp小程序 (Vue3 + TypeScript)
├── server/            # Node.js后端 (Express + TypeScript + Sequelize)
├── admin/             # 后台管理系统 (Vue3 + Vite + Element Plus)
├── database/          # 数据库脚本
└── docs/              # 项目文档
```

## 技术栈

| 端 | 技术栈 |
|----|--------|
| 用户端小程序 | UniApp + Vue3 + TypeScript + Pinia |
| 后台管理 | Vue3 + Vite + Element Plus + TypeScript |
| 服务端 | Node.js + Express + TypeScript + Sequelize |
| 数据库 | MySQL 8.0 + Redis |

## 功能模块

### 用户端小程序
- 首页：门店展示、快捷入口、营销Banner
- 点餐：菜品分类、规格选择、购物车
- 订单：订单列表、订单详情、取餐码
- 我的：个人中心、地址管理、订单记录

### 后台管理系统
- 数据看板：销售统计、订单趋势
- 门店管理：门店信息、营业设置、配送设置
- 菜品管理：分类管理、菜品列表、规格属性
- 订单管理：订单查询、状态管理、接单/拒单
- 系统设置：用户管理、系统配置

## 快速开始

### 环境要求
- Node.js >= 18.0.0
- MySQL >= 8.0 (可选)
- Redis (可选)

### 安装依赖

```bash
# 安装后端依赖
cd server && npm install

# 安装后台管理依赖
cd admin && npm install

# 安装小程序依赖
cd mini-app && npm install
```

### 配置环境变量

```bash
# 复制环境变量模板
cp server/.env.example server/.env

# 编辑配置文件，填写数据库和微信配置
```

### 初始化数据库 (可选)

```bash
# 创建数据库和表
mysql -u root -p < database/init.sql
mysql -u root -p < database/init_tables.sql

# 导入示例数据
mysql -u root -p < database/seed_data.sql
```

### 启动服务

```bash
# 启动后端服务 (端口 3000)
cd server && npm run dev

# 启动后台管理 (端口 8080)
cd admin && npm run dev

# 启动小程序开发
cd mini-app && npm run dev:mp-weixin
```

### 访问地址

| 服务 | 地址 |
|------|------|
| 后端API | http://localhost:3000 |
| 后台管理 | http://localhost:8080 |
| API健康检查 | http://localhost:3000/health |

### 后台登录

- 用户名：`admin`
- 密码：`admin123`

## API接口

### 接口规范
- 风格：RESTful
- 基础路径：`/api/v1`
- 数据格式：JSON

### 响应格式

```json
{
  "code": 0,
  "message": "success",
  "data": {}
}
```

### 主要接口

| 模块 | 接口 | 说明 |
|------|------|------|
| 用户 | POST /user/login | 微信登录 |
| 门店 | GET /store/list | 门店列表 |
| 菜品 | GET /dish/list | 菜品列表 |
| 订单 | POST /order | 创建订单 |
| 地址 | GET /address/list | 地址列表 |

## 项目截图

### 后台管理
- 登录页面
- 数据看板
- 门店管理
- 菜品管理
- 订单管理

### 小程序
- 首页
- 点餐页
- 订单列表
- 个人中心

## 开发计划

### 一期功能 (MVP)
- [x] 用户端首页、点餐、订单、我的
- [x] 后台门店、菜品、订单管理
- [x] 到店自取、外卖配送

### 二期功能
- [ ] 会员系统
- [ ] 优惠券功能
- [ ] 数据统计分析
- [ ] 营销活动管理

## 目录说明

```
server/
├── src/
│   ├── app.ts              # 应用入口
│   ├── config/             # 配置文件
│   ├── controllers/        # 控制器
│   ├── models/             # 数据模型
│   ├── routes/             # 路由定义
│   ├── middlewares/        # 中间件
│   └── utils/              # 工具函数

admin/
├── src/
│   ├── main.ts             # 入口文件
│   ├── router/             # 路由配置
│   ├── views/              # 页面组件
│   ├── layouts/            # 布局组件
│   └── assets/             # 静态资源

mini-app/
├── src/
│   ├── pages/              # 页面
│   ├── components/         # 组件
│   ├── store/              # 状态管理
│   ├── api/                # API封装
│   └── utils/              # 工具函数
```

## License

MIT