# 后台管理系统快速启动指南

## 🚀 三步启动

### 步骤1：启动后端服务

```bash
# 在 book 项目根目录执行
cd book
mvn spring-boot:run
```

**等待看到：**
```
Started BookApplication
Tomcat started on port(s): 8081
```

### 步骤2：启动前端服务

```bash
# 打开新的终端窗口，进入 book-admin 目录
cd book-admin

# 首次使用需要安装依赖
npm install

# 启动前端开发服务器（自动打开浏览器）
npm run dev
```

### 步骤3：登录系统

访问：`http://localhost:8000/pages/login.html`

**默认管理员账号：**
- 用户名：`admin`
- 密码：`admin123`

## 📋 启动前检查

### 1. 检查数据库

确保MySQL服务已启动，并且数据库 `books_db` 已创建。

如果还没有创建管理员账号，执行：

```bash
# 在 book 项目根目录执行
mysql -u root -p books_db < src/main/resources/db/admin_schema.sql
```

### 2. 检查环境

- ✅ Java 17（已升级）
- ✅ Maven 3.x
- ✅ MySQL 5.7+ 或 MySQL 8.0+
- ✅ Node.js 和 npm

## 🔍 验证服务

### 后端服务验证

访问：`http://localhost:8081/api/admin/login`

如果能看到响应（即使是错误响应），说明后端服务已启动。

### 前端服务验证

访问：`http://localhost:8000/pages/login.html`

如果能看到登录页面，说明前端服务已启动。

## 📝 启动命令汇总

### Windows PowerShell

```powershell
# 终端1：启动后端服务
cd book
mvn spring-boot:run

# 终端2：启动前端服务
cd book-admin
npm install  # 首次使用
npm run dev
```

### Windows CMD

```cmd
# 终端1：启动后端服务
cd book
mvn spring-boot:run

# 终端2：启动前端服务
cd book-admin
npm install  # 首次使用
npm run dev
```

### Mac/Linux

```bash
# 终端1：启动后端服务
cd book
mvn spring-boot:run

# 终端2：启动前端服务
cd book-admin
npm install  # 首次使用
npm run dev
```

## 🆘 常见问题

### 问题1：后端服务无法启动

**错误：** 端口8081被占用

**解决：**
1. 检查8081端口是否被占用
2. 或者修改 `application.properties` 中的端口号

### 问题2：前端服务无法启动

**错误：** `npm: command not found`

**解决：**
1. 检查Node.js是否安装：`node -v`
2. 检查npm是否安装：`npm -v`
3. 如果未安装，请先安装Node.js

### 问题3：无法连接到后端服务

**错误：** "Failed to fetch"

**解决：**
1. 检查后端服务是否启动
2. 检查后端服务端口是否为8081
3. 检查前端API地址配置（`utils/api.js`）

### 问题4：登录失败

**错误：** "用户名或密码错误"

**解决：**
1. 检查管理员账号是否创建
2. 检查管理员账号角色是否为 `admin`
3. 检查密码是否正确（默认：admin123）

### 问题5：npm install 失败

**错误：** 网络错误

**解决：**
```bash
# 使用国内镜像源
npm config set registry https://registry.npmmirror.com
npm install
```

## ✅ 启动检查清单

- [ ] MySQL服务已启动
- [ ] 数据库 `books_db` 已创建
- [ ] 管理员账号已创建（用户名：admin，角色：admin）
- [ ] 后端服务已启动（端口8081）
- [ ] 前端依赖已安装（npm install）
- [ ] 前端服务已启动（端口8000）
- [ ] 可以访问登录页面
- [ ] 可以正常登录

## 📚 相关文档

- `README.md` - 完整功能说明
- `启动指南.md` - 详细启动步骤
- `使用说明.md` - 使用说明

## 🎯 快速访问

- **登录页面：** `http://localhost:8000/pages/login.html`
- **书籍管理页面：** `http://localhost:8000/pages/books.html`（需要登录）
- **后端API：** `http://localhost:8081/api/admin/login`