一、项目简介

古诗词查录系统是一套基于 Spring Boot 3 + Vue 3 + MySQL 的前后端分离项目，旨在为用户提供古诗词的浏览、检索、收藏、笔记与评论等功能。系统采用前后端分离架构，后端提供 RESTful API，前端通过 Vue 3 进行页面渲染与交互。系统支持普通用户与管理员双角色，普通用户可浏览诗词、收藏、写笔记、发表评论；管理员可管理诗词、诗人、朝代、分类、用户、评论及系统配置，并查看数据统计仪表盘。

二、技术栈

三、功能模块

管理员端

• 数据概览：查看诗词总数、用户总数、评论总数、待审核评论数等统计卡片数据，并展示朝代诗词分布柱状图、分类占比饼图、月度新增趋势折线图。
• 诗词管理：分页查看诗词列表，支持按标题/诗人/朝代/分类/状态筛选；可新增、编辑、删除诗词，支持一键切换上下架状态及批量下架。
• 诗人管理：分页查看诗人列表，支持按朝代筛选；可新增、编辑、删除诗人（若诗人下有诗词则不允许删除）。
• 朝代管理：分页查看朝代列表，支持关键词搜索；可新增、编辑、删除朝代（若朝代下有诗词则不允许删除）。
• 分类管理：分页查看分类列表，支持关键词搜索；可新增、编辑、删除分类（若分类下有诗词则不允许删除）。
• 用户管理：分页查看用户列表，支持按角色/状态筛选；可新增用户、编辑用户信息、重置密码为 123456、启用/禁用用户。
• 评论管理：分页查看评论列表，支持按状态（待审核/通过/屏蔽）、诗词筛选；可审核通过或屏蔽单条评论，支持删除评论。
• 系统设置：查看/编辑站点名称、Logo 等系统配置键值对，支持批量保存。
• 操作日志：分页查看系统操作日志，支持一键清空。

普通用户端

• 诗词列表：支持按诗人、朝代、分类、体裁、关键词、上下架状态等条件筛选，分页展示诗词标题、诗人、朝代、分类、封面图、浏览量、收藏数。
• 诗词详情：展示标题、原文、注释、译文、赏析、标签、诗人、朝代、分类、封面图、浏览量、收藏数，并提供推荐诗词（同诗人或同朝代）。
• 收藏诗词：点击收藏按钮切换收藏状态，收藏后诗词收藏数实时更新；可在“我的收藏”页面分页查看已收藏诗词列表并支持取消收藏。
• 撰写笔记：在诗词详情页编辑/保存笔记，支持保存或更新；笔记列表分页展示诗词标题与诗人名。
• 发表评论：在诗词详情页提交评论内容，评论需管理员审核通过后展示；按诗词查看已通过的评论列表，显示评论者昵称、头像、内容及发表时间。
• 浏览历史：自动记录用户浏览的诗词，支持分页查看与一键清空。
• 诗人列表：按朝代筛选诗人，展示姓名、朝代、头像、作品数量；点击进入诗人详情页，查看姓名、朝代、生卒年、生平介绍、主要成就及作品列表。
• 排行榜：按浏览量或收藏量展示诗词 Top N 榜单。
• 用户注册与登录：填写用户名、密码、昵称、邮箱、手机号、验证码完成注册；通过用户名/密码及验证码登录，返回 JWT Token；支持忘记密码（输入用户名，密码自动重置为 123456）。
• 个人中心：查看/修改个人信息（昵称、邮箱、手机号、性别、头像、简介）；支持修改密码（输入旧密码、新密码）；支持文件上传（图片等，返回可访问 URL）。
• 查看系统配置：通过公开接口获取站点名称、Logo 等配置信息。

四、项目总结

本项目技术亮点在于采用 Spring Boot 3 + Vue 3 的现代前后端分离架构，后端使用 MyBatis-Plus 简化数据访问层开发，JWT 实现无状态认证，前端使用 Pinia 管理状态，Vite 提升开发与构建效率。系统功能覆盖了古诗词资源的完整管理链路，适合作为 Java 全栈开发的学习案例、课程设计或毕业设计参考，也可用于实际文化类网站或 App 的二次开发基础。

界面展示

交付内容

本项目为完整交付，包含：

• 完整后端源码
• 完整前端源码
• 数据库初始化脚本（SQL）
• 万字项目文档（设计文档 / 论文，可作课程设计、毕业设计参考）

获取完整源码

完整前后端源码 + 数据库脚本 + 万字项目文档见 Gitee 仓库：https://gitee.com/kangxihuang/src-K024