Hệ thống quản lý thư viện và mượn trả sách thông minh Python + báo cáo word

Xem Live Demo

(#796) Hệ thống quản lý thư viện và mượn trả sách thông minh Python + báo cáo word

17/09/2026

(0 đánh giá)

300.000 đ

0 3

Thể loại: Website

Danh mục: Python

Báo vi phạm bản quyền Báo code bị lỗi

Code Chất Lượng

Source code 200

Bài viết 0

Download

Mô tả

Web application chạy tại máy. Python FastAPI + SQLite + HTML/CSS/JavaScript thuần. Hoàn thành các chức năng chính: quản lý sách, quản lý độc giả, mượn và trả sách. Có đăng nhập, tìm kiếm, lọc quá hạn và thống kê.

Công nghệ sử dụng

Thành phần	Công nghệ
Ngôn ngữ	Python 3.11+ (kiểm thử với 3.12)
Backend	FastAPI 0.141 trên Starlette 1.6, chạy bằng Uvicorn 0.53
Kiểm tra dữ liệu	Pydantic v2 (`app/models.py`)
Cơ sở dữ liệu	SQLite qua module chuẩn`sqlite3`,`PRAGMA foreign_keys=ON`, giao dịch tường minh (`app/db.py`,`schema.sql`)
Xác thực	Thư viện chuẩn:`hashlib.pbkdf2_hmac`(SHA-256, 260 000 vòng) băm mật khẩu; phiên là token ký HMAC-SHA256 trong cookie`HttpOnly`+`SameSite=Strict`(không lưu server, chạy được nhiều instance); khóa tạm sau 5 lần sai mật khẩu
Frontend	HTML / CSS / JavaScript thuần (ES modules,`@ts-check`+ JSDoc), một trang, gọi API bằng`fetch`; không framework, không CDN, không bước build
Công cụ frontend (chỉ dev)	Prettier, ESLint, TypeScript (kiểm tra kiểu file .js) qua`npm run check`; Playwright cho test giao diện
Kiểm thử	pytest 9 +`fastapi.testclient`(httpx); test API, unit, boundary, concurrency, migration; pytest-playwright cho 8 luồng giao diện trên Chromium; xuất JUnit XML
Tài liệu	PlantUML (11 sơ đồ), báo cáo Markdown/DOCX/PDF
Khởi động	`start.bat`(Windows),`start.sh`(macOS/Linux),`venv`+`pip`

Các gói khác trongrequirements.txt(anyio, h11, httpcore, click, certifi, ...) là phụ thuộc gián tiếp của FastAPI/Uvicorn/httpx/pytest.

Chạy nhanh trên Windows

Cài Python 3.11 trở lên từhttps://www.python.org/downloads/windows/(đã kiểm thử với Python 3.12). Bật Python Launcherpykhi cài.
Giải nén toàn bộ bộ nộp. Mở thư mụcThuVienMini, nhấp đúpstart.bat.
Lần đầu cần Internet để tải các thư viện miễn phí. Khi thấyUvicorn running, mởhttp://127.0.0.1:8000.
Giữ cửa sổ chạy máy chủ mở trong lúc demo. Nhấn Ctrl+C để dừng.

Tài khoản mẫu

Vai trò	Tên đăng nhập	Mật khẩu demo
Quản trị viên	admin	Admin@123
Thủ thư	thuthu	ThuThu@123
Thủ thư	thuthu2	ThuThu@123
Thủ thư (đã ngừng, không đăng nhập được)	cu_nhan_vien	ThuThu@123

Quản trị có toàn bộ quyền. Thủ thư được thêm, sửa, tìm sách/độc giả, mượn/trả/gia hạn, xuất CSV và xem thống kê; chỉ quản trị được xóa mềm (nútNgừng), quản lý tài khoản (trangTài khoản) và sao lưu. Mọi người dùng tự đổi mật khẩu bằng nútMật khẩuở góc trái dưới. Tài khoản này dùng cho bài tập trên localhost, không phải tài khoản thật; hãy đổi mật khẩu ngay nếu dùng thật.

Hướng dẫn cài đặt

Chạy bằng PowerShell

py -3-m venv .venv.\.venv\Scripts\python.exe-m pip install -r requirements.txt.\.venv\Scripts\python.exe seed.py.\.venv\Scripts\python.exe-m uvicorn app.main:app --host 127.0.0.1--port 8000

Không cầnActivate.ps1nên không phải đổi ExecutionPolicy. Nếu không có lệnhpy, thay bằngpython. Nếu cổng 8000 bận, dùng--port 8001và mở đúng cổng. Nếu Python quá cũ gây lỗi cài dependency, tạo lại môi trường ảo bằng Python 3.12.

Chạy lại khi đã cài xong, không cần mạng

.\.venv\Scripts\python.exe-m uvicorn app.main:app --host 127.0.0.1--port 8000

Giao diện chính không tải CDN/font hay gọi dịch vụ ngoài./docslà trang API mặc định của FastAPI và có thể cần mạng để tải Swagger UI;/openapi.jsonvà ứng dụng chính vẫn chạy offline.

Chạy trên macOS / Linux

Cài Python 3.11 trở lên (macOS:brew install pythonhoặc tải từ python.org).
Mở Terminal trong thư mụcThuVienMinivà chạy:

./start.sh

Script tạo.venv, cài thư viện (lần đầu cần Internet), chạyseed.pyrồi khởi động máy chủ. Khi thấyUvicorn running, mởhttp://127.0.0.1:8000. Nhấn Ctrl+C để dừng. Nếu cổng 8000 bận:PORT=8001 ./start.sh. Nếu báo "Permission denied", chạychmod +x start.shmột lần.

Chạy lại khi đã cài xong, không cần mạng:

.venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8000

Phát triển bằng VS Code

Thư mục.vscode/đã có sẵn cấu hình; mở thư mụcThuVienMinibằngFile → Open Folderlà dùng được.

Cài extension được gợi ý khi VS Code hỏi (Python, Debugpy, Pylance, SQLite Viewer, PlantUML, REST Client).
F5→ "Chạy server (tự tải lại khi sửa code)". Lần đầu task tiền khởi động tự tạo.venv, cài thư viện và sinh dữ liệu demo — đúng những gìstart.bat/start.shlàm. uvicorn chạy với--reload, lưu file Python là server tự khởi động lại; đặt breakpoint trongapp/*.pyđể dừng và xem biến. Sửa HTML/CSS/JS chỉ cần tải lại trình duyệt.
Muốn dữ liệu demo mới (ngày mượn tính lại theo hôm nay): dừng server, chạypython seed.py --force.
Testing(biểu tượng ống nghiệm ở thanh bên): chạy/debug từng test bằng nút ▶ cạnh tên hàm. Task "Chạy test + xuất JUnit" (Cmd/Ctrl+Shift+B→ chọn test) tái tạodocs/test-results.xml.
requests.http: gọi thử từng API ngay trong editor bằng REST Client, cookie phiên được giữ sau khi đăng nhập.
Mởdata/library.dbbằng SQLite Viewer để xem bảng; mởdocs/uml/*.pumlvà bấmAlt+Dđể xem sơ đồ PlantUML.

Phát triển frontend

Frontend là JavaScript thuần chia thành ES modules trongapp/static/js/, trình duyệt nạp trực tiếp — không có bước build, bản nộp không cần Node. Node chỉ dùng cho công cụ kiểm tra mã ở máy dev:

npm install          # một lầnnpm run format       # Prettier định dạng js/css/htmlnpm run lint         # ESLintnpm run typecheck    # TypeScript kiểm tra kiểu trên file .js nhờ // @ts-check + JSDoc (types.js)npm run check        # cả ba, dùng trước khi commit

Xem demo source code

Hình ảnh demo