Hệ thống quản lý thư viện được xây dựng bằng Java với JavaFX, sử dụng MongoDB để lưu trữ dữ liệu và Firebase Authentication để quản lý người dùng.
- Yêu cầu hệ thống
- Cài đặt
- Cấu hình
- Chạy ứng dụng
- Kiến trúc hệ thống
- Tính năng
- Cấu trúc dự án
- Công nghệ sử dụng
- Java Development Kit (JDK) 17 hoặc cao hơn
- Apache Maven 3.6 trở lên
- MongoDB 5.0 trở lên (đã cài đặt và đang chạy)
- Firebase project (để sử dụng Firebase Authentication)
- Kết nối Internet (để kết nối Firebase và tải dữ liệu sách)
Windows:
macOS:
brew install openjdk@17Linux:
sudo apt-get update
sudo apt-get install openjdk-17-jdkKiểm tra cài đặt:
java -versionWindows:
- Tải Maven từ Apache Maven
- Giải nén và thêm thư mục bin vào PATH
macOS:
brew install mavenLinux:
sudo apt-get install mavenKiểm tra cài đặt:
mvn -versionWindows:
- Tải MongoDB Community Server từ MongoDB Download Center
- Cài đặt và chọn "Install MongoDB as a Service"
- MongoDB sẽ tự động chạy trên port 27017
macOS:
brew tap mongodb/brew
brew install mongodb-community
brew services start mongodb-communityLinux:
sudo apt-get install -y mongodb-org
sudo systemctl start mongod
sudo systemctl enable mongodKiểm tra MongoDB đang chạy:
mongosh --eval "db.version()"git clone <repository-url>
cd library-manager- Truy cập Firebase Console
- Nhấn "Add project" và làm theo hướng dẫn
- Sau khi tạo project, vào phần "Project Settings"
- Trong Firebase Console, chọn "Add app" và chọn biểu tượng Web
- Đặt tên cho app và đăng ký
- Sao chép các thông tin cấu hình (API Key, Auth Domain, Project ID, v.v.)
- Trong Firebase Console, vào "Authentication"
- Chọn tab "Sign-in method"
- Kích hoạt "Email/Password" provider
- Vào "Project Settings" > "Service accounts"
- Nhấn "Generate new private key"
- Tải file JSON về
- Đổi tên file thành
serviceAccountKey.json - Đặt file vào thư mục
src/main/resources/
Lưu ý quan trọng: File serviceAccountKey.json chứa thông tin nhạy cảm. Không commit file này lên Git. File này đã được thêm vào .gitignore.
Tạo file .env ở thư mục gốc của dự án với nội dung sau:
# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017
# Firebase Configuration
FIREBASE_API_KEY=your-firebase-api-key
FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com
FIREBASE_DATABASE_URL=https://your-project-default-rtdb.firebaseio.com
FIREBASE_PROJECT_ID=your-project-id
FIREBASE_STORAGE_BUCKET=your-project.appspot.com
FIREBASE_MESSAGING_SENDER_ID=your-messaging-sender-id
FIREBASE_APP_ID=your-app-id
FIREBASE_SERVICE_ACCOUNT_PATH=src/main/resources/serviceAccountKey.jsonHướng dẫn lấy thông tin Firebase:
FIREBASE_API_KEY: Lấy từ Firebase Console > Project Settings > General > Web API KeyFIREBASE_AUTH_DOMAIN: Thường có dạngyour-project.firebaseapp.comFIREBASE_DATABASE_URL: Lấy từ Firebase Console > Realtime Database (nếu sử dụng)FIREBASE_PROJECT_ID: ID của project, hiển thị trong Project SettingsFIREBASE_STORAGE_BUCKET: Lấy từ Firebase Console > StorageFIREBASE_MESSAGING_SENDER_ID: Lấy từ Project Settings > Cloud MessagingFIREBASE_APP_ID: Lấy từ Project Settings > General > App ID
Lưu ý: File .env cũng đã được thêm vào .gitignore để bảo mật thông tin.
Mặc định, ứng dụng kết nối đến MongoDB tại mongodb://localhost:27017. Nếu MongoDB của bạn chạy ở địa chỉ khác, cập nhật giá trị MONGODB_URI trong file .env.
Database sẽ được tạo tự động với tên libraryManager khi ứng dụng chạy lần đầu.
# Build project
mvn clean install
# Chạy ứng dụng
mvn javafx:runMaven Wrapper cho phép chạy ứng dụng mà không cần cài đặt Maven toàn cục.
Windows:
mvnw.cmd clean install
mvnw.cmd javafx:runmacOS/Linux:
./mvnw clean install
./mvnw javafx:runIntelliJ IDEA:
- Mở dự án trong IntelliJ IDEA
- Đợi Maven import dependencies
- Tìm class
MainApplication.java - Nhấn chuột phải và chọn "Run 'MainApplication.main()'"
Eclipse:
- Import dự án như một Maven project
- Đợi Maven build workspace
- Nhấn chuột phải vào project > Run As > Java Application
- Chọn
MainApplicationlàm main class
Ứng dụng được xây dựng theo mô hình MVC:
-
Model: Các class trong package
com.app.librarymanager.models- Định nghĩa cấu trúc dữ liệu
- Xử lý logic nghiệp vụ cơ bản
-
View: Các file FXML trong
src/main/resources/views- Định nghĩa giao diện người dùng
- Sử dụng JavaFX FXML
-
Controller: Các class trong package
com.app.librarymanager.controllers- Xử lý logic nghiệp vụ
- Kết nối Model và View
- Xử lý sự kiện người dùng
MongoDB Collections:
-
users (quản lý bởi Firebase Authentication)
- Lưu thông tin người dùng
- Xác thực và phân quyền
-
books
- Thông tin sách (tiêu đề, tác giả, mô tả, v.v.)
- Danh mục, đánh giá, hình ảnh
-
bookCopies
- Số lượng bản sao của mỗi cuốn sách
- Quản lý tồn kho
-
bookLoan
- Thông tin mượn sách
- Trạng thái: PENDING, AVAILABLE, RETURNED, REJECTED, EXPIRED
- Loại: ONLINE (đọc online), OFFLINE (mượn vật lý)
-
bookRating
- Đánh giá sách của người dùng
- Điểm số và nhận xét
-
categories
- Danh mục sách
- Phân loại theo thể loại
-
libraryCard
- Thẻ thư viện của người dùng
- Thời hạn, trạng thái, phí đăng ký
-
transactions
- Giao dịch tài chính
- Loại: SELL_BOOKS, REGISTER_CARD, ADD_BOOK, RETURN_BOOK
- Theo dõi thu chi
-
penalty
- Phạt người dùng
- Lý do: trả sách muộn, hỏng, mất
- Trạng thái thanh toán
-
returnRecord
- Lịch sử trả sách
- Tình trạng sách khi trả
- Số tiền phạt (nếu có)
-
comments
- Bình luận về sách
- Tương tác người dùng
-
rolePermissions
- Phân quyền hệ thống
- Quản lý vai trò (admin, user)
Quản lý tài khoản:
- Đăng ký tài khoản mới
- Đăng nhập/Đăng xuất
- Quên mật khẩu
- Cập nhật thông tin cá nhân
- Xem lịch sử hoạt động
Quản lý thẻ thư viện:
- Đăng ký thẻ thư viện
- Gia hạn thẻ
- Xem thông tin thẻ (thời hạn, trạng thái)
Tìm kiếm và duyệt sách:
- Tìm kiếm sách theo tên, tác giả, thể loại
- Duyệt sách theo danh mục
- Xem chi tiết sách (mô tả, đánh giá, bình luận)
- Xem sách phổ biến, sách mới
Mượn sách:
- Yêu cầu mượn sách (online hoặc offline)
- Xem danh sách sách đang mượn
- Yêu cầu trả sách
- Xem lịch sử mượn sách
- Giới hạn mượn: tối đa 5 cuốn cùng lúc
- Thời hạn mượn: 30 ngày
Tương tác với sách:
- Đánh giá sách (rating)
- Viết bình luận
- Thêm sách vào danh sách yêu thích
- Xem danh sách sách yêu thích
Quản lý sách:
- Thêm sách mới
- Chỉnh sửa thông tin sách
- Xóa sách
- Quản lý số lượng bản sao
- Upload hình ảnh sách
Quản lý danh mục:
- Thêm/Sửa/Xóa danh mục
- Gán sách vào danh mục
Quản lý người dùng:
- Xem danh sách người dùng
- Chỉnh sửa thông tin người dùng
- Vô hiệu hóa/Kích hoạt tài khoản
- Phân quyền (admin/user)
Quản lý thẻ thư viện:
- Xem danh sách đăng ký thẻ
- Duyệt/Từ chối đăng ký thẻ
- Gia hạn thẻ cho người dùng
Quản lý mượn/trả sách:
- Xem danh sách yêu cầu mượn sách
- Duyệt/Từ chối yêu cầu mượn
- Ghi nhận tình trạng sách khi cho mượn
- Xử lý trả sách
- Ghi nhận tình trạng sách khi trả
- Tính phạt (nếu trả muộn/hỏng/mất)
- Xem lịch sử mượn/trả
Quản lý giao dịch:
- Xem danh sách giao dịch
- Thêm/Sửa/Xóa giao dịch
- Tìm kiếm giao dịch
- Thống kê thu chi
- Loại giao dịch:
- SELL_BOOKS: Bán sách
- REGISTER_CARD: Đăng ký thẻ
- ADD_BOOK: Mua sách nhập kho
- RETURN_BOOK: Phạt trả sách
Quản lý phạt:
- Xem danh sách phạt
- Tạo phạt thủ công
- Đánh dấu đã thanh toán
- Phạt tự động khi:
- Trả sách muộn
- Sách bị hỏng
- Sách bị mất
Thống kê và báo cáo:
- Thống kê số lượng sách
- Thống kê số lượng người dùng
- Thống kê mượn/trả sách
- Sách được mượn nhiều nhất
- Thống kê doanh thu
library-manager/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/
│ │ │ └── app/
│ │ │ └── librarymanager/
│ │ │ ├── controllers/ # Controllers xử lý logic
│ │ │ │ ├── AdminDashboardController.java
│ │ │ │ ├── AuthController.java
│ │ │ │ ├── BookController.java
│ │ │ │ ├── BookLoanController.java
│ │ │ │ ├── LibraryCardController.java
│ │ │ │ ├── TransactionController.java
│ │ │ │ ├── UserController.java
│ │ │ │ └── ...
│ │ │ ├── models/ # Data models
│ │ │ │ ├── Book.java
│ │ │ │ ├── BookLoan.java
│ │ │ │ ├── LibraryCard.java
│ │ │ │ ├── Transaction.java
│ │ │ │ ├── Penalty.java
│ │ │ │ ├── ReturnRecord.java
│ │ │ │ ├── User.java
│ │ │ │ └── ...
│ │ │ ├── services/ # Services (Firebase, MongoDB)
│ │ │ │ ├── Firebase.java
│ │ │ │ ├── FirebaseAuthentication.java
│ │ │ │ └── MongoDB.java
│ │ │ ├── utils/ # Utility classes
│ │ │ │ └── DateUtil.java
│ │ │ ├── interfaces/ # Interfaces
│ │ │ │ └── AuthStateListener.java
│ │ │ └── MainApplication.java # Entry point
│ │ └── resources/
│ │ ├── views/ # FXML files
│ │ │ ├── admin/ # Admin views
│ │ │ │ ├── admin-dashboard.fxml
│ │ │ │ ├── manage-books.fxml
│ │ │ │ ├── manage-users.fxml
│ │ │ │ ├── manage-cards.fxml
│ │ │ │ ├── manage-transactions.fxml
│ │ │ │ └── ...
│ │ │ ├── user/ # User views
│ │ │ │ ├── home.fxml
│ │ │ │ ├── book-detail.fxml
│ │ │ │ ├── my-loans.fxml
│ │ │ │ ├── my-card.fxml
│ │ │ │ └── ...
│ │ │ ├── auth/ # Authentication views
│ │ │ │ ├── login.fxml
│ │ │ │ ├── register.fxml
│ │ │ │ └── forgot-password.fxml
│ │ │ └── layout.fxml # Main layout
│ │ ├── styles/ # CSS files
│ │ │ └── styles.css
│ │ ├── images/ # Images
│ │ └── serviceAccountKey.json # Firebase service account (không commit)
│ └── test/ # Test files
├── .env # Environment variables (không commit)
├── .gitignore
├── pom.xml # Maven configuration
├── mvnw # Maven wrapper (Unix)
├── mvnw.cmd # Maven wrapper (Windows)
└── README.md
- Java 17: Ngôn ngữ lập trình chính
- JavaFX 17.0.12: Framework UI
- MongoDB 5.2.0: Cơ sở dữ liệu NoSQL
- Firebase Admin SDK 9.3.0: Xác thực người dùng
- Google Cloud Firestore 3.27.0: Cloud database (optional)
- Lombok 1.18.34: Giảm boilerplate code
- Ikonli 12.3.1: Icon library
- BootstrapFX 0.4.0: Bootstrap styling cho JavaFX
- java-dotenv 5.2.2: Quản lý environment variables
- Apache Commons Lang3 3.17.0: Utility functions
- JUnit 5.10.2: Unit testing
- Apache Maven 3.6+: Build automation
- Maven Compiler Plugin 3.13.0: Java compilation
- JavaFX Maven Plugin 0.0.8: JavaFX support
- User tìm kiếm và chọn sách muốn mượn
- User gửi yêu cầu mượn sách (chọn ONLINE hoặc OFFLINE)
- Yêu cầu được lưu với trạng thái PENDING
- Admin xem danh sách yêu cầu mượn
- Admin kiểm tra:
- Số lượng sách còn lại (nếu OFFLINE)
- Số lượng sách user đang mượn (tối đa 5)
- Trạng thái thẻ thư viện của user
- Admin duyệt hoặc từ chối:
- Nếu duyệt:
- Trạng thái chuyển thành AVAILABLE
- Ghi nhận tình trạng sách ban đầu
- Giảm số lượng bản sao (nếu OFFLINE)
- Thiết lập ngày mượn và hạn trả (30 ngày)
- Nếu từ chối:
- Trạng thái chuyển thành REJECTED
- Ghi nhận lý do từ chối
- Nếu duyệt:
- User yêu cầu trả sách (đánh dấu returnRequested = true)
- Admin xem danh sách yêu cầu trả sách
- Admin kiểm tra tình trạng sách khi trả
- Admin xử lý trả sách:
- Ghi nhận tình trạng sách khi trả
- So sánh với tình trạng ban đầu
- Tính toán phạt (nếu có):
- Trả muộn: phạt theo số ngày
- Sách hỏng: phạt theo mức độ hư hỏng
- Sách mất: phạt toàn bộ giá trị sách
- Tạo ReturnRecord
- Nếu có phạt:
- Tạo Penalty record
- Tạo Transaction với type RETURN_BOOK
- Tăng số lượng bản sao (nếu OFFLINE)
- Trạng thái chuyển thành RETURNED
- User gửi yêu cầu đăng ký thẻ
- User chọn thời hạn (số tháng)
- Yêu cầu được lưu với trạng thái PENDING
- Admin xem danh sách yêu cầu đăng ký
- Admin duyệt hoặc từ chối:
- Nếu duyệt:
- Tạo thẻ thư viện với thời hạn tương ứng
- Tính phí = phí tháng × số tháng
- Tạo Transaction với type REGISTER_CARD
- Trạng thái thẻ: ACTIVE
- Nếu từ chối:
- Ghi nhận lý do từ chối
- Nếu duyệt: