Tool Đăng Ký Học Phần UIT

Giới thiệu

Tool Đăng Ký Học Phần UIT là một ứng dụng web hỗ trợ các bạn sinh viên UIT đăng ký học phần được dễ dàng, tiện lợi. Ứng dụng gồm 2 phần chính: 1. Tool Soạn Thời Khoá Biểu (chuẩn bị cho ĐKHP) và 2. Script Đăng Ký Học Phần - hỗ trợ ĐKHP nhanh hơn đăng ký thủ công - được gen ra từ bước 1. Soạn thời khoá biểu.

Trước kia, để 1. Soạn Thời Khoá Biểu mất vài ngày, bây giờ chỉ mất vài phút, để 2. ĐKHP mất vài phút, bây giờ chỉ mất vài giây.

Các update ở phiên bản 2024

Preview

Ở phiên bản mới nhất, người dùng có thể preview Thời Khoá Biểu ngay trong Grid Danh Sách Lớp bằng 1 trong 2 cách:

1. Sử dụng tab Preview trên Sidebar

2. Mở 2 tab browser (tiện lợi cho người có 2 màn hình)

Selection Behavior

Ở phiên bản mới nhất:

1. Những slot bị trùng TKB sẽ không hiện checkbox (non-selectable), giúp nhanh chóng chỉ ra những lớp nào có thể chọn được

2. Khi chọn thừa lớp cho môn, sẽ hiện các cặp lớp thừa lên Thời Khoá Biểu

3. Có thể tương tác trực tiếp lên Thời Khoá Biểu: Click để xoá môn, Shift+Click và Ctrl+Shift+Click cho các trường hợp đặc biệt khác

Những lớp chung môn cũng sẽ hiện biểu tượng icon thùng rác khi hover để nhanh chóng nhận biết lớp nào sẽ bị xoá sau khi click.

Filters/Columns/RowGroup

Ở phiên bản mới nhất, các filters, columns, row group configs đã được cải thiện cho mượt mà hơn và hoạt động hợp lý hơn. Các configs này sẽ hiện ở 4 nơi:

1. Ngay trên Header Name của column

2. Tab "Filters" ở Sidebar

3. Tab "Columns" ở Sidebar

4. Context Menu (khi click chuột phải lên Grid)

Others

1. Chia sẻ TKB

Khi bấm vào nút chia sẻ TKB, các bạn sẽ được đưa đến 1 url với query param https://dkhp-uit.vercel.app?self_selected={1 danh sách mã lớp}. Url này có thể dùng đễ lưu lại trạng thái các lớp đã chọn, hoặc chia sẻ cho bạn bè.

NOTE: Thời Khoá Biểu hiển thị sẽ ưu tiên danh sách mã lớp trên url. Nếu bạn muốn hiển thị Thời Khoá Biểu theo các lớp được chọn ở local, phải xoá url query param đó đi (url query param có ưu tiên hiển thị cao hơn các lớp được chọn ở local).

2. Tải hình ảnh TKB về máy

3. Copy script

Old doc (before 2024)

👉 TODOLIST

Giới thiệu

Tool Đăng Ký Học Phần UIT là một ứng dụng hỗ trợ các bạn sinh viên UIT đăng ký học phần được dễ dàng, tiện lợi.

Vì sẽ có rất nhiều đối tượng sinh viên, và rất nhiều trong số đó chỉ muốn sử dụng một số tính năng nhất định của ứng dụng mà không muốn sử dụng toàn bộ ứng dụng. Do đó, các tính năng của ứng dụng đã được tách rời, làm cho không phụ thuộc vào nhau, giúp phục vụ nhiều đối tượng sinh viên nhất có thể.
Chẳng hạn, bạn master Excel, có thể tự soạn thời khoá biểu cho bản thân mình nên không cần sử dụng tính năng Soạn thời khoá biểu của ứng dụng này, thì bạn vẫn có thể sử dụng tính năng Vẽ thời khoá biểu để xem thời khoá biểu bạn đã soạn, hoặc sử dụng tính năng Tạo script ĐKHP nhanh để tạo lợi thế ĐKHP nhờ script tự động thao tác nhanh hơn so với đăng ký học phần thủ công.

Usecase

Lược đồ usecase tổng quát

So với usecase trên trường học thì «cần» ở đây là «include», «có thể giúp» là «extend»

Tách usecase

Phân tích tính năng

Input + Hành động người dùng + Hệ thống xử lý = Output

Tính năng	Input	Hành động người dùng	Output
0. Tạo nguồn dữ liệu		- Sử dụng dữ liệu mặc định - Tải lên file excel - Crawl từ trang dkhp.uit.edu.vn	Dữ liệu lớp học
1. Soạn thời khoá biểu	Dữ liệu lớp học	Sort, filter, pick lớp	Danh sách lớp học sẽ ĐK
2. Vẽ thời khoá biểu	- Dữ liệu lớp học - Danh sách lớp học sẽ ĐK		Giao diện thời khoá biểu - Copy to clipboard - Tải về máy
3. Tạo script ĐKHP nhanh	Danh sách lớp học sẽ ĐK		Script ĐKHP nhanh
4. Xem giao diện ĐKHP			Giao diện ĐKHP mẫu

Mối quan hệ giữa các tính năng

Tách tính năng Vẽ thời khoá biểu

Tách tính năng Tạo script ĐKHP nhanh

Phân rã chức năng

Cấu trúc giao diện

Giao diện gồm 5 màn hình tương ứng với 5 tính năng bên trên:

Tính năng Tạo nguồn dữ liệu → Màn hình Tạo dữ liệu
Tính năng Soạn thời khoá biểu → Màn hình Soạn TKB
Tính năng Vẽ thời khoá biểu → Màn hình Vẽ TKB
Tính năng Tạo script ĐKHP nhanh → Màn hình Script ĐKHP nhanh
Tính năng Xem giao diện ĐKHP → Màn hình Giao diện ĐKHP

Hướng dẫn bảo trì dự án

Về thiết kế hệ thống, bảo trì các lược đồ (diagrams)

Bảo trì mã nguồn

Cách khởi chạy dự án

Code convention

Cách chạy testcase

Cập nhật thời khoá biểu mặc định

FAQ

0. Cách tải file excel từ file Google Sheets protected.

Chuyển file trường đăng sang chế độ preview: https://stackoverflow.com/a/46493867
Copy content từ file trường đăng sang file mới (Ctrl A Ctrl C ctrl V)
2.1. Tinh chỉnh file mới cho đúng format của file excel trường hay đăng (nếu cần thiết)
Tải về file mới dưới định dạng xlsx

Ví dụ file HK2 2023-2024 mình published có thể xem ở đây
https://docs.google.com/spreadsheets/d/e/2PACX-1vRyf8-kMRTo4CllfPA4sjbjxkhGhR1tT7yD1HASjmClqTwwkJBgWRvuxJPIAK8Wdw/pubhtml

1. Gặp warning `Don't paste code into DevTools Console...` phải làm sao?

Đơn giản, gõ allow pasting rồi enter. Sau 1 lần thì lần sau sẽ không gặp nữa. Pro tip: xử lý cái này trước khi ĐKHP thực chiến. Read more here.

2. Script sài có ổn định không, còn dùng được cho học kì này không?

Pro tip: Các bạn nên paste sẵn script, đợi trang load ra thì Enter để chạy thôi để tối ưu hoá thời gian, đừng để trang load ra rồi mới paste script.
Script vẫn luôn sống sót qua nhiều năm và dùng được cho học kì gần nhất. Tuy nhiên, bên cạnh đó, các bạn nên luôn sẵn sàng với phương án back-up tự đăng ký tay:

Ở bước 3, tool có gen ra "danh sách mã lớp cách nhau bằng dấu phẩy".
Các bạn copy danh sách đó vào ô search của web ĐKHP

Trang web của trường sẽ filter ra danh sách mã lớp theo đó, các bạn tự tay tick tất cả các mã lớp cần chọn (thay vì được script click cho)
Rồi submit

Thật ra cũng không chậm hơn là mấy. Nếu có vấn đề gì có thể inbox nói mình biết. Mình khuyến khích các bạn đăng ký sát theo TKB gợi ý của trường.

3. Sài script đăng ký có góp phần làm server trường down, lỗi 502 không?

KHÔNG.
Ngày xưa trang web đăng ký học phần của trường mình có hỗ trợ đăng ký nhanh out-of-the-box luôn. Script này chỉ như mang lại tính năng ngày xưa đó trở về với hiện tại thôi. Các bạn có thể xem giao diện ngày xưa ở đây
Về việc làm server trường down, ngày xưa khi trường chưa có captcha, có nhiều tool, các tool đó giúp tự động mở browser, tự động đăng nhập, tự động nhập lớp, tự động đăng ký, và nếu như các bước đó gặp lỗi, tool sẽ tự động retry và tạo ra rất nhiều request tới server, làm nghẽn server. Trong khi đó, script này, các bạn phải tự đăng nhập, tự vượt captcha, nếu bị 502 các bạn phải tự reload trang, script chỉ giúp bạn nhanh hơn một vài click chuột chứ không auto và tra tấn server, không tạo ra thêm request cho server so với một người đăng ký thủ công bình thường, cho nên không góp phần làm nghẽn server. Script chỉ có vài dòng và các bạn biết javascript đọc phát là hiểu luôn, nó chỉ ảnh hưởng ở mức client.

Old questions

4. Anh làm cho thời khoá biểu (bước 3) hiện ngay trong bước Xếp lớp (bước 2) luôn được không, em phải tab qua tab lại giữa 2 bước mà thấy nó chậm quá

Update 2023: Đã thêm tính năng

5. Trường cho phép đăng ký xen kẽ cách tuần giữa 2 lớp thực hành hình thức 1 (HT1) mà sao tool của anh không cho?

Update 2023: Như mình nói bên dưới, không khuyến khích nhét xen kẽ / hình như mới nhất trường k có hỗ trợ, nên mình sẽ không hỗ trợ.

Hồi mình học có nhiều môn thầy cô đã ưng ưng đổi lại và nhiều lớp .1 học cùng tuần với .2, nên không có gì đảm bảo lớp .1 sẽ học xen kẽ tuần với lớp .2 cả, nên mình đã nghĩ là trường không cho phép đăng ký xen kẽ như vậy. Nhưng mà sau khi hỏi lại cố vấn học tập thì có vẻ như trường cho phép đăng ký xen kẽ, nên tính năng đó đang nằm trong todolist, mình sẽ update sau. Mình cũng ngại update sau khi release nên khả năng cao nó sẽ chỉ xuất hiện trong học kỳ tiếp theo.

Tuy nhiên dù gì đi nữa, các lớp có thực hành thường sẽ theo mô típ là 3 tiết lý thuyết buổi sáng + 5 tiết thực hành buổi chiểu, hoặc 5 tiết thực hành buổi sáng + 3 tiết lý thuyết buổi chiều trong cùng một ngày. Nên nếu nhét được 2 buổi thực hành xen kẽ, cũng khó mà nhét được 2 buổi lý thuyết. Với lại lỡ như giáo viên đổi như mình ngày xưa thì sao, trong khi thời khoá biểu UIT mình thấy không thiếu chỗ tới mức phải nhét, nên nói thật là không khuyến khích đăng ký kiểu đó. Tuy nhiên mình vẫn sẽ update để đáp ứng được mọi usecase ❤️.

loia5tqd001 / dang-ky-hoc-phan-uit Goto Github PK

dang-ky-hoc-phan-uit's Introduction

Tool Đăng Ký Học Phần UIT

Giới thiệu

Các update ở phiên bản 2024

Preview

Selection Behavior

Filters/Columns/RowGroup

Others

Giới thiệu

Usecase

Lược đồ usecase tổng quát

Tách usecase

Phân tích tính năng

Mối quan hệ giữa các tính năng

Phân rã chức năng

Cấu trúc giao diện

Hướng dẫn bảo trì dự án

Về thiết kế hệ thống, bảo trì các lược đồ (diagrams)

Bảo trì mã nguồn

Cách khởi chạy dự án

Code convention

Cách chạy testcase

Cập nhật thời khoá biểu mặc định

dang-ky-hoc-phan-uit's People

Contributors

Stargazers

Watchers

Forkers

dang-ky-hoc-phan-uit's Issues

Expect

Actual

0. Cách tải file excel từ file Google Sheets protected.

1. Gặp warning Don't paste code into DevTools Console... phải làm sao?

2. Script sài có ổn định không, còn dùng được cho học kì này không?

3. Sài script đăng ký có góp phần làm server trường down, lỗi 502 không?

4. Anh làm cho thời khoá biểu (bước 3) hiện ngay trong bước Xếp lớp (bước 2) luôn được không, em phải tab qua tab lại giữa 2 bước mà thấy nó chậm quá

5. Trường cho phép đăng ký xen kẽ cách tuần giữa 2 lớp thực hành hình thức 1 (HT1) mà sao tool của anh không cho?

6. Nếu thấy hữu dụng thì thả star repository Github này giúp mình nhé ❤️

Recommend Projects

Recommend Topics

Recommend Org

1. Gặp warning `Don't paste code into DevTools Console...` phải làm sao?