# Training Full-Stack Project

前后端分离的全栈项目基础工程：

- `frontend`: React 18 + TypeScript + Vite
- `backend`: Spring Boot + Java 21 + Maven + MyBatis-Plus
- `MySQL`: 外部 MySQL 8 数据库，由环境变量提供连接配置

## 环境要求

- Node.js 20+
- JDK 21+
- Maven 3.9+（或使用项目中的 Maven Wrapper）
- 可访问目标 MySQL 的网络和账号

## 配置数据库

项目不会创建或启动 MySQL。请先确保 `.env.example` 中配置的 MySQL 服务已经运行并允许当前机器访问。

Spring Boot 启动时按以下顺序读取配置：根目录 `.env`，然后是根目录 `.env.example`。同名变量以 `.env` 为准；没有 `.env` 时直接使用已配置的 `.env.example`。

建议将 `.env.example` 复制为本地 `.env`，实际 `.env` 不提交到仓库：

```powershell
cp .env.example .env
```

生产环境使用 `.env.production.example` 作为 `.env` 模板，或由部署平台注入同名环境变量：

```powershell
cp .env.production.example .env
```

需要确认 `MYSQL_HOST`、`MYSQL_PORT`、`MYSQL_DATABASE`、`MYSQL_USER` 和 `MYSQL_PASSWORD` 均已配置。生产环境建议使用部署平台的 Secret 管理能力。

## 启动后端

```bash
mvn -f backend/pom.xml spring-boot:run
```

后端默认运行在 `http://localhost:8080`，健康检查地址为 `GET /api/health`。

## 启动前端

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

前端默认运行在 `http://localhost:5173`，开发服务器会将 `/api` 请求代理到后端。

## 构建检查

```bash
cd frontend
npm run build

cd ../backend
mvn clean verify
```