# local16401library

**Repository Path**: mimiaomimiao/local16401library

## Basic Information

- **Project Name**: local16401library
- **Description**: 本地图书馆管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-06-21
- **Last Updated**: 2025-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 本地图书馆管理系统

这是一个基于 Django 开发的现代化图书馆管理系统，提供图书管理、借阅服务等功能。

## 功能特点

### 1. 用户功能
- 用户注册和登录
- 浏览图书列表和详情
- 查看作者信息
- 个人借阅管理
  - 查看当前借阅
  - 续借功能
  - 归还图书
  - 借阅历史记录
- 逾期提醒

### 2. 图书管理
- 图书信息管理
  - 书名、作者、ISBN
  - 图书简介
  - 分类标签
  - 语言信息
- 馆藏管理
  - 多本复本管理
  - 图书状态跟踪（可借、已借、维护中等）
  - 借阅历史

### 3. 作者管理
- 作者信息维护
  - 基本信息
  - 生平简介
  - 作品列表
- 作者分类和检索

### 4. 管理员功能
- 用户管理
- 图书管理
- 借阅管理
- 系统设置

## 技术栈

- Python 3.12
- Django 5.1.9
- Bootstrap 5
- Font Awesome 6
- SQLite 数据库

## 安装部署

### 1. 环境要求
- Python 3.12 或更高版本
- pip 包管理器

### 2. 安装步骤

1. 克隆项目：
```bash
git clone [项目地址]
cd 项目文件夹
```

2. 创建虚拟环境：
```bash
python -m venv venv
```

3. 激活虚拟环境：
- Windows:
```bash
.\venv\Scripts\activate
```
- Linux/Mac:
```bash
source venv/bin/activate
```

4. 安装依赖：
```bash
pip install -r requirements.txt
pip install django-widget-tweaks
```

5. 初始化数据库：
```bash
python manage.py makemigrations
python manage.py migrate
```

6. 导入示例数据：
```bash
python manage.py populate_db
python manage.py setup_groups
python manage.py create_test_users
```

7. 创建管理员账户：
```bash
python manage.py createsuperuser
```
测试数据：
用户名:admin  
密码：123456

8. 运行开发服务器：
```bash
python manage.py runserver
```

### 3. 访问系统

- 网站首页：http://127.0.0.1:8000/
- 管理后台：http://127.0.0.1:8000/admin/

## 项目结构

```
locallibrary/
│
├── catalog/                 # 主应用目录
│   ├── migrations/         # 数据库迁移文件
│   ├── templates/         # 模板文件
│   ├── management/       # 管理命令
│   ├── models.py         # 数据模型
│   ├── views.py          # 视图函数
│   └── urls.py           # URL配置
│
├── locallibrary/          # 项目配置目录
│   ├── settings.py       # 项目设置
│   └── urls.py           # 主URL配置
│
├── venv/                  # 虚拟环境
├── manage.py             # Django管理脚本
├── requirements.txt      # 项目依赖
└── README.md            # 项目说明文档
```

## 数据模型

### Book（图书）
- title: 书名
- author: 作者（外键）
- summary: 简介
- isbn: ISBN号
- genre: 类型（多对多）
- language: 语言（外键）

### Author（作者）
- name: 姓名
- date_of_birth: 出生日期
- date_of_death: 逝世日期
- bio: 作者简介

### BookInstance（图书实例）
- book: 关联图书（外键）
- imprint: 版本信息
- borrower_date: 借阅日期
- due_back: 归还日期
- borrower: 借阅者（外键）
- status: 状态（可借、已借等）

### Genre（图书类型）
- name: 类型名称

### Language（语言）
- name: 语言名称

## 使用说明

### 普通用户
1. 注册/登录账户
2. 浏览图书列表
3. 查看图书详情
4. 借阅图书
5. 管理个人借阅

### 管理员
1. 登录管理后台
2. 管理图书信息
3. 处理借阅请求
4. 管理用户账户

## 界面预览

系统采用现代化的响应式设计：
- 清晰的导航结构
- 卡片式布局
- 友好的用户界面
- 适配移动设备

## 注意事项

1. 本项目仅用于演示和学习
2. 默认使用SQLite数据库，可根据需要更换为其他数据库
3. 部署到生产环境时需要修改相关安全设置

## 联系方式

如有问题或建议，请联系：
- Email: miao@library.com
- 电话: (plv) cbb-0715

## 许可证

本项目采用 MIT 许可证