后台管理系统功能说明

功能概述

实现了完整的后台管理系统，用于管理小程序中的书籍数据，包括：

管理员登录 - 只有管理员可以登录后台管理系统
书籍管理 - 书籍的增删改查
书籍状态管理 - 上架/下架操作
批量操作 - 批量删除、批量上架、批量下架

数据库设计

1. 用户表添加role字段

在 users 表中添加 role 字段，用于区分管理员和普通用户：

ALTER TABLE `users` 
ADD COLUMN `role` VARCHAR(20) DEFAULT 'user' COMMENT '用户角色：admin-管理员，user-普通用户' AFTER `status`,
ADD INDEX `idx_role` (`role`);

2. 创建默认管理员账号

执行 admin_schema.sql 脚本会自动创建默认管理员账号：

用户名：admin
密码：admin123（MD5加密后：0192023a7bbd73250516f069df18b500）
角色：admin

后端实现

1. 实体类更新

文件：book/src/main/java/com/yu/book/domain/User.java

添加 role 字段：

private String role; // 用户角色：admin-管理员，user-普通用户

2. Mapper更新

文件：book/src/main/resources/mapper/UserMapper.xml

在 resultMap 中添加 role 字段映射
在 insert 语句中添加 role 字段
在 update 语句中添加 role 字段更新

3. 管理员登录服务

文件：book/src/main/java/com/yu/book/admin/service/AdminService.java

主要功能：

验证用户名和密码
检查用户角色，只有 role 为 admin 的用户可以登录
检查用户状态
返回管理员信息和token

4. 管理员登录接口

文件：book/src/main/java/com/yu/book/admin/controller/AdminController.java

接口：POST /api/admin/login

5. 书籍管理服务

文件：book/src/main/java/com/yu/book/admin/service/AdminBookService.java

主要功能：

分页查询书籍（支持关键词、分类、状态筛选）
根据ID查询书籍
创建书籍
更新书籍
删除书籍
批量删除书籍
上架书籍
下架书籍
批量上架书籍
批量下架书籍

6. 书籍管理接口

文件：book/src/main/java/com/yu/book/admin/controller/AdminBookController.java

接口列表：

GET /api/admin/book/list - 分页查询书籍
GET /api/admin/book/{id} - 根据ID查询书籍
POST /api/admin/book - 创建书籍
PUT /api/admin/book/{id} - 更新书籍
DELETE /api/admin/book/{id} - 删除书籍
DELETE /api/admin/book/batch - 批量删除书籍
PUT /api/admin/book/{id}/publish - 上架书籍
PUT /api/admin/book/{id}/unpublish - 下架书籍
PUT /api/admin/book/batch/publish - 批量上架书籍
PUT /api/admin/book/batch/unpublish - 批量下架书籍

7. 权限拦截器

文件：book/src/main/java/com/yu/book/admin/interceptor/AdminInterceptor.java

功能：

