Hệ thống Đăng Ký Tín Chỉ là một ứng dụng desktop Java toàn diện được xây dựng nhằm quản lý quy trình đăng ký tín chỉ của sinh viên. Dự án này áp dụng các nguyên tắc lập trình hướng đối tượng (OOP), mô hình kiến trúc Model-View-Controller (MVC) hiện đại, và các design patterns chuẩn trong Java.

Giao diện: JavaFX 25 - Ứng dụng desktop modern với UI responsive
Cơ sở dữ liệu: MySQL 8.0 với JDBC connectivity
Kiến trúc: Service Layer + Repository Pattern (3-tier architecture)
Tính năng chính: Quản lý đăng ký tín chỉ, kiểm tra ràng buộc lịch học, ngăn chặn trùng môn

1. Tính Năng Chính
2. Yêu Cầu Hệ Thống
3. Công Nghệ Sử Dụng
4. Cấu Trúc Dự Án
5. Cài Đặt & Setup
6. Cấu Hình Database
7. Chạy Ứng Dụng
8. Hướng Dẫn Sử Dụng
9. API & Tính Năng
10. Troubleshooting
11. Nguyên Tắc Thiết Kế
12. Đóng Góp & Phân Công
13. Tài Liệu & Resources
14. Giấy Phép

• ✅ Xem danh sách lớp học phần khả dụng trong kỳ hiện tại
• ✅ Đăng ký môn học với giao diện thân thiện
• ✅ Xem thông tin chi tiết: giảng viên, số tín chỉ, lịch học, sĩ số
• ✅ Kiểm tra real-time các ràng buộc:
  • Không trùng môn học (mỗi sinh viên chỉ đăng ký một lớp cho cùng một môn)
  • Không trùng lịch học (không chọn 2 lớp có cùng thứ/tiết/khoảng thời gian)
  • Không đăng ký lớp đã đầy (kiểm tra max_capacity)

• 👤 Thông tin sinh viên: Họ tên, MSSV, lớp, ngành, khoa
• 📅 Lịch học từng tuần
• 📊 Số tín chỉ đã đăng ký

• ❌ Hủy đăng ký môn học
• 📋 Xem danh sách lớp đã đăng ký
• 🔍 Tìm kiếm và lọc

• ➕ Tạo lớp học phần mới
• 📝 Chỉnh sửa thông tin lớp
• 🗑️ Xóa lớp học phần
• 📊 Xem danh sách tất cả lớp

• 📅 Thêm lịch học cố định
• 🚨 Hệ thống tự động phát hiện trùng lịch phòng học
• ⚠️ Thông báo lỗi nếu trùng

• 👥 Xem danh sách tất cả đăng ký
• 📝 Chỉnh sửa thông tin đăng ký
• 🗑️ Xóa đăng ký
• 📊 Theo dõi sĩ số

• 🔑 Đăng nhập bằng username/password
• 👤 Phân quyền: Student, Admin, Faculty
• 🔒 Mã hóa password
• 🚪 Đăng xuất an toàn

• 💾 RAM: Tối thiểu 2GB (khuyến nghị 4GB+)
• 💿 Ổ cứng: 500MB trống
• 🖥️ CPU: Dual-core, 1.5GHz trở lên

• Java JDK 21: https://www.oracle.com/java/technologies/downloads/
• JavaFX SDK 25: https://gluonhq.com/products/javafx/
• MySQL Server 8.0+: https://dev.mysql.com/downloads/mysql/
• MySQL Connector/J 8.0.33+: https://dev.mysql.com/downloads/connector/j/
• IDE: IntelliJ IDEA / Eclipse / VS Code
• Optional: Scene Builder, MySQL Workbench

java -version
javac -version

java-oop-ptit/
├── 📄 README.md                          # Hướng dẫn này
├── 📄 LICENSE                            # Giấy phép MIT
├── .env                                  # Cấu hình database
│
├── 📁 docs/                              # Tài liệu
│   ├── PROJECT_STRUCTURE.md              # Chi tiết kiến trúc
│   ├── mysql_schema.sql                  # Database schema
│   ├── insert_data.sql                   # Dữ liệu mẫu
│   └── dbml.md                           # Database diagram
│
├── 📁 lib/                               # Thư viện
│   └── mysql-connector-j-8.0.33.jar      # JDBC Driver
│
├── 📁 src/main/
│   ├── 📁 java/
│   │   ├── config/
│   │   │   └── DatabaseConnection.java
│   │   ├── model/                        # Entity classes
│   │   ├── repository/                   # Data Access
│   │   ├── service/                      # Business Logic Interfaces
│   │   ├── service/impl/                 # Implementations
│   │   ├── controller/                   # UI Controllers
│   │   ├── view/                         # View Managers
│   │   ├── utils/                        # Utilities
│   │   ├── test/                         # Test cases
│   │   └── Main.java                     # Entry Point
│   └── 📁 resources/
│       ├── fxml/                         # FXML layouts
│       ├── css/                          # Stylesheets
│       └── assets/                       # Images, fonts
│
└── 📁 target/                            # Build output

