SV HaUI Helper

🎓 Nâng cao trải nghiệm cho sinh viên HaUI
Báo lỗi · Yêu cầu tính năng

English | Tiếng Việt

---

📖 Giới thiệu

SV HaUI Helper là một userscript được thiết kế để cải thiện trải nghiệm sử dụng cổng thông tin sinh viên sv.haui.edu.vn của Đại học Công nghiệp Hà Nội (HaUI).

Dự án được xây dựng với kiến trúc module hóa, dễ dàng mở rộng và bảo trì.

✨ Tính năng

Tính năng	Mô tả	Trạng thái
🏷️ Dynamic Title	Thay đổi tiêu đề tab theo trang	✅
🔐 Captcha Helper	Tự động nhận diện (OpenCV + Tesseract) và nhập captcha	✅
🚀 Quick Nav	Điều hướng nhanh giữa trang Điểm TX và Điểm thi	✅
📝 Survey Auto	Đánh giá nhanh (chọn 1-5 điểm cho toàn bộ câu hỏi)	✅
📅 Calendar Export	Xuất thời khóa biểu sang file ICS, theo dõi cập nhật	✅
❄️ Remove Snowfall	Ẩn hiệu ứng tuyết rơi trên trang	✅

🚀 Cài đặt

Yêu cầu

• Trình duyệt: Chrome, Firefox, Edge, hoặc Safari
• Extension quản lý userscript:
  • Tampermonkey
  • Violentmonkey

Cài đặt nhanh

1. Cài đặt Tampermonkey hoặc Violentmonkey từ cửa hàng extension của trình duyệt.
2. Chọn một trong các nguồn dưới đây để cài đặt script:

Nguồn	Link	Ghi chú
Greasy Fork	Cài đặt	⭐ Khuyến nghị. Tự động cập nhật. Thích hợp cho đa số người dùng.
GitHub (minified)	svhaui-helper.min.user.js	Nhẹ hơn, nhận bản cập nhật trực tiếp từ kho lưu trữ.
GitHub (unminified)	svhaui-helper.user.js	Bản build dễ đọc hơn. Dành để kiểm tra mã (chưa nén). Cài đặt bản mới nhất tại thời điểm tải và không tự động cập nhật.

3. Xác nhận cài đặt trong popup của Tampermonkey/Violentmonkey.
4. Truy cập sv.haui.edu.vn và tận hưởng!

⚠️ Lưu ý cho Chrome / Edge (Manifest V3)

Do chính sách bảo mật mới của Google, bạn bắt buộc phải cấp quyền thủ công thì Script mới chạy được:

1. Mở trang Quản lý tiện ích: gõ chrome://extensions vào thanh địa chỉ.
2. Bật Developer mode (Chế độ nhà phát triển) ở góc trên bên phải (nếu dùng Chrome hãy làm tiếp các bước bên dưới).
3. Tìm Tampermonkey/Violentmonkey → Click nút Details (Chi tiết).
4. Kéo xuống tìm và bật công tắc tại dòng:

   Cho phép tập lệnh của người dùng (Allow user scripts) (Dòng này có chú thích: "Tiện ích này sẽ có thể chạy mã chưa được Google xem xét...")

5. Nếu thấy popup cảnh báo "Disable developer mode extensions" khi khởi động lại trình duyệt, hãy chọn Keep (Giữ lại).

🛠️ Phát triển

Yêu cầu

• Node.js >= 18
• pnpm (khuyến nghị) hoặc npm

Thiết lập môi trường

# Clone repository
git clone https://github.com/vuquan2005/svHaUI-Helper.git
cd svHaUI-Helper

# Cài đặt dependencies
pnpm install

# Chạy development server
pnpm dev

☕ Ủng hộ

Nếu bạn thấy dự án hữu ích, hãy cân nhắc ủng hộ tác giả.