Ngân hàng câu hỏi Canvas — Trường TH, THCS & THPT Ngôi Sao Hoàng Mai
Công cụ web giúp giáo viên đưa câu hỏi từ file Word / Excel theo mẫu của trường, đề Word thông thường (đánh số
câu, kèm file đáp án / hướng dẫn chấm riêng) và gói SCORM do skill tao-de-scorm tạo vào Canvas của trường
(https://4015.instructure.com) bằng một lần import gói QTI 1.2 (.zip), thay cho việc gõ tay từng câu.
- Đọc đủ 10 loại câu: một đáp án, nhiều đáp án, Đúng/Sai nhiều ý (kiểu THPT 2025), trả lời ngắn, điền số,
điền khuyết, chọn từ danh sách, ghép nối, tự luận, đoạn thông tin.
- Giữ công thức (Office Math trong Word,
$LaTeX$ trong Excel/Word → MathML), ảnh, bảng, đoạn dẫn, lời giải.
- File đáp án riêng (HDC / KEY / ĐÁP ÁN, kể cả bảng THPT 2025 Phần I/II/III): nạp cùng file đề → tự ghép theo tên
file và điền đáp án cho câu còn thiếu; câu đã có đáp án khác thì giữ đáp án trong đề và cảnh báo.
- Kiểm tra từng câu trước khi xuất (thiếu đáp án, thiếu ảnh, công thức MathType cũ, ô Excel bị đổi thành ngày…) và
chỉ rõ dòng/câu cần sửa.
- Xuất gói cho Item Bank (New Quizzes) — mặc định, vì trường dùng New Quizzes — hoặc Question Bank (Classic).
- Tuỳ chọn: gửi thẳng lên Canvas qua API — vào Question Bank (Classic), hoặc để Canvas chuyển thành một New Quiz
khi nhập (cần máy chủ trung gian trên Vercel và Developer Key do quản trị Canvas tạo).
HTML/JS thuần, không build, không npm, không thư viện ngoài. Mọi xử lý file chạy ngay trong trình duyệt
của giáo viên — đề thi không gửi đi đâu (trừ khi bấm "Gửi thẳng lên Canvas").
Cập nhật 2026-10-02
- Word: đọc đề thông thường (câu đánh số trần, nhóm "Questions 1-6" / "từ câu 18 đến 22", tiêu đề mục, câu trong
bảng, đáp án tô vàng / trong ngoặc), mẫu "upload câu hỏi" (
[OC-NB], ANSWER: A=30…, [EM]), và file đáp án riêng
(HDC / KEY / Đáp án) tự ghép với file đề rồi điền đáp án còn thiếu.
- Excel: hiện ngày / phần trăm / phân số đúng như Excel; ô
1/2, 8/3 bị Excel đổi thành ngày → lỗi nêu ô và
cách sửa; cảnh báo text box / biểu đồ / dòng ẩn. Mẫu Excel: cột A…H và Đáp án định dạng Text, ảnh ví dụ đi theo ô;
mẫu Word dự phòng font Arial.
- Gói QTI: phương án / vế trái / lời giải chỉ có chữ chứa
& < > xuất text/plain (trước đây học sinh thấy
nguyên <); HTML còn mã nguy hiểm được làm sạch lại trước khi xuất; MathML lọc style, bỏ script trong MathML.
- Soát câu: câu có đề nằm hẳn trong đoạn dẫn (câu điền bài đọc) không còn báo "nội dung trống"; xuất với
"Không chèn đoạn dẫn" thì cảnh báo câu đó.
- Gửi thẳng lên Canvas: thêm đích Chuyển sang New Quizzes khi nhập (
import_quizzes_next); liên kết về trang
Canvas của trường; tối thiểu 10 scope.
- Bảo mật máy chủ: PKCE S256, cookie
__Host-, đăng xuất chỉ POST, op=upload chỉ chuyển tiếp cho lần nhập thật
của chính người dùng, chặn as_user_id/access_token/_method; server.js chặn tên ngắn 8.3 (/ENV~1 từng đọc
được .env) và kiểm Host; sandbox SCORM chặt hơn.
- Quản trị cần làm lại: Developer Key bật Allow Include Parameters, chọn đúng 10 scope (bảng dưới), đặt
APP_URL.
- Kiểm thử: 19/19 file test; đầu-cuối 58 nguồn, 455 gói, 17 762 phép chấm, 0 lỗi; bộ mô phỏng Canvas (
CANVAS_SIM)
59 nguồn, 474 lượt import, 18 094 phép chấm, 0 sai khác chưa giải thích; bộ kiểm tra QTI thêm luật html-escaped-text.
Cách dùng
1. Mở công cụ
| Cách | Làm gì | Có "Gửi thẳng lên Canvas"? |
|---|
| Mở trực tiếp | Nhấp đúp index.html (Chrome / Edge / Safari mới) | Không |
| Chạy trên máy | node server.js rồi mở http://localhost:8787 (Node ≥ 18) | Có, nếu có file .env |
| Trên web | Deploy lên Vercel (xem dưới) | Có, nếu đặt biến môi trường |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
