# ClassLibrary

**Repository Path**: dinghaitong/class-library

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-19
- **Last Updated**: 2026-02-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


## 配置运行

### 1. 克隆项目

```bash
git clone https://gitee.com/dinghaitong/class-library.git
git clone https://github.com/Bu661e/ClassLibrary.git
cd ClassLibrary
```

### 2. 创建虚拟环境（可选）

```bash
# 或使用 venv
python -m venv .venv
.venv\Scripts\activate     # Windows
source .venv/bin/activate  # Linux/Mac
```

### 3. 安装依赖

```bash
pip install flask flask-login flask-sqlalchemy sqlalchemy
```

### 4. 运行项目

```bash
python3 app.py
```

访问 http://localhost:5000

### 5. 登录账号

仓库已包含测试数据，默认账号：

| 角色   | 学号    | 密码   |
| ------ | ------- | ------ |
| 管理员 | admin   | admin  |
| 学生   | 2024001 | 123456 |

---

## 简介
班级图书共享管理系统是一个面向班级内部的轻量级图书借阅平台。管理员可管理图书和用户信息，普通用户可以浏览、搜索、借阅和归还图书。系统采用 Web 形式，本地部署，零配置开箱即用，适合班级图书角、宿舍共享等场景。

## 技术栈
后端：Python(uv venv) + Flask + SQLite
前端：Vue 3（CDN 引入）+ Element Plus（CDN 引入）

## 需求

### 管理员端

目标：管理图书，监督流转，保障班级图书角正常运转。

| 功能     | 描述                                                                                                |
| -------- | --------------------------------------------------------------------------------------------------- |
| 图书入库 | 录入书名、作者、出版社、ISBN、标签、来源（班级购买/个人捐赠）；支持 ISBN 自动查询补全；支持批量入库 |
| 借还审核 | 审批借阅申请和归还申请，确认实物归位后完成操作                                                      |
| 状态维护 | 将破损/丢失图书标记为"不可借阅"或"报废"                                                             |
| 逾期管理 | 查看超期名单，一键发送提醒通知                                                                      |
| 数据看板 | 班级阅读排行榜、热门图书榜                                                                          |
| 规则设置 | 配置最大借阅天数、单人最大持书量                                                                    |

### 学生端

目标：快速找书，便捷流转，分享交流。

| 功能           | 描述                                                         |
| -------------- | ------------------------------------------------------------ |
| 图书检索       | 按书名、作者、标签搜索，查看图书状态（在库/借出）            |
| 申请借阅       | 发起借阅请求；如图书为他人捐赠，需捐赠者确认后再由管理员审核 |
| 申请归还       | 点击归还，通知管理员确认实物                                 |
| 图书捐赠       | 录入个人愿意共享的书籍，经管理员审核后入库                   |
| 评价推荐(TODO) | 阅读后打分、写简短书评（"安利"或"防雷"）                     |
| 心愿单         | 发布想看的书，供采购/捐赠参考                                |
| 个人中心       | 查看借阅历史、当前待还、剩余天数                             |