Assessment nâng cao
Assessment gồm hai nhánh lớn: quiz/question bank và assignment/submission/rubric/grading.
Quiz và question bank
| Thành phần | File/khái niệm | Vai trò |
|---|---|---|
| Quiz CRUD | QuizControllerV3, QuizManagementUseCase |
Tạo/sửa/publish quiz |
| Attempt | QuizAttemptUseCase |
Student bắt đầu, lưu đáp án, submit |
| Question bank | QuestionControllerV3, QuestionImportExportUseCase |
Ngân hàng câu hỏi, import/export |
| DOCX preview | /api/v3/questions/import/docx/preview |
Preview trước khi lưu câu hỏi import |
| DOCX confirm | /api/v3/questions/import/docx/confirm |
Chỉ lưu sau khi user xác nhận |
Assignment và grading
| Thành phần | File/khái niệm | Vai trò |
|---|---|---|
| Assignment | AssignmentControllerV3 |
Tạo bài tập |
| Submission | AssignmentSubmissionControllerV3 |
Student nộp bài, teacher xem |
| Rubric | RubricControllerV3, rubric-editor.component.ts |
Tiêu chí chấm điểm |
| Grade | GradeSubmissionUseCase |
Teacher chấm bài |
| Audit | V101__grading_audit_log.sql |
Lưu lịch sử chấm/sửa điểm |
| Attachment | assignment/submission attachment tables | File đính kèm |
Ranh giới an toàn với Wiii
- Wiii có thể giúp tạo draft quiz hoặc preview quiz commit.
- LMS phải hiển thị preview/diff trước khi apply.
- Không để Wiii tự submit quiz, publish quiz, grade submission, delete question hoặc mutate điểm trực tiếp.
- Action apply cần
preview_tokenvà approval từ host/user.
Câu hỏi hay gặp
Vì sao import DOCX cần preview?
Vì nội dung AI/parser có thể sai format, thiếu đáp án hoặc mapping sai loại câu hỏi. Preview giúp teacher kiểm tra trước khi dữ liệu đi vào question bank.
Vì sao grade cần audit?
Điểm ảnh hưởng kết quả học. Audit log giúp truy vết ai chấm, lúc nào, thay đổi gì.