# campus-eat

**Repository Path**: cokee/campus-eat

## Basic Information

- **Project Name**: campus-eat
- **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-07-09
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Campus Eats 校园外卖平台

基于 Node.js + Express + MySQL 的校园外卖系统，包含 React + TypeScript 用户端和后台管理端。

## 运行环境

- Node.js 20+
- MySQL 8+
- npm

## 初始化数据库

`sql/init.sql` 是可重置脚本，会先删除旧的 `campus_eats` 数据库再重建。

```bash
mysql --default-character-set=utf8mb4 -h localhost -P 3307 -u root -pcokee < sql/init.sql
```

如本机 MySQL 端口或密码不同，请同步修改 `.env`。

## 启动项目

首次使用需要分别安装后端和 React 前端依赖：

```bash
npm install
npm --prefix frontend install
```

开发模式下，请分别启动后端 API 和 Vite 前端：

```bash
npm run dev
npm run frontend:dev
```

前端开发地址为 `http://localhost:5173`，Vite 会将 `/api`、图片和上传资源代理到 Express 服务。

准备演示或部署时，先构建 React 前端，再启动 Express：

```bash
npm run frontend:build
npm start
```

Express 会自动优先托管 `frontend/dist`；未构建时仍回退到旧版静态页面，避免迁移期间无法演示。

访问地址：

- React 前台首页：http://localhost:3000
- React 后台管理：http://localhost:3000/admin

## 测试账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 普通用户 | user1 | 123456 |
| 普通用户 | user2 | 123456 |
| 商家 | merchant1 | 123456 |
| 管理员 | admin | admin123 |

## 功能模块

- 用户模块：注册、登录、个人信息、地址管理
- 轮播图模块：首页轮播图展示、后台轮播图维护
- 商家模块：商家列表、商家详情、商家状态管理
- 菜品模块：菜品列表、分类筛选、后台新增/编辑/下架
- 购物车模块：加入购物车、修改数量、删除、清空
- 订单模块：创建订单、订单列表、详情、支付、取消、确认收货、后台状态管理
- 评价模块：提交评价、查看评价、后台回复评价

## 前端架构

- `frontend/src/pages.tsx`：用户端与后台页面路由组件
- `frontend/src/components/Shell.tsx`：统一导航、主题切换、移动端导航和玻璃容器
- `frontend/src/lib/api.ts`：与 Express REST API 对接的 TypeScript 请求层
- `frontend/src/lib/auth.tsx`：登录态和用户资料上下文
- `frontend/src/index.css`：Tailwind 引入、主题变量和响应式玻璃设计系统