Hướng dẫn sử dụng Exam Support App CTUMP
Biên soạn từ mã nguồn FastAPI, các giao diện quản trị/sinh viên và mẫu ngân hàng câu hỏi Triết – Ngoại ngữ. Tài liệu tập trung vào thao tác thực tế cho giảng viên và sinh viên, có lưu đồ, mockup minh họa và các lưu ý chống gian lận.
Mục lục & phạm vi
Tài liệu thao tác nhanh dành cho người dùng cuối
Mục lục nhanh
Phạm vi tài liệu
- ✓Dựa trên các route trong
main.py, các templateadmin_*.html,student_*.htmlvà logo CTUMP. - ✓Phản ánh đúng các hành vi quan trọng: một phiên thi/thiết bị, làm tuần tự từng câu, có chat riêng, có monitor trực tiếp.
- ✓Giảng viên có thể: tạo/kích hoạt đề, import file .docx, sửa câu hỏi trước khi đề được dùng, gia hạn, chặn, buộc nộp, reset lượt thi, chấm tự luận/điền từ.
- ✓Sinh viên phải: đăng nhập Google, nhập MSSV/lớp/bộ môn, chọn đề đúng, không thoát tab, nộp bài theo quy định.
Tổng quan & quy tắc hệ thống
Những điểm cần nắm trước khi thao tác
Tổng quan hệ thống
Hệ thống chia thành 2 vùng làm việc: giảng viên/admin và sinh viên. Dữ liệu đề thi, câu hỏi, lượt thi, chat, monitor và chấm điểm đều chạy xuyên suốt từ cùng một mã nguồn FastAPI.
Quy tắc lõi rút ra từ code
- 1Sinh viên chỉ được làm tuần tự từng câu; đã sang câu sau thì câu trước bị khóa, không quay lại.
- 2Nếu câu được cấu hình bắt buộc trả lời, sinh viên không thể qua câu tiếp theo hay nộp bài khi còn thiếu câu bắt buộc.
- 3Giảng viên chỉ được sửa/xóa câu hỏi khi câu đó chưa được dùng trong một lượt thi nào.
- 4Chat riêng giảng viên – sinh viên hoạt động theo từng lượt thi; có thể gửi kèm tệp nhỏ.
- 5Hệ thống có thể chặn, buộc nộp, gia hạn, reset, xóa lượt thi theo từng sinh viên hoặc hàng loạt.
Tạo đề · quản lý câu hỏi · monitor · chấm · xuất Excel
Exam · Question · Attempt · ChatMessage · chấm điểm tự động
Google login · thông tin dự thi · làm bài · nhận cảnh báo · xem kết quả
Lưu đồ thao tác giảng viên
Từ lúc mở dashboard đến khi hoàn tất chấm điểm
Lưu đồ giảng viên
Điểm kiểm soát quan trọng
Cấu hình trong ô class_rules_json để số câu phù hợp từng lớp; đồng thời hệ thống vẫn gán rule dự phòng theo MSSV chẵn/lẻ.
Nút kích hoạt trên dashboard cho phép giảng viên đóng đề ngay khi phát hiện lỗi import hoặc sai thời gian.
Xem câu hiện tại, nội dung sinh viên đang nhập/chọn, trạng thái, số vi phạm, chat riêng.
Buộc nộp dùng khi muốn chốt bài ngay; Chặn dùng khi muốn khóa quyền tiếp tục làm bài.
Lưu đồ thao tác sinh viên
Đường đi chuẩn để tránh lỗi phiên làm bài
Lưu đồ sinh viên
- Không thoát tab
- Không dùng 2 thiết bị
- Phải nộp đúng hạn
- Vào cổng thi
- Chọn đề
- Làm tuần tự
- Nộp bài
Mẫu import ngân hàng câu hỏi
Ví dụ khuyến nghị cho Triết và Ngoại ngữ
Mẫu import dành cho bộ môn Triết
[MCQ] Question: Theo chủ nghĩa duy vật lịch sử, yếu tố quyết định sự vận động và phát triển của xã hội là gì? A. Ý thức xã hội B. Tồn tại xã hội C. Hệ tư tưởng thống trị D. Nhà nước pháp quyền Answer: B Points: 1
Mẫu import dành cho Ngoại ngữ
[MCQ] Question: Which part of the brain is responsible for coordination and balance? A. Cerebrum B. Medulla oblongata C. Cerebellum D. Thalamus Answer: C Points: 0.4 Fill in each blank with ONE suitable word: (0.5 x 6) The nervous system transmits [1]_____ between different parts... Answer: 1. signals | 2. nerves | 3. sensory | 4. network | 5. voluntary | 6. digestion Points: 3
Hệ thống đọc file như thế nào?
- ✓Chỉ nhận tệp .docx; nếu không đúng định dạng sẽ báo lỗi ngay.
- ✓Parser nhận 3 nhóm chính:
[MCQ],[SHORT],[FIB]hoặc khối Fill in each blank.... - ✓Mỗi câu phải có Question; trắc nghiệm phải có ít nhất 2 lựa chọn và dòng Answer:.
- ✓Hệ thống tự bỏ qua câu trùng nội dung + đáp án đã có trong đề.
- ✓Giảng viên nên ghi Points: rõ ràng để thang điểm không bị lệch sau import.
Giảng viên: đăng nhập & vào dashboard
Bắt đầu phiên quản trị an toàn
Bước 1. Đăng nhập giảng viên
Quản trị danh sách đề đang có
Review / sửa / xóa trước khi dùng
Buộc nộp · chặn · gia hạn
Giảng viên: tạo đề, chọn rule, đặt thời gian
Các thông số nên khóa kỹ trước khi cho sinh viên vào làm
Bước 2. Tạo kỳ thi và cấu hình rule
class_rules_json, nhập rule cho từng lớp, ví dụ: {{"Y3A":{{"num_mcq":20,"num_short":2}},"DEFAULT":{{"num_mcq":15,"num_short":1}}}}.Giảng viên: import, review và kiểm tra chất lượng đề
Tập trung phát hiện lỗi trước khi mở đề chính thức
Bước 3. Import bộ câu hỏi kèm đáp án
Giảng viên: sửa câu hỏi, đáp án và thời gian từng câu
Nơi tinh chỉnh chất lượng đề ở mức chi tiết nhất
Bước 4. Sửa câu hỏi và chỉnh thời gian từng câu
Thời gian hệ thống tự ước tính khoảng 45–60 giây.
Tự ước tính khoảng 60–90 giây.
Tự ước tính khoảng 90–180 giây.
Chỉ tăng thời gian riêng cho các câu dài, tránh tăng toàn bộ đề một cách không cần thiết.
Giảng viên: monitor, chat, buộc nộp, chặn thi
Trung tâm xử lý tình huống trực tiếp trong ca thi
Bước 5. Quan sát sinh viên và xử lý trong lúc thi
Question 12 · The nervous system transmits...
signals | nerves | sensory ...
{action_chip('Buộc nộp','red')} {action_chip('Chặn','yellow')} {action_chip('Gia hạn 30 phút','green')}
Giảng viên: chấm bài và xuất Excel
Hoàn tất hậu kiểm và lưu hồ sơ điểm
Bước 6. Chấm bài, chấm tự luận và xuất kết quả
Phân tích nguyên nhân sâu xa dẫn đến cách mạng xã hội...
The nervous system transmits ______ between...
Giảng viên: bảng quyết định xử lý nhanh
Dùng đúng hành động để giữ tính toàn vẹn dữ liệu
Tác vụ quản trị nhanh sau khi đề đã chạy
ends_at của attempt hiện tạiSinh viên: đăng nhập & nhập thông tin
Bước chuẩn hóa thông tin trước khi vào đề
Sinh viên – Bước 1. Đăng nhập và nhập thông tin dự thi
Sinh viên: chọn đề thi và bắt đầu phiên làm bài
Xác thực đúng đề, đúng lớp, đúng giảng viên
Sinh viên – Bước 2. Chọn giảng viên, chọn đề và vào làm bài
Sinh viên: thao tác trong màn hình làm bài
Trọng tâm là trả lời đúng câu hiện tại và giữ phiên thi ổn định
Sinh viên – Bước 3. Làm bài theo từng câu
Sinh viên: chat, nộp bài, xem kết quả
Hoàn tất bài thi và tự kiểm tra kết quả
Sinh viên – Bước 4. Trả lời tin nhắn, nộp bài và xem kết quả
26 / 30
2 câu · đã chấm 1
Xử lý sự cố & checklist vận hành
Trang tham chiếu nhanh trước, trong và sau ca thi
Khắc phục lỗi thường gặp
Checklist trước giờ thi cho giảng viên
- ✓Đã mở đúng đề, đúng giờ, đúng bộ môn.
- ✓Đã import và review xong toàn bộ câu hỏi.
- ✓Đã thử ít nhất 1 câu MCQ và 1 câu FIB/Tự luận.
- ✓Đã thống nhất mật khẩu đề với lớp.
Checklist trước giờ thi cho sinh viên
- ✓Dùng 1 thiết bị duy nhất, pin/mạng ổn định.
- ✓Đăng nhập đúng email Google cá nhân được phép dùng.
- ✓Không mở ứng dụng chụp màn hình / chuyển tab trong lúc thi.
- ✓Đọc kỹ nút “Khóa câu này và sang câu tiếp”.
Phụ lục thao tác nhanh
Bản đồ route & ghi nhớ cho tổ chức thi
Phụ lục A – Bản đồ màn hình chính
- •/admin/login – đăng nhập giảng viên
- •/admin/dashboard – tạo đề, quản lý câu hỏi, lượt thi
- •/admin/exams/<id>/review – review câu hỏi
- •/admin/questions/<id> – sửa chi tiết câu hỏi
- •/admin/attempt/<id>/monitor – giám sát trực tiếp
- •/admin/attempt/<id>/grade – chấm tự luận/điền từ
- •/student/info – khai báo thông tin sinh viên
- •/student/exam/start – chọn giảng viên / chọn đề / nhập mật khẩu
- •/student/exam/<attempt_id> – làm bài thi
- •/student/result/<attempt_id> – xem kết quả
Phụ lục B – Ghi nhớ cho tổ coi thi
Ưu tiên dùng chat riêng trong monitor; tránh yêu cầu sinh viên đổi thiết bị giữa chừng nếu chưa reset attempt.
Dùng Reset lượt thi, sau đó yêu cầu sinh viên vào lại cổng thi từ đầu và nhập lại mật khẩu đề.
Đóng đề, chỉnh câu trong màn hình chi tiết hoặc clone đề mới. Không sửa trực tiếp nếu đề đã có dữ liệu thật.
Trang kết
Tài liệu hướng dẫn sử dụng Exam Support App CTUMP
Hoàn tất bộ tài liệu CTUMP 2026
Tài liệu này được đóng gói để dùng theo 2 cách: PDF cho lưu trữ/in ấn và ebook flipbook HTML cho tra cứu nhanh trên trình duyệt.