# order_server

**Repository Path**: fanyouf/order_server

## Basic Information

- **Project Name**: order_server
- **Description**: No description available
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 烧烤店点餐小程序后台接口服务器

学生期末学习项目，基于 Node.js + Express + SQLite 开发。

## 功能特性

- 用户管理：注册、登录、修改密码、上传头像
- 餐桌管理：餐桌列表、绑定/释放餐桌
- 菜品管理：50道预设菜品、分类查询、分页查询
- 购物车：添加、修改、删除、查看购物车
- 订单管理：创建订单、查看订单、取消订单
- 接口文档：Swagger UI 可视化文档

## 技术栈

- Node.js
- Express.js
- SQLite (better-sqlite3)
- JWT 认证
- Swagger UI
- Circle CI

## 快速开始

### 安装依赖

```bash
npm install
```

### 初始化数据库

```bash
npm run init-db
```

### 启动服务器

```bash
npm start
```

开发模式（自动重启）：

```bash
npm run dev
```

### 访问接口文档

启动服务器后，访问：http://localhost:3000/api-docs

## 项目结构

```
.
├── app.js              # 主入口文件
├── package.json        # 项目配置
├── config/
│   └── database.js     # 数据库配置
├── controllers/        # 控制器
│   ├── users.js
│   ├── tables.js
│   ├── dishes.js
│   ├── cart.js
│   └── orders.js
├── routes/             # 路由
│   ├── users.js
│   ├── tables.js
│   ├── dishes.js
│   ├── cart.js
│   └── orders.js
├── middleware/         # 中间件
│   └── auth.js
├── scripts/            # 脚本
│   └── init-db.js      # 数据库初始化
├── data/               # 数据库文件目录
├── uploads/            # 上传文件目录
└── .circleci/          # CI配置
    └── config.yml
```

## API 说明

### 认证方式

需要认证的接口，在请求头中添加：

```
Authorization: Bearer <token>
```

### 主要接口

- `POST /api/users/register` - 用户注册
- `POST /api/users/login` - 用户登录
- `GET /api/dishes` - 获取菜品列表（支持分页和分类筛选）
- `GET /api/dishes/categories` - 获取分类列表
- `POST /api/orders` - 创建订单

完整接口文档请启动服务器后访问 Swagger UI。

## 预设菜品

包含50道烧烤店常见菜品，分为4个分类：
- 烤肉类（20道）
- 素菜类（15道）
- 海鲜类（8道）
- 主食小吃（7道）