UIT Assignment Manager

Quản lý bài tập thông minh cho sinh viên UIT — xây dựng với Electron, tích hợp Moodle API.

---

Bản cập nhật 3.2.0

• Tổng quan: thêm tóm tắt và điều hướng nhanh giữa các khu vực chính.
• Hồ sơ: hiển thị bổ sung khi có dữ liệu.
• Cài đặt: tùy chọn làm mới theo chu kỳ (khi bật).
• Quản lý bài tập: nút Làm mới chuyển sang bên phải thanh lọc; thứ tự filter giữ nguyên.

Chi tiết: CHANGELOG.md.

---

Tính Năng

• Đăng nhập bằng MSSV: Bind token vào MSSV cho lần đầu tiên, tài khoản được lưu trữ để đăng nhập nhanh hon!

lưu ý: tick Bỏ qua kiểm tra chứng chỉ TLS nếu không đăng nhập được

• Lưu trữ an toàn: Token được mã hóa và lưu cục bộ bằng Electron Store
• Quản lý nhiều tài khoản: Dễ dàng chuyển đổi người dùng
• Dashboard: Thống kê, cảnh báo bài tập sắp hạn, lịch có thể tương tác; dòng tóm tắt và điều hướng nhanh giữa các khu vực (khi có dữ liệu).
• Quản Lý Bài Tập: Hệ thống lọc đa dạng, loading và lưu trữ cục bộ trong session để giảm thời gian load.
• Chi tiết Bài Tập: Đã nộp, chưa nộp, nộp muộn, hạn chót, thời điểm nộp, ghi chú
• Quản Lý Môn Học: Danh sách môn học theo học kỳ
• Chi tiết Môn Học: Danh sách bài tập, thông báo, file, liên kết, ghi chú
• Thời Khóa Biểu: Import từ file .ics, hiển thị dynamic theo giờ và thứ realtime.
• Hệ Thống Ghi Chú: Tự tạo và quản lý file word theo từng môn, từng bài tập, thêm xóa sửa.
• Settings: Nhiều option settings tùy nhu cầu (mở cùng windows, chạy ngầm, thông báo, dark/light mode)
• Deadline thủ công (Manual): Tạo deadline / reminder cá nhân (không có trên Moodle) với:
  • Tiêu đề, mô tả, liên kết môn (lọc tự động theo học kỳ hiện tại mới nhất)
  • Chọn trạng thái hoàn thành
  • Bộ chọn thời gian nâng cao + nút nhanh: Hôm nay 23:59, Ngày mai 23:59, +3 ngày, Tuần sau, +1 tuần, Cuối tháng
  • Xem nhanh thứ & thời gian còn lại ngay trong modal
  • Lưu trữ cục bộ (không đồng bộ Moodle)
  • Màu tùy chỉnh & Tags gắn nhiều nhãn (#ôn tập, #nhóm …)
  • Nhắc trước X phút/giờ/ngày (notification tự động một lần)
  • Giao diện nâng cấp v2.4.0: Modal 3-tab (Sơ bộ/Chi tiết/Nhãn), sắp xếp đa dạng, tìm kiếm nâng cao
  • Countdown timer: Hiển thị thời gian còn lại trực quan với màu sắc cảnh báo
  • Sắp xếp thông minh: Theo deadline gần nhất, xa nhất, tên, thời gian tạo
  • UI/UX hiện đại: Glassmorphism, animations, responsive design

Demo hình ảnh các tính năng ở dưới

Tải xuống

• Tự build bằng npm run dist
• Hoặc theo dõi mục Releases trên repo.

Lưu ý: Ứng dụng hỗ trợ Windows 10/11. macOS/Linux có thể build từ source.

Cài đặt từ mã nguồn

Yêu cầu

• Node.js 16+ (khuyến nghị 18+)
• Git

Bắt đầu

git clone https://github.com/HyIsNoob/uit-manager.git
cd uit-manager
npm install

# Chạy dev
npm start

# Build sản phẩm (đầu ra tại thư mục dist/)
npm run build

Các script có sẵn (trích từ package.json):

npm start     # Chạy Electron app
npm run dev   # Chạy Electron ở chế độ dev
npm run build # Đóng gói theo cấu hình electron-builder
npm run dist  # Đóng gói, không publish
npm run release # Đóng gói và publish lên GitHub (nếu cấu hình)

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

1. Mở ứng dụng → chờ màn hình loading
2. Đăng ký tài khoản lần đầu:
   • Nhập MSSV
   • Nhập token API Moodle (xem cách lấy bên dưới)
   • Bấm “Đăng ký tài khoản”
3. Đăng nhập bằng MSSV đã lưu
4. Xem danh sách môn học, bài tập; theo dõi deadline và trạng thái nộp
5. Thêm deadline thủ công:

• Mở tab "Deadline" (hoặc biểu tượng tương ứng nếu bạn đã đổi tên)
• Bấm nút "Thêm deadline" để mở modal cỡ lớn
• Dùng các nút preset: Hôm nay 23:59 / Ngày mai 23:59 / +3 ngày / Tuần sau / +1 tuần / Cuối tháng
• Chọn môn (danh sách đã lọc theo học kỳ hiện tại tự phát hiện)
• Lưu lại. Có thể sửa / đánh dấu hoàn thành bất cứ lúc nào.

Lấy token API Moodle

1. Đăng nhập https://courses.uit.edu.vn
2. Vào Tài khoản → Tùy Chọn → Khóa bảo mật
3. Tạo token cho dịch vụ “Moodle mobile web service” (Tái lập)
4. Sao chép token và dán vào ứng dụng

Kiến trúc & Công nghệ

• Electron (Desktop framework)
• Renderer: HTML5, CSS3, JavaScript (ES6+)
• Dữ liệu cục bộ: Electron Store
• HTTP client: Axios
• Cập nhật ứng dụng: electron-updater
• Tích hợp: Moodle REST API

Các endpoint Moodle sử dụng:

• core_webservice_get_site_info
• core_course_get_categories
• core_enrol_get_users_courses
• mod_assign_get_assignments
• mod_assign_get_submission_status

Bảo mật

• Token được mã hóa và lưu trữ cục bộ
• Tất cả request sử dụng HTTPS
• Không gửi dữ liệu người dùng lên máy chủ bên thứ ba

Câu hỏi thường gặp (FAQ)

• Không thấy bài tập sau khi đăng nhập?

  • Kiểm tra token còn hạn và có quyền “Moodle mobile web service”
  • Bấm làm mới dữ liệu hoặc đăng nhập lại

• Lỗi cài đặt trên Windows?

  • Tải đúng phiên bản .exe phù hợp và đóng các phiên bản đang chạy trước khi cài

• Thêm deadline thủ công báo lỗi "No handler registered for create-custom-deadline"?

  • Nguyên nhân: Main process chưa được reload sau khi cập nhật tính năng mới.
  • Cách xử lý: Đóng hoàn toàn ứng dụng (thoát khỏi khay hệ thống nếu có) rồi mở lại / hoặc chạy lại npm start trong môi trường dev.
  • Đảm bảo file main.js đã chứa các IPC handler: get-custom-deadlines, create-custom-deadline, ...

• Nhắc trước không hiện?

  • Chỉ kích hoạt 1 lần khi thời gian hiện tại nằm trong khoảng (due - offset) < now < due.
  • Chỉnh sửa deadline sẽ reset trạng thái nhắc.
  • Kiểm tra phần cài đặt thông báo đã bật Toast/In-app.

Demo Chi Tiết Tính Năng

• Đăng nhập bằng MSSV: Bind token vào MSSV cho lần đầu tiên, tài khoản được lưu trữ để đăng nhập nhanh hon!

*lưu ý: tick Bỏ qua kiểm tra chứng chỉ TLS nếu không đăng nhập được* - **Lưu trữ an toàn**: Token được mã hóa và lưu cục bộ bằng Electron Store - **Quản lý nhiều tài khoản**: Dễ dàng chuyển đổi người dùng - **Dashboard**: Thống kê, cảnh báo bài tập sắp hạn, lịch có thể tương tác; từ 3.2.0: thêm tóm tắt và điều hướng nhanh. - **Quản Lý Bài Tập**: Hệ thống lọc đa dạng, loading và lưu trữ cục bộ trong session để giảm thời gian load. - **Chi tiết Bài Tập**: Đã nộp, chưa nộp, nộp muộn, hạn chót, thời điểm nộp, ghi chú - **Quản Lý Môn Học**: Danh sách môn học theo học kỳ - **Chi tiết Môn Học**: Danh sách bài tập, thông báo, file, liên kết, ghi chú - **Thời Khóa Biểu**: Import từ file .ics, hiển thị dynamic theo giờ và thứ realtime. - **Hệ Thống Ghi Chú**: Tự tạo và quản lý file word theo từng môn, từng bài tập, thêm xóa sửa.

🔗 Liên kết

• Mã nguồn: https://github.com/HyIsNoob/uit-manager
• Moodle UIT: https://courses.uit.edu.vn

---