# works **Repository Path**: qzh200/works ## Basic Information - **Project Name**: works - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2025-12-19 - **Last Updated**: 2026-06-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 图书管理系统 (Library Management System) ## 项目概述 这是一个完整的全栈图书管理系统,采用前后端分离架构。系统为图书馆提供图书管理、用户管理、借阅审批、书评收藏等核心功能,支持普通用户和管理员两种角色。 ### 技术架构 **后端技术栈:** - Spring Boot 3.2.1 - Spring Security + JWT 认证 - Spring Data JPA + Hibernate - MySQL 8.0 - Java 17 - Maven **前端技术栈:** - Vue 3 (Composition API) - Vite (rolldown-vite) - Element Plus UI 组件库 - Vue Router 4 - Pinia 状态管理 - Axios - Sass ### 项目结构 ``` E:\works\ ├── spring/ # Spring Boot 后端项目 │ ├── src/main/java/com/example/librarymanagement/ │ │ ├── config/ # 安全配置 (SecurityConfig, JwtRequestFilter) │ │ ├── controller/ # REST API 控制器 │ │ ├── dto/ # 数据传输对象 │ │ ├── entity/ # JPA 实体类 │ │ ├── exception/ # 异常处理 │ │ ├── repository/ # JPA Repository │ │ ├── service/ # 业务逻辑层 │ │ └── util/ # 工具类 (JwtUtil, PasswordEncoderUtil) │ ├── src/main/resources/ │ │ └── application.properties # 应用配置 │ └── pom.xml # Maven 依赖配置 │ ├── vue/ # Vue 3 前端项目 │ ├── src/ │ │ ├── api/ # API 请求模块 (auth.js, request.js) │ │ ├── components/ # 公共组件 (NavBar, BookCover) │ │ ├── router/ # 路由配置 │ │ ├── stores/ # Pinia 状态管理 (user.js) │ │ └── views/ # 页面组件 │ │ ├── admin/ # 管理员页面 (Audit, BookManage) │ │ ├── auth/ # 认证页面 (Login, Register) │ │ └── user/ # 用户页面 (Home, BookDetail, Profile, MyFavorites) │ ├── .env.development # 开发环境配置 │ ├── .env.production # 生产环境配置 │ ├── vite.config.js # Vite 构建配置 │ └── package.json # npm 依赖配置 │ └── database/ # 数据库脚本 └── library_management_system.sql ``` ## 构建和运行 ### 后端 (Spring Boot) **环境要求:** - Java 17+ - Maven 3.6+ - MySQL 8.0+ **数据库初始化:** ```sql CREATE DATABASE library_management_system; ``` **配置文件:** `spring/src/main/resources/application.properties` - 默认端口: 8085 - 数据库: `jdbc:mysql://localhost:3306/library_management_system` - 用户名: root - 密码: 123456 **构建命令:** ```bash cd spring # 编译项目 mvn clean compile # 运行测试 mvn test # 打包项目 mvn clean package # 运行应用 mvn spring-boot:run # 或运行打包后的 JAR java -jar target/library-management-0.0.1-SNAPSHOT.jar ``` ### 前端 (Vue) **环境要求:** - Node.js 16+ - npm 或 yarn **配置文件:** - 开发环境 (.env.development): `VITE_API_BASE_URL=http://localhost:8085` - 生产环境 (.env.production): `VITE_API_BASE_URL=http://api.hrbustbbs.xyz/` **构建命令:** ```bash cd vue # 安装依赖 npm install # 启动开发服务器 (端口 3000) npm run dev # 构建生产版本 npm run build # 预览生产构建 npm run preview ``` ## 核心功能模块 ### 1. 用户管理 - 用户注册/登录(邮箱验证码) - 角色管理(USER/ADMIN) - 密码重置和修改 - 用户状态管理(ACTIVE/INACTIVE) ### 2. 图书管理 - 图书信息管理(增删改查) - 库存管理(总数量/可用数量) - 图书分类 - 图书状态(AVAILABLE/UNAVAILABLE/BORROWED) ### 3. 借阅管理 - 借书申请 - 管理员审批流程 - 借阅记录和历史 - 续借和还书功能 ### 4. 书评和收藏 - 书评系统(评分和评论) - 收藏功能 - 个性化推荐 ### 5. 审批系统 - 审批请求管理 - 审批日志记录 - 审批状态跟踪 ## API 接口 ### 认证相关 - `POST /api/auth/register` - 用户注册 - `POST /api/auth/login` - 用户登录 - `POST /api/auth/reset-password` - 重置密码 - `POST /api/auth/verify-code` - 验证邮箱验证码 ### 图书相关 - `GET /books` - 搜索图书 - `GET /books/{id}` - 获取图书详情 - `POST /books` - 添加图书(管理员) - `PUT /books/{id}` - 更新图书信息(管理员) - `DELETE /books/{id}` - 删除图书(管理员) - `GET /recommend` - 获取推荐图书 ### 借阅相关 - `POST /borrow` - 借书申请 - `POST /return` - 还书 - `POST /renew` - 续借 - `GET /borrow-history` - 借阅历史 ### 收藏和评论 - `POST /collection` - 收藏图书 - `DELETE /collection` - 取消收藏 - `GET /collection/status` - 检查收藏状态 - `POST /reviews` - 添加书评 - `GET /books/{id}/reviews` - 获取图书评论 ## 开发约定 ### 后端开发规范 **代码结构:** - 遵循标准 Spring Boot 分层架构 - Controller → Service → Repository - 使用 DTO 模式进行数据传输 - 统一使用 `ApiResponse` 包装响应 **安全配置:** - JWT Token 有效期: 86400 秒 (24小时) - CORS 允许的源: `http://localhost:3000`, `http://book.hrbustbbs.xyz` - 密码加密: BCrypt 算法 **异常处理:** - 全局异常处理器: `GlobalExceptionHandler` - 自定义异常: `BookNotAvailableException` ### 前端开发规范 **代码风格:** - 使用 Vue 3 Composition API 和 `