# student-motivation

**Repository Path**: brucezhao/student-motivation

## Basic Information

- **Project Name**: student-motivation
- **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-02-26
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 课堂激励系统

学生课堂激励系统，用于提高学生学习积极性。

## 技术栈

- **Backend**: Express.js + MySQL
- **Frontend**: Vue 3 + Vite + Element Plus

## 快速开始（Docker）

### 前置要求

- Docker >= 20.10
- Docker Compose >= 2.0

### 启动服务

```bash
# 构建并启动所有服务（使用 docker compose v2）
docker compose -p motivation-system up --build -d

# 或后台运行
docker compose -p motivation-system up -d --build
```

### 访问地址

- 前端: http://localhost:8080
- 后端 API: http://localhost:3000

### 初始化数据库

首次启动后，需要初始化数据库表结构：

```bash
# 方式一：进入容器执行
docker compose -p motivation-system exec backend node init-db.js

# 方式二：直接在宿主机执行
docker exec motivation_backend node init-db.js
```

### 常用命令

```bash
# 查看日志
docker compose -p motivation-system logs -f

# 停止服务
docker compose -p motivation-system down

# 停止并删除数据卷（重置数据库）
docker compose -p motivation-system down -v

# 重启某个服务
docker compose -p motivation-system restart backend
```

## 本地开发

### Backend

```bash
cd backend
npm install
npm run dev
```

### Frontend

```bash
cd frontend
npm install
npm run dev
```

### 数据库初始化

```bash
cd backend
node init-db.js
```

## 默认账户

- 教师账户: `admin` / `123456`
- 学生账户: 由教师创建

## 注意事项

1. **项目名**: 必须使用 `-p motivation-system` 指定项目名，否则中文路径会导致错误
2. **JWT Secret**: 生产环境请修改 `docker-compose.yml` 中的 `JWT_SECRET` 环境变量
3. **数据库密码**: 默认 `root123`，生产环境请修改
4. **数据持久化**: MySQL 数据存储在 Docker 卷中，删除容器不会丢失数据
5. **端口占用**: 确保 3306、3000、8080 端口未被占用