┌─────────────────────────────────────────────────────┐
│  Presentation Layer (Controllers + FXML + CSS)    │
└────────────────────┬────────────────────────────────┘
                     ↓
┌─────────────────────────────────────────────────────┐
│  Business Logic Layer (Services)                   │
│  • Validation                                       │
│  • Schedule Conflict Detection                      │
│  • Duplicate Registration Prevention                │
└────────────────────┬────────────────────────────────┘
                     ↓
┌─────────────────────────────────────────────────────┐
│  Data Access Layer (Repositories)                  │
│  • JDBC Queries                                     │
│  • CRUD Operations                                  │
└────────────────────┬────────────────────────────────┘
                     ↓
         ┌───────────────────────┐
         │   Model/Entity        │
         │   (POJO Classes)      │
         └───────────┬───────────┘
                     ↓
         ┌───────────────────────┐
         │  MySQL Database       │
         └───────────────────────┘

git clone https://github.com/HungNguyenBa1811/java-oop-ptit.git
cd java-oop-ptit

Windows:

1. Download từ: https://www.oracle.com/java/technologies/downloads/
2. Chạy installer
3. Kiểm tra: java -version

Linux (Ubuntu):

sudo apt update
sudo apt install openjdk-21-jdk
java -version

macOS:

brew install openjdk@21
java -version

Option A (IntelliJ IDEA - Recommended):

1. File → Project Structure → Libraries
2. Chọn "+" → Add Java → Chọn JavaFX folder
3. Apply

Option B (Manual):

1. Download từ: https://gluonhq.com/products/javafx/
2. Giải nén vào: lib/javafx-sdk-25/

Windows:

1. Download từ: https://dev.mysql.com/downloads/mysql/
2. Chạy installer
3. Chọn port: 3306

Linux:

sudo apt install mysql-server
sudo mysql_secure_installation
sudo systemctl start mysql

macOS:

brew install mysql
mysql.server start

Tạo file .env trong thư mục root:

DB_HOST=localhost
DB_PORT=3306
DB_NAME=course_registration_db
DB_USER=root
DB_PASSWORD=your_password
DB_DRIVER=com.mysql.cj.jdbc.Driver

mysql -u root -p

CREATE DATABASE course_registration_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE course_registration_db;

mysql -u root -p course_registration_db < docs/mysql_schema.sql

mysql -u root -p course_registration_db < docs/insert_data.sql

SHOW TABLES;
SELECT * FROM users LIMIT 5;
SELECT * FROM students LIMIT 5;

Admin:
- Username: admin
- Password: admin123

Student:
- Username: student1
- Password: student123
- ID: SV001

1. Mở project: File → Open
2. Navigate: src/main/java/Main.java
3. Right-click → Run 'Main.main()'
4. Hoặc nhấn Shift + F10

1. Cài Extension: "Extension Pack for Java"
2. Click "Run" button trên Main.java
3. Hoặc nhấn Ctrl + F5

$JAVAFX_PATH = "lib\javafx-sdk-25\lib"
javac --module-path $JAVAFX_PATH --add-modules javafx.controls,javafx.fxml `
      -d bin -cp "lib\*" src\main\java\**\*.java
java --module-path $JAVAFX_PATH --add-modules javafx.controls,javafx.fxml `
     -cp "bin;lib\*" Main

JAVAFX_PATH="lib/javafx-sdk-25/lib"
javac --module-path $JAVAFX_PATH --add-modules javafx.controls,javafx.fxml \
      -d bin -cp "lib/*" src/main/java/**/*.java
java --module-path $JAVAFX_PATH --add-modules javafx.controls,javafx.fxml \
     -cp "bin:lib/*" Main

1. Khởi động ứng dụng
2. Chọn role: Student hoặc Admin
3. Nhập Username & Password
4. Nhấn "Đăng nhập"

1. Chọn tab "Đăng Ký Tín Chỉ"
2. Xem danh sách lớp học phần
3. Nhấn "Đăng Ký" cho lớp mong muốn
4. Hệ thống kiểm tra:
   • ✅ Không trùng môn?
   • ✅ Không trùng lịch?
   • ✅ Lớp còn chỗ?
