AI-CLO PTITHCM V12.6 — Shared Question Bank + Mixed Random Assessment

Phạm vi

V12.6 tập trung vào hai thay đổi lớn:

1. thêm loại rút đề Cố định và rút ngẫu nhiên;
2. hoàn thiện Assessment để nhiều học phần/lớp có thể dùng chung một Question Bank.

V12.6.1 — Mixed fixed + random

Mode mới:

mixed_fixed_random

Quy tắc:

• giảng viên chọn ít nhất 1 câu cố định;
• câu cố định tiêu thụ quota đúng ô Chương/Mục × CLO;
• sau đó rút phần còn lại;
• phần random không hiển thị câu cụ thể trong Builder;
• lưu ID câu cố định tại question_blueprint.fixed_question_ids.

V12.6.2 — Frontend compatibility bridge

Thêm:

js/core/question-bank-ownership.js

Mục tiêu: chuyển các truy vấn legacy của chapters, clos, questions từ phạm vi subject_id sang question_bank_id khi học phần dùng ngân hàng chung.

V12.6.3 — Legacy subject compatibility for questions

Migration:

supabase/migrations/v12.6.3-question-bank-legacy-subject.sql

Lý do: schema cũ còn foreign key ghép buộc questions.subject_id phải khớp Chapter/CLO nguồn.

Cách xử lý:

• giữ question_bank_id là ownership thật;
• tự chuẩn hóa questions.subject_id legacy trước INSERT/UPDATE;
• không tháo FK và không xóa dữ liệu.

V12.6.4 — Assessment bank scope

Migration:

supabase/migrations/assessment-v12.6.4-question-bank-scope.sql

Sửa backend:

• replace_exam_design() xác thực online pool bằng question_bank_id của subject;
• save_final_exam_package() xác thực secure pool bằng question_bank_id;
• không còn giả định câu hỏi phải có cùng subject_id với lớp đang mở.

Các ràng buộc bảo mật/nghiệp vụ vẫn giữ:

• online: status='active', approval_status='approved', scope practice|both;
• final exam: status='active', approval_status='approved', scope secure_exam|both.

Kiến trúc được chốt

Câu hỏi thuộc Question Bank. Bài kiểm tra thuộc Subject/Học phần.

Một ngân hàng có thể được nhiều lớp/học phần sử dụng mà không nhân bản câu hỏi.

Checklist deploy

Trên Supabase cần chạy theo thứ tự:

1. v12.6.3-question-bank-legacy-subject.sql
2. assessment-v12.6.4-question-bank-scope.sql

Sau đó test:

• lưu câu thủ công/Gemini ở lớp dùng chung bank;
• tạo online assessment cả 4 mode;
• tạo final exam từ secure bank;
• sinh lượt làm và kiểm tra kết quả CLO đúng học phần.

Trạng thái

V12.6.x đang ở giai đoạn kiểm thử tích hợp. Chỉ coi là stable sau khi các kịch bản trên đều đạt.