初始化

README.md

@@ -0,0 +1,62 @@
+# 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
+```