# 后台管理系统使用说明

## 📖 功能简介

后台管理系统提供了完整的书籍管理功能，包括：
- ✅ 管理员登录（只有管理员可以登录）
- ✅ 书籍列表查询（支持搜索、筛选、分页）
- ✅ 添加书籍
- ✅ 编辑书籍
- ✅ 删除书籍（单个/批量）
- ✅ 上架/下架书籍（单个/批量）
- ✅ 书籍状态管理

## 🚀 快速开始

### 1. 启动后端服务

```bash
cd book
mvn spring-boot:run
```

### 2. 启动前端开发服务器

```bash
cd book-admin
npm install  # 首次使用
npm run dev  # 启动开发服务器
```

### 3. 登录系统

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

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

## 🎯 功能使用

### 1. 登录系统

1. 打开登录页面
2. 输入用户名和密码
3. 点击"登录"按钮
4. 登录成功后自动跳转到书籍管理页面

### 2. 查看书籍列表

1. 登录成功后进入书籍管理页面
2. 可以看到书籍列表（分页显示）
3. 支持搜索和筛选功能

### 3. 搜索书籍

1. 在搜索框中输入关键词（书名、作者）
2. 系统会自动搜索（防抖处理，500ms延迟）
3. 搜索结果实时更新

### 4. 筛选书籍

1. 选择状态筛选（上架/下架）
2. 选择分类筛选
3. 点击"查询"按钮或自动筛选

### 5. 添加书籍

1. 点击"添加书籍"按钮
2. 填写书籍信息：
   - 书名（必填）
   - 作者
   - 封面URL
   - 图片URL
   - 简介
   - 描述
   - 详细介绍
   - 价格
   - 是否免费
   - 是否VIP
   - 分类
   - 状态（必填，上架/下架）
3. 点击"保存"按钮
4. 书籍创建成功后会刷新列表

### 6. 编辑书籍

1. 点击书籍列表中的"编辑"按钮
2. 修改书籍信息
3. 点击"保存"按钮
4. 书籍更新成功后会刷新列表

### 7. 删除书籍

#### 单个删除
1. 点击书籍列表中的"删除"按钮
2. 确认删除
3. 书籍删除成功后会刷新列表

#### 批量删除
1. 选中多个书籍（勾选复选框）
2. 点击"批量删除"按钮
3. 确认删除
4. 书籍删除成功后会刷新列表

### 8. 上架/下架书籍

#### 单个操作
1. 点击书籍列表中的"上架"或"下架"按钮
2. 书籍状态更新成功后会刷新列表

#### 批量操作
1. 选中多个书籍（勾选复选框）
2. 点击"批量上架"或"批量下架"按钮
3. 书籍状态更新成功后会刷新列表

### 9. 分页浏览

1. 点击"上一页"或"下一页"按钮
2. 查看当前页码和总页数
3. 查看总记录数

### 10. 退出登录

1. 点击"退出登录"按钮
2. 确认退出
3. 清除登录信息，跳转到登录页面

## 🔍 功能特性

### 1. 搜索功能

- 支持按书名、作者搜索
- 实时搜索（防抖处理）
- 搜索结果高亮显示

### 2. 筛选功能

- 支持按状态筛选（上架/下架）
- 支持按分类筛选
- 支持组合筛选

### 3. 分页功能

- 支持分页查询
- 显示当前页码和总页数
- 显示总记录数
- 支持上一页/下一页导航

### 4. 批量操作

- 支持全选/取消全选
- 支持批量删除
- 支持批量上架
- 支持批量下架

### 5. 数据验证

- 前端表单验证
- 后端参数验证
- 错误提示信息

### 6. 状态管理

- 书籍状态显示（上架/下架）
- 状态颜色区分（绿色-上架，红色-下架）
- 状态切换功能

## 📊 数据统计

### 书籍统计

- 总记录数
- 当前页码
- 总页数
- 每页记录数

### 状态统计

- 上架书籍数量
- 下架书籍数量

## 🔐 权限控制

### 登录权限

- 只有管理员（role='admin'）可以登录
- 普通用户（role='user'）不能登录
- 登录时验证用户角色和状态

### 接口权限

- 所有后台管理接口都需要token
- Token验证通过后才能访问
- Token无效时返回401错误

## 💡 使用技巧

### 1. 快速搜索

- 输入关键词后等待500ms，系统自动搜索
- 支持书名、作者搜索
- 搜索结果实时更新

### 2. 批量操作

- 使用全选功能快速选中所有书籍
- 使用批量操作功能快速处理多个书籍
- 操作前会确认，防止误操作

### 3. 状态管理

- 上架书籍会显示在小程序中
- 下架书籍不会显示在小程序中
- 可以通过状态筛选查看上架/下架书籍

### 4. 数据管理

- 添加书籍时设置合适的分类
- 设置合适的价格和VIP状态
- 上传合适的封面图片
- 填写详细的书籍介绍

## 🆘 常见问题

### 1. 无法登录

**问题：** 提示"用户名或密码错误"

**解决：**
- 检查用户名和密码是否正确
- 检查用户角色是否为admin
- 检查用户状态是否为1（启用）

### 2. 无法加载书籍列表

**问题：** 书籍列表为空或加载失败

**解决：**
- 检查后端服务是否启动
- 检查数据库连接是否正常
- 检查token是否有效
- 查看浏览器控制台错误信息

### 3. 无法保存书籍

**问题：** 保存书籍时提示错误

**解决：**
- 检查必填字段是否填写
- 检查数据格式是否正确
- 查看错误提示信息
- 检查后端服务日志

### 4. 无法删除书籍

**问题：** 删除书籍时提示错误

**解决：**
- 检查书籍是否存在
- 检查是否有权限删除
- 查看错误提示信息
- 检查后端服务日志

## 📚 相关文档

- `README.md` - 功能说明和API文档
- `启动指南.md` - 详细启动步骤
- `完整功能说明.md` - 完整功能说明
- `快速启动.md` - 快速启动指南
- `项目结构说明.md` - 项目结构说明