5zu-books

听书阅读系统

项目简介

听书阅读系统是一个集电子书阅读和听书功能于一体的综合平台，包含用户管理、内容管理、阅读/听书功能等核心模块。

技术栈

后端

• Spring Boot 3.0.2
• MyBatis-Plus 3.5.3.1
• Spring Security
• JWT
• MySQL 8.0
• Java 17

前端管理端

• Vue 3
• Element Plus
• Vue Router
• Pinia
• Axios
• Vite

项目结构

book/
├── src/main/java/com/zhentao/
│   ├── pojo/              # 实体类
│   ├── mapper/            # MyBatis Mapper接口
│   ├── service/           # Service层
│   │   └── impl/          # Service实现类
│   ├── controller/        # Controller层
│   ├── common/            # 通用类（Result、JwtUtil等）
│   ├── config/            # 配置类
│   └── BookApplication.java
├── src/main/resources/
│   └── application.properties  # 配置文件
└── admin-frontend/        # Vue3前端管理端
    ├── src/
    │   ├── api/           # API接口
    │   ├── views/         # 页面组件
    │   ├── layout/        # 布局组件
    │   ├── router/        # 路由配置
    │   └── stores/        # Pinia状态管理
    └── package.json

数据库配置

1. 执行 d:\桌面\book.sql 中的SQL脚本创建数据库和表结构

2. 修改 src/main/resources/application.properties 中的数据库连接信息：

   spring.datasource.url=jdbc:mysql://192.168.254.101:3306/book?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
   spring.datasource.username=root
   spring.datasource.password=your_password
   

后端启动

1. 确保已安装Java 17和Maven

2. 在项目根目录执行：

   mvn clean install
   mvn spring-boot:run
   

3. 后端服务将在 http://localhost:8080 启动

前端管理端启动

1. 进入前端目录：

   cd admin-frontend
   

2. 安装依赖：

   npm install
   

3. 启动开发服务器：

   npm run dev
   

4. 前端管理端将在 http://localhost:3000 启动

核心功能模块

用户模块

• 登录/注册
• 用户信息管理
• 用户状态管理
• 会员等级管理

书籍管理模块

• 书籍上传（通过API）
• 书籍分类
• 书籍检索
• 章节管理

阅读功能模块

• 字体大小调节
• 书签功能
• 目录
• 翻页模式
• 背景颜色设置

听书功能模块

• 音频播放
• 语速调节
• 章节切换
• 定时

个人中心模块

• 个人信息管理
• 阅读/听书历史记录
• 阅读时长统计
• 会员制度

API接口

管理员接口

• POST /api/admin/login - 管理员登录
• POST /api/admin/register - 管理员注册

用户管理

• GET /api/admin/user/page - 分页查询用户
• GET /api/admin/user/{id} - 获取用户详情
• POST /api/admin/user - 新增用户
• PUT /api/admin/user - 更新用户
• DELETE /api/admin/user/{id} - 删除用户
• PUT /api/admin/user/status/{id} - 更新用户状态
• PUT /api/admin/user/member/{id} - 更新会员等级

内容管理

• GET /api/admin/content/page - 分页查询内容
• GET /api/admin/content/{id} - 获取内容详情
• POST /api/admin/content - 新增内容
• PUT /api/admin/content - 更新内容
• DELETE /api/admin/content/{id} - 删除内容

分类管理

• GET /api/admin/category/tree - 获取分类树
• GET /api/admin/category/list - 获取分类列表
• POST /api/admin/category - 新增分类
• PUT /api/admin/category - 更新分类
• DELETE /api/admin/category/{id} - 删除分类

标签管理

• GET /api/admin/tag/list - 获取标签列表
• POST /api/admin/tag - 新增标签
• PUT /api/admin/tag - 更新标签
• DELETE /api/admin/tag/{id} - 删除标签

章节管理

• GET /api/admin/book-chapter/list/{contentId} - 获取电子书章节列表
• GET /api/admin/audio-chapter/list/{contentId} - 获取听书章节列表

注意事项

1. 首次使用需要先创建管理员账号（通过注册接口或直接插入数据库）
2. JWT token需要在前端请求头中携带：Authorization: Bearer {token}
3. 文件上传功能需要配置文件存储路径
4. 数据库密码请根据实际情况修改

开发说明

• 后端代码统一放在 com.zhentao 包下
• 实体类放在 com.zhentao.pojo 包下
• 遵循RESTful API设计规范
• 统一使用 Result<T> 作为响应格式