# library

**Repository Path**: null7916/library

## Basic Information

- **Project Name**: library
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-09
- **Last Updated**: 2025-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能图书管理系统

📚 基于Spring Boot和Vue的智能图书管理系统，集成AI助手与MCP工具调用功能。

## 🚀 技术架构
- **后端**: Spring Boot + MyBatis Plus + JWT + DeepSeek AI
- **前端**: Vue 3 + Vite + Element Plus
- **数据库**: MySQL

## 🛠️ 核心功能
- 图书管理：增删改查、库存管理
- 借阅管理：借书、还书、续借
- 用户管理：注册、登录、信息维护
- 统计仪表盘：实时显示图书馆数据
- AI智能助手：通过DeepSeek API提供智能交互
- MCP工具集成：支持图书搜索、借阅等操作的工具调用

## 📂 项目结构
```
├── library-ui        # 前端项目 (Vue 3 + Vite)
└── src               # 后端项目 (Spring Boot)
    ├── main
    │   ├── java      # Java源代码
    │   └── resources # 配置文件与资源
    └── test          # 测试代码
```

## ⚙️ 配置说明

### 后端配置 (application.properties)
```properties
# DeepSeek AI配置
deepseek.api.key=your-api-key
deepseek.api.base-url=https://api.deepseek.com
deepseek.api.model=deepseek-chat

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/library_db
spring.datasource.username=root
spring.datasource.password=root

# CORS配置
cors.allowed-origins=*
```

### 前端配置 (.env.development)
```env
VITE_API_BASE_URL=/api
VITE_AI_ENABLED=true
```

## 📦 安装与启动

### 启动后端
```bash
# 进入项目目录
cd /path/to/project

# 使用Maven启动
./mvnw spring-boot:run
```

### 启动前端
```bash
# 进入前端目录
cd library-ui

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

## 🌐 API文档
- **用户相关**: 获取信息、更新信息、修改密码、搜索用户
- **图书相关**: 增删改查、批量删除
- **借阅记录**: 借书、续借、还书、查询记录
- **仪表盘**: 获取统计数据

## 🤖 AI助手使用
访问 `/ai/chat` 接口与AI交互，支持以下指令：
- "帮我找《Java编程思想》"
- "借阅编号为123的图书"
- "查看我的借阅记录"
- "推荐编程类图书"

## 📊 统计功能
通过 `/dashboard/stats` 接口获取：
- 图书总数
- 用户总数
- 当前借出图书数
- 今日访问量

## 🔐 安全机制
- JWT令牌认证
- 角色权限控制 (管理员/读者)
- 请求签名验证
- 敏感数据加密存储

## 📝 数据库设计
- **用户表**: 存储用户信息与权限
- **图书表**: 管理图书信息与库存
- **借阅记录表**: 跟踪图书借还状态

## 📈 性能优化
- 使用MyBatis Plus分页插件
- Redis缓存热门图书信息
- 异步处理借阅操作
- 数据库索引优化

## 📎 PWA特性
- 离线访问支持
- 渐进式加载
- 自动缓存策略

## 📚 开发规范
- RESTful API设计
- DTO模式数据传输
- 分层架构设计 (Controller-Service-Mapper)
- 统一响应格式 (PlainResult)

## 🧪 测试覆盖
- 单元测试 (JUnit)
- 接口测试 (Postman)
- E2E测试 (Cypress)

## 📜 许可证
本项目采用 MIT License，详情请参阅 LICENSE 文件。