一、项目简介墨韵书阁在线阅读系统是一套基于 SpringBoot3 Vue3 的前后端分离架构的完整源码项目定位为可直接用于学习或二次开发的阅读平台基础工程。系统包含前台门户、作者创作中心与后台管理三大端覆盖从用户注册登录、书籍浏览阅读、阅读进度追踪到作者发布作品、章节管理再到管理员对用户、书籍、分类、公告的全面审核与维护的完整业务链路。系统内置 JWT 身份认证、MD5 密码加密、MyBatis-Plus 分页查询等机制角色划分为 USER普通用户、AUTHOR作者、ADMIN管理员三种权限控制清晰适合作为商城类阅读平台的业务基座进行扩展。二、技术栈技术说明后端框架Spring Boot 3.xORM 框架MyBatis-Plus含分页插件权限认证JWTjjwt 自定义登录拦截器前端框架Vue 3Composition API script setup状态管理Pinia用户登录状态存储路由管理Vue Router 4含路由守卫鉴权UI 组件库Element Plus构建工具Vite基于 Vue3 工程标准数据库MySQL三、功能模块普通用户端用户注册与登录通过用户名、昵称、密码完成账号注册注册后自动分配 USER 角色登录校验用户名、密码及账号状态禁用账号无法登录登录成功签发 JWT Token 并返回用户基本信息。书籍列表浏览支持分页加载书籍列表可按书名关键词模糊搜索、按分类 ID 精确筛选仅展示审核通过status1的书籍列表项展示封面、书名、作者昵称、分类名称、章节数、字数、阅读量及连载状态。书籍详情查看点击书籍进入详情页展示书籍完整信息封面、描述、作者、分类、字数、阅读量、是否完结同时自动将书籍阅读量 1并获取该书全部章节列表按章节排序号升序仅含章节标题、字数、排序号。在线章节阅读通过阅读器页面按章节 ID 加载章节正文内容支持章节标题与正文展示可切换上一章/下一章进行连续阅读。阅读进度自动保存阅读时自动向服务器提交当前书籍 ID、章节 ID 与阅读进度百分比系统按用户书籍维度保存或更新最近阅读记录记录最后阅读时间。阅读历史列表展示当前用户全部阅读记录按最近阅读时间倒序排列每条记录显示书籍封面、书名、作者昵称、最近阅读章节标题支持删除单条历史记录。个人资料管理查看并修改个人昵称、头像、邮箱、手机号等基本信息用户名、角色、状态不可自行修改。修改登录密码输入原密码验证身份后可设置新密码密码经 MD5 加密后存储。首页推荐与热门书籍首页展示按阅读量倒序的推荐书籍默认 6 本与热门书籍榜单默认 10 本均仅含审核通过书籍。分类浏览前台展示全部分类列表每个分类附带该分类下已审核书籍数量点击分类可筛选对应书籍。站内公告查看前台首页展示最新发布的 5 条启用状态公告公告按发布时间倒序排列。作者端作品列表管理作者查看自己发布的全部书籍按创建时间倒序分页展示列表含封面、书名、分类、字数、阅读量、审核状态与章节数。新建书籍作者可创建新书需填写书名、封面、描述、分类、是否完结等信息新书默认审核状态为待审核status0阅读量与字数初始为 0。编辑书籍作者可修改自己名下书籍的标题、封面、描述、分类、完结状态等字段但不可修改作者 ID 与审核状态。删除书籍作者可删除自己名下的书籍删除后该书及其章节数据一并移除。章节列表管理查看指定书籍的全部章节按排序号升序展示章节标题、字数与排序号。新增章节作者可为自己的书籍添加新章节填写章节标题与正文内容系统自动计算正文字数并写入章节字数若未指定排序号则自动取当前最大排序号 1新增章节后自动累加更新书籍总字数。编辑章节修改章节标题、正文内容或排序号保存后重新计算该章节字数并同步更新书籍总字数。删除章节删除指定章节后自动重新计算并更新所属书籍的总字数。章节详情预览按章节 ID 获取章节完整内容含正文供作者编辑前预览或回显。管理员端数据概览统计管理员首页展示系统核心指标包括用户总数、书籍总数、分类总数与公告总数。用户列表查询分页展示全部用户支持按用户名或昵称模糊搜索列表含用户 ID、用户名、昵称、角色、状态、创建时间。新增用户管理员可手动添加用户需提供用户名、密码、昵称、角色、状态等信息密码自动 MD5 加密。编辑用户修改用户昵称、头像、邮箱、手机号、角色等字段若填写新密码则更新密码留空则保持原密码不变。删除用户根据用户 ID 移除指定用户账号。启用/禁用用户通过切换用户状态1 启用 / 0 禁用控制账号登录权限被禁用用户无法登录系统。修改用户角色直接调整用户角色支持在 USER、AUTHOR、ADMIN 三种角色间切换。书籍列表管理分页展示全部书籍含待审核、已通过、已拒绝所有状态支持按书名关键词、分类 ID、审核状态组合筛选。书籍审核操作对待审核书籍执行通过status1或拒绝status2操作审核结果即时生效。删除违规书籍管理员可强制删除任意书籍删除后该书及章节数据一并清除。分类列表管理查看全部分类每个分类附带该分类下已审核书籍数量分类按排序号升序排列。新增分类填写分类名称、描述、排序号即可创建新分类。编辑分类修改分类名称、描述、排序号等字段。删除分类移除指定分类删除后该分类下书籍将失去分类归属。公告列表管理分页展示全部公告含标题、封面、内容摘要、显示状态、发布时间。发布公告填写公告标题、封面图片、正文内容并设置显示状态1 显示 / 0 隐藏系统自动记录当前管理员 ID 为发布人。编辑公告修改公告标题、封面、内容或显示状态。删除公告移除指定公告删除后前台不再展示。四、项目总结本项目技术选型主流且组合经典SpringBoot3 Vue3 前后端分离架构清晰JWT 拦截器实现无状态认证MyBatis-Plus 简化数据层开发并内置分页能力Pinia Vue Router 守卫保障前端路由安全。功能覆盖阅读平台核心链路从用户端浏览阅读到作者端创作管理再到管理端审核运维角色边界明确字段设计合理适合作为 Java 全栈课程设计、毕业设计或阅读类产品初版的基础源码。代码结构规范业务逻辑直接便于二次扩展如评论、打赏、书架等高级功能。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K318