5. Nếu hợp lệ → Đăng ký thành công
6. Nếu không → Hiển thị lý do từ chối

1. Chọn tab "Lịch Học"
2. Xem các lớp đã đăng ký
3. Thông tin: Ngày, thứ, tiết, phòng, giảng viên

1. Chọn tab "Đăng Ký Của Tôi"
2. Chọn lớp cần hủy
3. Nhấn "Hủy Đăng Ký"
4. Xác nhận → Hủy thành công

1. Chọn "Quản Lý Lớp Học Phần"
2. Nhấn "Tạo Lớp Mới"
3. Điền thông tin:
   • Chọn Môn Học
   • Chọn Giảng Viên
   • Nhập Số Tín Chỉ
   • Chọn Học Kỳ
4. Thêm Lịch Học:
   • Chọn Phòng Học
   • Chọn Ngày/Thứ
   • Nhập Tiết
   • Hệ thống kiểm tra trùng lịch phòng
5. Nhấn "Lưu"

1. Chọn "Quản Lý Đăng Ký"
2. Xem danh sách tất cả đăng ký
3. Sửa, xóa, hoặc xuất báo cáo

studentService.registerCourse(studentId, courseOfferingId);
studentService.cancelRegistration(registrationId);
studentService.getMyRegistrations(studentId);
studentService.getSchedule(studentId);

courseOfferingService.createCourseOffering(offering);  // ⭐ Schedule conflict check
courseOfferingService.updateCourseOffering(offering);
courseOfferingService.deleteCourseOffering(offeringId);

registrationService.register(registration);  // ⭐ Duplicate check
registrationService.cancelRegistration(registrationId);
registrationService.isDuplicateRegistration(studentId, courseId);

Location: CourseOfferingRepository.checkScheduleConflict()

Kiểm tra: Same room + Same semester + Same day + Time overlap

Location: RegistrationServiceImpl.register()

Kiểm tra: Sinh viên không đăng ký cùng một môn 2 lần

• Kiểm tra MySQL Server đang chạy
• Kiểm tra .env config
• Kiểm tra database tồn tại

• Đảm bảo mysql-connector-j-8.0.33.jar trong lib/
• Add library vào project (IDE)

• Cài JavaFX SDK
• Thêm module-path VM options

• Kiểm tra file nằm trong resources/fxml/
• Kiểm tra đường dẫn có "/" ở đầu

• Clean & rebuild project
• Kiểm tra classpath

MODEL → REPOSITORY → SERVICE → CONTROLLER

• MVC: Model-View-Controller
• Repository: Data Access abstraction
• Service Layer: Business logic
• Singleton: DatabaseConnection

• S: Mỗi class có 1 trách nhiệm
• O: Mở để mở rộng, đóng để sửa
• L: Liskov Substitution (inheritance)
• I: Interface Segregation
• D: Dependency Inversion

✅ Clean Code - Đặt tên rõ ràng
✅ Error Handling - Try-catch
✅ Validation - Service layer
✅ DRY - Không lặp code
✅ Transactions - Safe operations

Quy Trình Contribute:

1. Fork repository
2. Tạo branch: git checkout -b feature/name
3. Commit: git commit -m "Add feature"
4. Push: git push origin feature/name
5. Mở Pull Request

• Java 21 Docs
• JavaFX 25
• MySQL Docs
• JDBC Tutorial

• PROJECT_STRUCTURE.md
• mysql_schema.sql
• insert_data.sql
• dbml.md

• Scene Builder
• MySQL Workbench
• DBeaver
• Git Kraken

Dự án này được cấp phép theo Giấy phép MIT.

Bạn được phép:

• ✅ Sử dụng cho mục đích thương mại & cá nhân
• ✅ Sửa đổi & phân phối lại
• ✅ Sử dụng là phần của project khác

Điều kiện:

• ⚠️ Phải kèm bản copy của license
• ⚠️ Phải công nhân các thay đổi
• ⚠️ Không có warranty

Chi tiết: Xem file LICENSE

• GitHub Issues: Report bugs
• Discussions: Ask questions
• Email: hungba1811@gmail.com

Dự án được tạo ra nhằm:

1. 📖 Học tập OOP
2. 🏗️ Kiến trúc phần mềm
3. 🗄️ Quản lý Database
4. 🎨 UI Development
5. 📊 Real-world Features

Khuyến khích:

• 🔍 Khám phá code từng layer
• 🧪 Viết test cases
• 🐛 Debug & trace
• 📝 Thêm comments
• ⭐ Optimize code

Status: ✅ Active Development | 🎯 Production Ready