拦截所有 /api/admin/** 路径的请求
排除登录接口 /api/admin/login
验证请求头中的token
如果token无效，返回401未授权错误

8. Web配置

文件：book/src/main/java/com/yu/book/admin/config/AdminWebConfig.java

配置拦截器：

拦截路径：/api/admin/**
排除路径：/api/admin/login

前端实现

1. API接口文件

文件：book-admin/utils/api.js

包含所有后台管理系统的API接口：

管理员登录
书籍管理（增删改查）
书籍上架/下架
批量操作
分类查询

2. 登录页面

文件：book-admin/pages/login.html

功能：

管理员登录表单
用户名和密码验证
登录成功后保存token到localStorage
跳转到书籍管理页面

3. 书籍管理页面

文件：book-admin/pages/books.html

功能：

书籍列表展示
搜索和筛选功能
分页功能
添加书籍
编辑书籍
删除书籍
上架/下架书籍
批量操作
退出登录

使用步骤

1. 数据库初始化

# 执行数据库脚本
mysql -u root -p books_db < book/src/main/resources/db/admin_schema.sql

2. 启动后端服务

确保后端服务已启动（端口8081）

3. 打开前端页面

使用浏览器打开 book-admin/pages/login.html

4. 登录

使用默认管理员账号登录：

用户名：admin
密码：admin123

5. 管理书籍

登录成功后，可以：

查看书籍列表
搜索和筛选书籍
添加新书籍
编辑现有书籍
删除书籍
上架/下架书籍
批量操作

权限控制

1. 登录权限

只有 role 为 admin 的用户可以登录后台管理系统
普通用户（role 为 user）尝试登录会返回错误："您不是管理员，无权登录后台管理系统"

2. 接口权限

所有后台管理接口都需要在请求头中携带token
Token格式：admin_token_{userId}
如果token无效或缺失，会返回401未授权错误

3. 前端权限

登录页面会检查是否已登录，如果已登录会跳转到书籍管理页面
书籍管理页面会检查token，如果token不存在会跳转到登录页面

接口说明

管理员登录

POST /api/admin/login

请求体：

{
  "username": "admin",
  "password": "admin123"
}

响应：

{
  "code": 200,
  "message": "登录成功",
  "data": {
    "id": 1,
    "username": "admin",
    "nickname": "管理员",
    "role": "admin",
    "token": "admin_token_1"
  }
}

书籍管理接口

所有书籍管理接口都需要在请求头中携带token：

Authorization: admin_token_1

分页查询书籍

GET /api/admin/book/list?page=1&size=10&keyword=&status=1&categoryId=

参数：

page - 页码（默认：1）
size - 每页数量（默认：10）
keyword - 关键词（可选，搜索书名、作者）
status - 状态（可选，0-下架，1-上架）
categoryId - 分类ID（可选）

响应：

{
  "code": 200,
  "message": "成功",
  "data": {
    "list": [...],
    "total": 100,
    "page": 1,
    "size": 10
  }
}

创建书籍

POST /api/admin/book

请求体：

{
  "title": "书名",
  "author": "作者",
  "cover": "封面URL",
  "image": "图片URL",
  "brief": "简介",
  "desc": "描述",
  "introduction": "详细介绍",
  "price": 0.00,
  "isFree": false,
  "isVip": false,
  "categoryId": 1,
  "status": 1
}

更新书籍

PUT /api/admin/book/{id}

请求体：同创建书籍

删除书籍

DELETE /api/admin/book/{id}

上架书籍

PUT /api/admin/book/{id}/publish

下架书籍

PUT /api/admin/book/{id}/unpublish

创建管理员账号

方法1：使用SQL脚本

执行 admin_schema.sql 脚本会自动创建默认管理员账号。

方法2：手动创建

在数据库中执行以下SQL：

-- 创建管理员账号
INSERT INTO `users` (`username`, `nickname`, `password`, `role`, `status`, `created_at`, `updated_at`)
VALUES ('admin', '管理员', '0192023a7bbd73250516f069df18b500', 'admin', 1, NOW(), NOW());

-- 密码：admin123（MD5加密后：0192023a7bbd73250516f069df18b500）

或者将现有用户设置为管理员：

UPDATE `users` SET `role` = 'admin' WHERE `username` = 'your_username';

方法3：使用Java代码生成密码

import com.yu.book.util.PasswordUtil;

String password = "admin123";
String encryptedPassword = PasswordUtil.encrypt(password);
System.out.println("加密后的密码: " + encryptedPassword);

注意事项

密码加密：系统使用MD5加密密码，默认管理员密码 admin123 的MD5值为 0192023a7bbd73250516f069df18b500
Token管理：当前使用的是模拟token（admin_token_{userId}），实际项目中应该使用JWT Token
权限验证：权限拦截器会验证token，如果token无效会返回401错误
CORS配置：后端已配置CORS，允许跨域请求
API地址：前端API地址配置在 book-admin/utils/api.js 中，默认是 http://localhost:8081
Vue.js版本：前端使用Vue.js 3，通过CDN引入

测试建议

登录测试：
- 使用管理员账号登录
- 使用普通用户账号登录（应该失败）
- 使用错误的密码登录（应该失败）
权限测试：
- 不携带token访问接口（应该返回401）
- 携带无效token访问接口（应该返回401）
- 携带有效token访问接口（应该成功）
功能测试：
- 添加书籍
- 编辑书籍
- 删除书籍
- 上架/下架书籍
- 批量操作
- 搜索和筛选

后续优化

JWT Token：使用JWT Token替代模拟token
Token过期：添加token过期时间管理
操作日志：记录管理员操作日志
数据统计：添加数据统计功能（书籍数量、用户数量等）
用户管理：添加用户管理功能
分类管理：添加分类管理功能
图片上传：添加图片上传功能
数据导出：添加数据导出功能（Excel、CSV等）
权限细化：细化权限管理（不同管理员有不同的权限）
操作确认：添加操作确认对话框，防止误操作

后台管理系统功能说明.md 9.1 KB Permalink History Raw