Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎓 Tool Đăng Ký Học Phần - UTH

Công cụ hỗ trợ đăng ký học phần nhanh chóng cho sinh viên Đại học Giao thông Vận tải



Sponsor


✨ Tính năng

📋 Quản lý học phần

  • 📚 Xem học phần đã đăng ký
  • 🆕 Danh sách học phần học mới
  • ❌ Hủy đăng ký học phần

🔍 Tìm kiếm & Đăng ký

  • 🔎 Tìm kiếm lớp học phần
  • ⚡ Đăng ký nhanh chóng
  • 🔄 Tự động đăng nhập lại

🚀 Cài đặt và Chạy

📦 Yêu cầu hệ thống

Node.js >= 14.0.0
npm >= 6.0.0

📥 Cài đặt

# Bước 1: Cài đặt các dependencies
npm install

# Bước 2: Khởi động server
npm start

🌐 Truy cập ứng dụng

Mở trình duyệt và truy cập:

http://localhost:3000

⚠️ Lưu ý: Server phải luôn chạy để ứng dụng hoạt động (xử lý CORS và proxy API)


📖 Hướng dẫn sử dụng

🔐 Phương thức 1: Đăng nhập bằng tài khoản (Khuyên dùng)

👉 Click để xem chi tiết

1️⃣ Chuyển sang tab "Đăng Nhập"

2️⃣ Nhập thông tin

📧 Tên đăng nhập: Mã sinh viên của bạn
🔑 Mật khẩu: Mật khẩu portal
☑️ Nhớ mật khẩu: Tự động đăng nhập lại khi token hết hạn

3️⃣ Click "Đăng Nhập"

  • ✅ Hệ thống tự động lấy token
  • ✅ Token sẽ được lưu và tự động làm mới
  • ✅ Không cần lấy token thủ công

💡 Lợi ích: Tự động đăng nhập lại khi token hết hạn, không bị gián đoạn!


🔑 Phương thức 2: Sử dụng Bearer Token

👉 Click để xem chi tiết

1️⃣ Lấy Bearer Token

  1. 🌐 Truy cập portal.ut.edu.vn và đăng nhập
  2. ⌨️ Nhấn F12 để mở Developer Tools
  3. 📡 Chọn tab Network
  4. 🔄 Thực hiện một thao tác bất kỳ (vào trang đăng ký học phần)
  5. 🔍 Tìm request có header Authorization: Bearer ...
  6. 📋 Copy toàn bộ token

2️⃣ Nhập Token vào Tool

1. Paste token vào ô "Nhập Bearer Token"
2. Click "Lưu Token"
3. Token được lưu trong trình duyệt

⚠️ Lưu ý: Token sẽ hết hạn sau một thời gian và cần lấy lại!


📚 Sử dụng các chức năng chính

🔄 Tải đợt đăng ký

1. 📥 Click "Tải Đợt Đăng Ký"
2. 🎯 Chọn đợt đăng ký từ dropdown
3. ⏳ Đợi hệ thống tải dữ liệu

📋 Xem học phần đã đăng ký

Các bước thực hiện:

  1. Click menu "Đã Đăng Ký" bên trái
  2. Xem danh sách học phần đã đăng ký
  3. Xem chi tiết: mã HP, tên HP, số tín chỉ, lịch học
  4. Click "Hủy Đăng Ký" nếu muốn hủy

🆕 Xem học phần học mới

Các bước thực hiện:

  1. Click menu "Học Phần Mới"
  2. Danh sách học phần có thể đăng ký hiển thị
  3. Dùng ô tìm kiếm để lọc học phần
  4. Click "Tìm Lớp" để xem các lớp có sẵn

🔍 Tìm kiếm và đăng ký học phần

Các bước thực hiện:

  1. Click menu "Tìm & Đăng Ký"
  2. Nhập mã học phần (VD: 0104080102)
  3. Click "Tìm Lớp Học Phần"
  4. Chọn lớp muốn đăng ký
  5. Click nút "Đăng Ký"
  6. Nhập reCAPTCHA nếu được yêu cầu
  7. Xác nhận đăng ký

💡 Mẹo sử dụng

🎯 Mẹo 📝 Mô tả
Đăng nhập bằng tài khoản Tự động làm mới token, không lo bị logout
Giữ server chạy Đảm bảo server luôn chạy khi sử dụng tool
Tìm kiếm nhanh Dùng Ctrl+F để tìm học phần trong danh sách
Đăng ký nhiều lớp Mở nhiều tab để đăng ký song song
Kiểm tra thường xuyên Token có thể hết hạn, kiểm tra trạng thái đăng nhập

❓ Câu hỏi thường gặp

❌ Lỗi "Unauthorized" hoặc "Token hết hạn"?

Giải pháp:

  • ✅ Sử dụng phương thức đăng nhập bằng tài khoản (tự động làm mới)
  • ✅ Hoặc lấy token mới từ portal
  • ✅ Kiểm tra token đã được lưu chưa
⚠️ Không tải được dữ liệu?

Kiểm tra:

  1. ✅ Server có đang chạy không? (npm start)
  2. ✅ Token còn hạn không?
  3. ✅ Kết nối internet ổn định không?
  4. ✅ Portal có đang bảo trì không?
🔄 Không đăng ký được học phần?

Nguyên nhân có thể:

  • ⚠️ Lớp đã đầy
  • ⚠️ Chưa đủ điều kiện (học phần tiên quyết)
  • ⚠️ Trùng lịch học
  • ⚠️ reCAPTCHA không đúng hoặc hết hạn
  • ⚠️ Ngoài thời gian đăng ký

🛠️ Hỗ trợ


⚖️ Lưu ý

⚠️ Tool này chỉ dành cho mục đích học tập và hỗ trợ sinh viên.
⚠️ Không sử dụng cho mục đích thương mại hoặc spam hệ thống.
⚠️ Token và thông tin đăng nhập được lưu trên máy local, không gửi đi nơi khác.


🌟 Nếu thấy hữu ích, hãy cho một star! 🌟

Made with ❤️ by UTH Students

Lưu ý

  • Token có thời hạn, nếu hết hạn cần lấy token mới
  • Một số học phần có thể không cho phép hủy đăng ký
  • Đảm bảo kết nối internet ổn định khi sử dụng
  • Ứng dụng lưu token trong localStorage của trình duyệt

Hỗ trợ

Nếu gặp vấn đề, vui lòng kiểm tra:

  • Token còn hiệu lực chưa
  • Đã chọn đợt đăng ký chưa
  • Kết nối internet có ổn định không
  • Console của trình duyệt có lỗi gì không (F12 > Console)

License

Dự án này được tạo cho mục đích giáo dục và sử dụng cá nhân.

About

HungVu

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages