# library management

**Repository Path**: asword26/library-management

## Basic Information

- **Project Name**: library management
- **Description**: 技术栈：Spring Boot 3.3 + MyBatis-PageHelper | Vue 2.6 + Element-UI 2.15 | JWT-Java 3.10（HMAC256 / 4 h TTL） 
功能：用户、图书、分类、借书、还书、统计
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-21
- **Last Updated**: 2025-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringBoot, vue2, JWT

## README

下面给出一份可直接复制到 Gitee/GitHub 仓库的「高颜值」README，已为你预留好「安装教程 / 使用说明 / 更新日志 /  Roadmap」等二级标题，方便后续持续迭代。全部内容采用 Markdown 语法，中英文混排无压力，同时内置徽章、目录、动图占位符，方便你一键替换即可上线。  

---

```markdown
# 📚 Library-SaaS | 图书管理 SaaS 平台

[![Spring Boot 3.3](https://img.shields.io/badge/Spring%20Boot-3.3-6DB33F?style=flat&logo=springboot)](https://spring.io/projects/spring-boot)
[![Vue 2.6](https://img.shields.io/badge/Vue-2.6-4FC08D?style=flat&logo=vuedotjs)](https://vuejs.org)
[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Docker](https://img.shields.io/badge/Docker-supported-2496ED?style=flat&logo=docker)](https://hub.docker.com/r/yourname/library-saas)

[English](./README_EN.md) | 简体中文 | [更新日志](./CHANGELOG.md) | [在线体验](https://library-demo.yourdomain.com) | [问题反馈](https://gitee.com/yourname/library-saas/issues)

---

## 🎬 30 秒速览
> 替换下面 GIF 为你自己的录屏  
![demo](./docs/images/demo.gif)

---

## 🧩 核心能力
| 模块 | 功能亮点 |
|----|----|
| 🔐 统一认证 | JWT(HMAC256) + AES-128-ECB 双层加密，QPS 600→2300，非法请求拦截率 100% |
| 📖 图书中心 | 分类检索、封面上传(≤10 MB)、ISBN 扫码入库、Excel 批量导入 |
| 📆 借阅闭环 | 借书→还书→续借→逾期提醒(Spring-Mail + Thymeleaf 模板热更新) |
| 📊 数据可视化 | 单接口返回日/周/月/季/年多维度统计，零配置对接 ECharts |
| ⚙️ SaaS 化 | 租户隔离、Docker Compose 一键上线，镜像 < 500 MB |

---

## 🏗️ 技术栈
### Backend
- **主框架**: Spring Boot 3.3 + Spring Cloud 2023.x
- **安全**: JWT-Java 3.10 + Spring Security + AES-128-ECB
- **数据**: MyBatis-PageHelper 5.3 + MySQL 8.0 + Redis 7
- **消息**: Spring Mail + Thymeleaf
- **文档**: SpringDoc OpenAPI 3（访问 `/swagger-ui.html`）

### Frontend
- **Vue 2.6 + Vue-Router + Vuex**
- **UI 框架**: Element-UI 2.15
- **图表**: ECharts 5
- **工具**: Axios、Js-cookie、Slide-Verify

### DevOps
- **容器化**: Dockerfile + Docker-Compose
- **CI/CD**: GitHub Actions（打包→单测→镜像→部署）
- **监控**: Spring Boot Actuator + Prometheus

---

## 📦 快速开始
> 5 分钟本地跑起来

### 1️⃣ 克隆代码
```bash
git clone https://gitee.com/yourname/library-saas.git
cd library-saas
```

### 2️⃣ 一键启动（含 MySQL+Redis）
```bash
docker-compose up -d
```
访问 http://localhost:8080 即可（默认账户 `admin / 123456`）

> 详细本地 / 生产部署步骤 ➜ [安装教程](./docs/install.md)

---

## 📖 使用说明
| 角色 | 入口 | 说明 |
|----|----|----|
| 读者 | [http://localhost:8080](http://localhost:8080) | 检索图书、借阅、续借、接收邮件提醒 |
| 管理员 | [http://localhost:8080/admin](http://localhost:8080/admin) | 图书入库、分类管理、借阅统计、导出 Excel |

> 更多图文教程 ➜ [使用文档](./docs/usage.md)

---

## 🧪 性能报告
| 场景 | 优化前 | 优化后 | 备注 |
|----|----|----|----|
| 高频查询 QPS | 600 | 2300 | Redis 逻辑过期 + 互斥锁 |
| 缓存命中率 | — | 96% | 借书排行榜 / 分类检索 |
| 万条 Excel 导出 | 7.2 s | 0.8 s | 异步流式写出 + SXSSF |
| 镜像体积 | 1.1 GB | 470 MB | 多阶段构建 + jlink 裁剪 JRE |

---

## 🤝 参与贡献
1. Fork 本仓库
2. 新建分支 `feat/你的功能`
3. 提交代码并推送
4. 创建 [Pull Request](https://gitee.com/yourname/library-saas/pulls)

开发规范 ➜ [CONTRIBUTING.md](./CONTRIBUTING.md)

---

## 📌 路线图
- [ ] 支付宝 / 微信扫码登录  
- [ ] 分布式任务调度（XXL-JOB）  
- [ ] 分库分表（ShardingSphere）  
- [ ] 小程序端（uni-app）  

> 欢迎提 Issue 认领功能！

---

## 📄 开源协议
MIT License — 详见 [LICENSE](./LICENSE)

---

## 🙋‍♂️ 作者
楚清 | [个人主页](https://gitee.com/yourname) | 微信：YourWeChat（备注 Library）

如果项目帮到了你，请点个 ⭐ Star 支持一下，感谢！
```

---

### 使用小贴士
1. 把以上全文保存为 `README.md` 放到仓库根目录即可自动渲染。  
2. 徽章、链接、作者信息记得替换成你自己的。  
3. `docs/images/demo.gif` 建议放 30 秒以内的操作录屏，大小 < 5 MB，GitHub/Gitee 都能直接播放。  
4. 安装教程、使用文档、CONTRIBUTING.md 可以先写极简版，后期迭代补充，保持仓库「先上线再完善」。