Library Management System

这是一个基于 Flask 的图书馆管理系统项目，包含管理员和普通用户两种角色。用户可以注册、登录、借阅图书；管理员可以管理图书、用户、黑名单以及退役图书。

项目功能

• 用户注册 / 登录 / 注销
• 普通用户借阅图书、查看借阅记录
• 管理员后台：图书管理、用户管理、借阅管理、黑名单管理、退役图书管理
• 基于 SQLite 的数据库存储
• 简洁的前端页面模板

技术栈

• Python 3
• Flask
• Flask-SQLAlchemy
• SQLite
• HTML / CSS / Jinja 模板

项目结构

• app.py：Flask 应用程序主入口
• templates/：前端页面模板
• static/：静态资源（CSS、图片）
• requirements.txt：项目依赖
• .gitignore：忽略不必要提交的文件

安装与运行

1. 创建虚拟环境：

   python -m venv venv

2. 激活虚拟环境：

   • Windows:

     .\venv\Scripts\Activate

   • macOS / Linux:

     source venv/bin/activate

3. 安装依赖：

   pip install -r requirements.txt

4. 运行应用：

   python app.py

5. 打开浏览器访问：

   http://127.0.0.1:5000
   

默认账号

项目第一次运行时会自动创建默认超级管理员账号：

• 用户名：superadmin
• 密码：admin123

请首次登录后及时修改密码。

GitHub 上应该包含的文件

• README.md：项目说明与运行指南
• requirements.txt：依赖说明
• .gitignore：避免提交虚拟环境、数据库文件、构建输出等
• app.py：应用程序主代码
• templates/ / static/：前端资源

推送到 GitHub

1. 在 GitHub 上创建仓库 LibraryManagementSystem
2. 使用本地仓库关联远程：

   git remote add origin https://github.com/<你的用户名>/LibraryManagementSystem.git

3. 推送到远程：

   git push -u origin master

进一步优化建议

• 使用 .env 存储 SECRET_KEY 和配置
• 使用密码哈希替代明文密码
• 添加单元测试
• 部署到云平台（Railway、Heroku、PythonAnywhere 等）