Back_end_Management_System/book-admin/使用说明.md

后台管理系统使用说明

📖 功能简介

后台管理系统提供了完整的书籍管理功能，包括：

• ✅ 管理员登录（只有管理员可以登录）
• ✅ 书籍列表查询（支持搜索、筛选、分页）
• ✅ 添加书籍
• ✅ 编辑书籍
• ✅ 删除书籍（单个/批量）
• ✅ 上架/下架书籍（单个/批量）
• ✅ 书籍状态管理

🚀 快速开始

1. 启动后端服务

cd book
mvn spring-boot:run

2. 启动前端开发服务器

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 - 项目结构说明