# 后台管理系统启动指南

## 📋 启动前准备

### 1. 检查环境
- ✅ Java 8 或以上版本
- ✅ Maven 3.x
- ✅ MySQL 5.7 或以上版本
- ✅ Node.js 和 npm（用于启动前端服务器）
- ✅ 浏览器（Chrome、Firefox、Edge等）

### 2. 检查数据库
- ✅ MySQL 服务已启动
- ✅ 数据库 `books_db` 已创建
- ✅ 数据库用户有权限访问

## 🚀 启动步骤

### 步骤1：初始化数据库

#### 1.1 执行数据库脚本

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

#### 1.2 验证管理员账号

```sql
-- 连接到MySQL
mysql -u root -p books_db

-- 查看管理员账号
SELECT id, username, nickname, role, status FROM users WHERE username = 'admin';
```

**期望结果：**
- 应该有一条记录
- `username` = 'admin'
- `role` = 'admin'
- `status` = 1

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

#### 2.1 使用Maven启动（推荐）

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

#### 2.2 使用IDE启动

1. 打开IDE（如IntelliJ IDEA、Eclipse等）
2. 导入项目（Maven项目）
3. 找到 `BookApplication.java` 文件
4. 右键点击 → Run 'BookApplication'
5. 等待服务启动完成

#### 2.3 验证后端服务

**查看启动日志：**
- 应该看到 `Started BookApplication` 日志
- 应该看到 `Tomcat started on port(s): 8081` 日志

**测试服务：**
- 打开浏览器，访问：`http://localhost:8081/api/admin/login`
- 如果能看到响应（即使是错误响应），说明服务已启动

### 步骤3：启动前端开发服务器

#### 3.1 安装依赖（首次使用）

```bash
# 进入book-admin目录
cd book-admin

# 安装依赖
npm install
```

#### 3.2 启动开发服务器

```bash
# 使用npm启动（推荐）
npm run dev

# 或者使用
npm start
```

**功能：**
- 启动本地服务器（端口8000）
- 自动打开浏览器
- 访问登录页面

#### 3.3 验证前端服务

**访问地址：**
- 登录页面：`http://localhost:8000/pages/login.html`
- 如果页面正常显示，说明前端服务已启动

### 步骤4：登录系统

#### 4.1 使用默认管理员账号登录

- **用户名：** `admin`
- **密码：** `admin123`

#### 4.2 登录成功

登录成功后，会自动跳转到书籍管理页面（`books.html`）

## 🔍 问题排查

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

**错误信息：** 端口被占用、数据库连接失败等

**解决方法：**
1. 检查端口8081是否被占用
2. 检查数据库配置（`application.properties`）
3. 检查MySQL服务是否启动
4. 检查数据库 `books_db` 是否存在

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

**错误信息：** "Failed to fetch"、"无法连接到后端服务"

**解决方法：**
1. 检查后端服务是否启动
2. 检查后端服务端口是否为8081
3. 检查前端API地址配置（`utils/api.js`）
4. 使用浏览器访问 `http://localhost:8081/api/admin/login` 测试

### 问题3：登录失败

**错误信息：** "用户名或密码错误"、"您不是管理员"

**解决方法：**
1. 检查管理员账号是否存在
2. 检查管理员账号角色是否为 `admin`
3. 检查管理员账号状态是否为 `1`（启用）
4. 检查密码是否正确（默认密码：admin123）

### 问题4：npm install 失败

**错误信息：** 网络错误、权限错误等

**解决方法：**
1. 检查网络连接
2. 使用国内镜像源：
   ```bash
   npm config set registry https://registry.npmmirror.com
   npm install
   ```
3. 清除缓存：
   ```bash
   npm cache clean --force
   npm install
   ```

### 问题5：端口被占用

**错误信息：** `Port 8000 is already in use`

**解决方法：**
1. 修改端口：编辑 `package.json`，修改端口号
2. 或者关闭占用端口的程序

## 📝 快速启动命令

### Windows

```batch
# 终端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  # 启动开发服务器
```

## ✅ 启动检查清单

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

## 🎯 启动后的操作

### 1. 测试登录
- 使用管理员账号登录
- 验证登录成功

### 2. 测试功能
- 查看书籍列表
- 添加书籍
- 编辑书籍
- 删除书籍
- 上架/下架书籍

### 3. 查看日志
- 后端服务日志
- 浏览器控制台日志
- 网络请求日志

## 💡 提示

1. **后端服务必须启动**：前端无法独立运行，必须依赖后端服务
2. **使用npm启动**：推荐使用 `npm run dev` 启动前端服务器
3. **检查端口**：确保8081和8000端口未被占用
4. **查看日志**：启动时查看日志，及时发现错误
5. **测试连接**：使用浏览器测试后端服务连接状态

## 🆘 需要帮助？

如果遇到问题，请：
1. 查看错误日志
2. 查看浏览器控制台
3. 检查后端服务是否启动
4. 检查数据库连接是否正常