# WebProject

**Repository Path**: Shu-doc/WebProject

## Basic Information

- **Project Name**: WebProject
- **Description**: 线上自习室
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WebProject - 在线自习室

Spring Boot 3.2.8 + Vue 3 全栈在线自习室系统，包含用户端和管理端。

## 环境要求

| 依赖 | 版本 |
|------|------|
| JDK | 17+ |
| MySQL | 8.x |
| Node.js | ^20.19.0 或 >=22.12.0 |
| pnpm | 最新版 |

## 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/Shu-doc/WebProject.git
cd WebProject
```

### 2. 配置并启动后端

**2.1 创建数据库**

用 MySQL 客户端执行 `backend/src/main/resources/schema.sql`，或直接登录 MySQL 执行：

```bash
mysql -u root -p < backend/src/main/resources/schema.sql
```

> 该脚本会自动创建 `db_osr` 数据库及所有表，并插入默认管理员账号 `admin / 123456`。

**2.2 配置数据库连接**

```bash
cp backend/src/main/resources/application.properties.example backend/src/main/resources/application.properties
```

编辑 `application.properties`，将 `spring.datasource.password` 改为你的 MySQL 密码。

**2.3 启动后端**

```bash
cd backend

# macOS / Linux
./mvnw spring-boot:run

# Windows
mvnw.cmd spring-boot:run
```

后端启动后访问 http://localhost:8080，Swagger 文档地址 http://localhost:8080/swagger-ui.html。

### 3. 启动前端

前端是 pnpm monorepo，包含两个应用：

| 应用 | 路径 | 说明 |
|------|------|------|
| Vue-001 | `frontend/Vue-001/` | 用户端（JavaScript） |
| Vue-Project | `frontend/Vue-Project/` | 管理端（TypeScript） |

```bash
cd frontend

# 安装依赖
pnpm install

# 启动用户端（默认端口 5173）
pnpm --filter vue-001 dev

# 启动管理端（默认端口 5174）
pnpm --filter vue-project dev
```

### 4. 访问系统

| 入口 | 地址                             |
|------|--------------------------------|
| 用户端 | http://localhost:5173          |
| 管理端 | http://localhost:5174          |
| 后端 API | http://localhost:8080          |
| API 文档 | http://localhost:8080/doc.html |

### 默认管理员账号

- 账号：`admin`
- 密码：`123456`