Appearance
Chấm điểm & Feedback
Trang này giải thích các cơ chế chấm điểm trong hệ thống và những gì trainer làm được vs không trong Trainer Panel.
Một dòng tóm tắt
Hệ thống có 4 cơ chế chấm: tự động (Quiz, Code Practicing — qua test cases/đáp án), AI (Assignment, Reading summary), chấm lại bởi giảng viên (bạn đặt điểm, đè lên điểm AI), và ghi chú trainer (không phải điểm). Bạn chấm lại ngay trong bảng Tiến độ khoá học — không cần Tenant Admin.
Trang này đã đổi
Trước đây Trainer Panel không có cách nào sửa điểm AI, và trang này mô tả một quy trình tạm: comment rồi nhờ Tenant Admin sửa thẳng dữ liệu. Quy trình đó không còn cần thiết — xem Chấm lại điểm AI bên dưới.
Bốn cơ chế chấm điểm
1. Tự động (deterministic)
Áp dụng cho activity có đáp án xác định:
| Activity | Cách chấm | Ai cấu hình đáp án |
|---|---|---|
| Quiz | So sánh đáp án chọn với is_correct của choice | Giảng viên / course_manager |
| Code Practicing | Run code với test cases → so output với expected | Giảng viên / course_manager |
| Examination | Như Quiz nhưng pool random | Tenant Admin / course_manager |
| Blockly / Blockly Game | Output match / block count / structure | Giảng viên |
Trainer không can thiệp vào kết quả — đáp án cố định, hệ thống chấm. Nếu phát hiện đề sai, trainer báo Tenant Admin sửa đáp án; sau đó admin có thể chấm lại cho cả lớp.
2. AI grading
Áp dụng cho activity có đầu ra mở (free-form):
| Activity | Cách chấm | Trigger |
|---|---|---|
| Assignment (text/link/file) | AI đọc submission + đối chiếu grading_criteria + grading_instructions | Học viên submit → AI chấm tự động (nếu giảng viên bật grading_enabled) |
| Reading summary | AI đọc tóm tắt + chấm độ chính xác / đầy đủ / diễn đạt | Học viên submit summary |
| Code Inspection | AI chấm theo evaluation_criteria qua hội thoại | Khi đạt mục tiêu / hết max_turns / học viên kết thúc |
| Dialogue | AI chấm đối thoại theo evaluation_criteria | Khi đạt mục tiêu / hết max_turns |
AI grading tốn AI Credit (do tenant cấu hình Feature Cost). Trainer không trigger AI chấm — học viên submit là tự động chạy.
3. Chấm lại bởi giảng viên
Áp dụng cho Bài tập và Bài đọc có tóm tắt — hai loại hoạt động mang điểm mở. Bạn nhập điểm + nhận xét ngay trong slide-over của Tiến độ khoá học, và điểm của bạn thay thế điểm AI trên màn hình học viên.
Xem chi tiết ở Chấm lại điểm AI.
4. Ghi chú trainer (không phải điểm)
Trainer để lại ghi chú trên cell trong Tiến độ khoá học — ghi chú không thay đổi điểm, chỉ:
- Gửi thông báo (chuông trong app) cho học viên.
- Lưu trong timeline hoạt động, cho bạn và các trainer khác cùng lớp đọc.
Đây là kênh feedback định tính. Muốn đổi con số thì dùng cơ chế 3, không phải cơ chế này.
Chấm lại điểm AI
Khi nào bạn cần
- AI chấm sai. Nó đọc nhầm, bỏ sót phần hay nhất của bài, hoặc áp tiêu chí quá cứng.
- AI không đọc được bài nộp. Bài tập nộp bằng link mà kho GitHub để riêng tư, trang bị chặn đăng nhập, tệp hỏng. Khi đó hệ thống không cho điểm — nó chuyển bài sang trạng thái chờ giảng viên chấm thay vì đoán một con số.
- Hoạt động không bật chấm AI. Bạn vẫn đặt được điểm cho bài tập và bài đọc.
Các bước
- Mở Tiến độ khoá học của lớp → click vào ô của học viên.
- Đọc bài nộp trong slide-over (văn bản, link, tệp tải về, cùng nhận xét AI nếu có).
- Kéo xuống khối Chấm lại điểm:
- Điểm — điền sẵn điểm đang hiệu lực, sửa lại. Ô rỗng nghĩa là chưa ai chấm.
- Nhận xét cho học viên — học viên sẽ đọc câu này, nên viết lý do, đừng chỉ đổi số.
- Nhấn Lưu điểm.
Điều gì xảy ra sau đó
| Học viên thấy | Điểm của bạn, kèm nhãn "Điểm do giảng viên chấm" và tên bạn. Điểm AI biến mất khỏi màn hình của họ. |
| Trạng thái chờ chấm | Tắt — badge "Cần chấm" trên ma trận biến mất. |
| Nếu điểm đạt | Hoạt động được đánh dấu hoàn thành, mở khoá bài tiếp theo. |
| Nếu bạn hạ điểm | Hoạt động vẫn hoàn thành nếu trước đó đã hoàn thành. |
| Timeline | Thêm một mốc "Giảng viên … đã chấm lại" — không tính là một lần làm bài. |
Hạ điểm không thu hồi trạng thái hoàn thành
Cố ý. Một lần hoàn thành có thể đã mở khoá các bài sau và tính vào chứng chỉ — thu hồi nó biến một lần sửa điểm thành cả chuỗi hệ quả. Con số trong sổ điểm chính là phần chỉnh sửa.
Nếu bạn thật sự cần chặn học viên đi tiếp, hãy dùng Tùy chỉnh hoạt động hoặc trao đổi trực tiếp.
Điểm AI không bị xoá
Nó vẫn được giữ trong dữ liệu bên cạnh điểm của bạn — để tổ chức đối chiếu về sau xem AI hay bị sửa ở đâu. Chỉ học viên là thấy đúng một điểm: điểm của bạn.
Học viên nộp lại thì sao?
Nộp lại xoá cả điểm AI lẫn điểm của bạn — điểm cũ là phán xét về bài cũ. Hệ thống chấm lại từ đầu.
Nếu học viên nộp lại trong lúc bạn đang mở slide-over, nút Lưu sẽ báo "Học viên đã nộp lại…" và nạp bài mới thay vì ghi điểm. Đọc bài mới rồi chấm lại — đây là chủ ý, không phải lỗi.
Ai được chấm lại?
- Giảng viên của lớp — tự động, nhờ quan hệ phân công lớp. Không cần cấp thêm quyền.
- Quản lý đào tạo / Quản trị viên — qua quyền
grade_submission_batch.
Nếu bạn mở được slide-over mà không thấy khối Chấm lại điểm, thường là một trong hai lý do: bạn chưa được phân công dạy lớp đó, hoặc hoạt động đó không mang điểm (video, bài đọc không bật tóm tắt…).
Trainer làm được gì với điểm?
✅ Được phép
- Đọc submission đầy đủ qua timeline drill-down — text, link, file đính kèm, attempts, AI feedback.
- Chấm lại điểm bài tập và bài đọc của học viên trong lớp mình — xem mục trên.
- Ghi chú góp ý — giải thích lý do, gợi ý cải thiện.
- Yêu cầu học viên nộp lại qua ghi chú.
- Ẩn một hoạt động cho học viên đã thành thạo, qua Tùy chỉnh hoạt động.
❌ Vẫn chưa có
- Chấm lại hàng loạt — không có bulk action; mỗi bài một lần.
- Sửa điểm Quiz / bài thi / Code Practicing — những loại này có đáp án xác định. Đề sai thì báo Tenant Admin sửa đáp án rồi chấm lại cho cả lớp.
- Đánh dấu hoàn thành tay cho một hoạt động không mang điểm.
Hàng đợi Bài chờ chấm
Khi AI không cho điểm được một bài nộp, bài đó nằm chờ bạn. Thay vì mở ma trận của từng lớp, bạn xem tất cả ở một chỗ:
- Trainer Panel (
/trainer) → nhóm Đào tạo → Bài chờ chấm. - Bảng liệt kê bài nộp chưa có điểm của mọi lớp bạn phụ trách, cũ nhất ở trên — người chờ lâu nhất được chấm trước.
| Cột | Ý nghĩa |
|---|---|
| Học viên | Người nộp. Tìm kiếm được theo tên. |
| Hoạt động / Khoá học | Bài nào, của khoá nào. |
| Lý do | Vì sao AI không cho điểm: AI không đọc được bài, Hết hạn mức AI, hoặc Chấm AI lỗi. |
| Chờ từ | Thời điểm bài bắt đầu chờ chấm tay. |
- Bấm Mở chấm trên một dòng → mở thẳng ma trận tiến độ của lớp, đúng học viên và đúng hoạt động đó. Chấm như ở mục Chấm lại điểm AI.
Khi chấm xong, bài rời hàng đợi. Bảng trống hiện "Không còn bài nào chờ chấm".
Không thấy nút Mở chấm trên một dòng?
Bài vẫn hiện để bạn biết có người đang chờ, nhưng hệ thống không dựng được đường tới ma trận — thường vì học viên đã rời lớp hoặc khoá đã bị gỡ khỏi chương trình. Báo Quản lý đào tạo.
Quản lý đào tạo có cùng trang này ở /admin (nhóm Đào tạo → Bài chờ chấm), phạm vi toàn tổ chức.
Trường hợp đặc biệt theo loại activity
Bài tập (Assignment)
- Chấm AI — bật ở cấu hình hoạt động; AI đọc bài theo tiêu chí chấm mà người soạn khoá đặt ra.
- Chấm lại bởi giảng viên — luôn có, kể cả khi hoạt động không bật chấm AI.
- Nộp lại — học viên nộp lại bất cứ lúc nào; lần nộp mới thay thế lần cũ và xoá mọi điểm đã có. Không có giới hạn số lần, và không có cơ chế "lấy điểm lần cao nhất" cho bài tập — điểm hiện hành luôn là điểm của lần nộp gần nhất.
Bài nộp bằng ghi âm
Bài luyện nói dùng hình thức nộp Ghi âm: học viên thu ngay trên trang, bạn nghe khi chấm.
- Trong bảng chấm, khối bài nộp hiện nút Nghe bản ghi. Bấm để nạp — bản ghi chỉ được tải khi bạn cần, nên mở bảng vẫn nhanh khi lướt qua nhiều học viên.
- Nút tải bản ghi về máy vẫn nằm ngay dưới trình phát, nếu bạn muốn nghe lại ngoài giờ.
- Nếu hoạt động bật chấm AI, bản ghi được gửi cho AI cùng phần văn bản (nếu có), và AI chấm theo tiêu chí của hoạt động. Đây không phải chấm phát âm chuyên biệt; bạn vẫn nghe lại và chấm lại được như mọi bài tập. Hoạt động không bật chấm AI thì điểm hoàn toàn do bạn đặt.
- Học viên nộp lại thì bản ghi cũ bị thay hẳn; nhận xét chéo viết cho bản trước sẽ được đánh dấu "viết cho bản trước".
Bản ghi nghe được ở mọi máy
Hệ thống tự chuyển bản ghi của Chrome/Firefox (định dạng WebM) sang MP3 khi lưu, nên bạn mở được trên iPhone/iPad và Safari. Không cần yêu cầu học viên dùng trình duyệt nào.
Code Practicing
- Test cases auto — không can thiệp được.
- Hidden test fail mà học viên kêu → trainer xem code, reproduce với test public, tư vấn qua comment.
Quiz
- Auto chấm ngay khi submit.
- Đề sai → báo người soạn khoá / Tenant Admin sửa đáp án. Hiện không có thao tác chấm lại hàng loạt các lượt làm quiz đã nộp; bàn với Tenant Admin cách xử lý cho lớp.
Bài đọc có tóm tắt (Reading summary)
- AI chấm theo độ chính xác so với bài đọc gốc, độ bao quát, và các tiêu chí riêng.
- Chấm lại bởi giảng viên — giống hệt bài tập, cùng khối Chấm lại điểm trong slide-over.
- AI trả về "chưa chấm được" khi bản tóm tắt trống hoặc rõ ràng không liên quan tới bài đọc. Bài yếu thì nhận điểm thấp, không phải trạng thái chờ chấm.
Lập trình Scratch
Bài Scratch không chấm trong slide-over của ma trận mà ở trang riêng trong Learnspace. Giảng viên mặc định có quyền chấm bài Scratch và đưa dự án vào kho mẫu. Hướng dẫn chi tiết nằm ở trang của người soạn khoá:
- Lưới bài làm của lớp — xem bài cả lớp, trình chiếu, chấm tay, rubric tự động, nhận xét AI.
- Bài chờ chấm trên dashboard — widget bài Scratch đang chờ.
- Kho mẫu dùng chung — đưa dự án hay vào kho, dùng mẫu.
Examination
- Trainer không tạo / sửa đề thi (Tenant Admin /
course_manager). - Trainer xem được kết quả học viên qua Lượt thi.
- Bài thi thực hành được gán cho bạn thì bạn chấm ở Bài thực hành cần chấm — xem Chấm bài thi thực hành.
- Override điểm thi trắc nghiệm: hiếm, escalate Tenant Admin.
Mark Complete (đánh dấu hoàn thành)
Cơ chế tự động
Hầu hết activity tự đánh dấu hoàn thành khi đạt điều kiện:
- Quiz pass
passing_score. - Code Practicing pass tất cả test.
- Video xem ≥ % tối thiểu.
- Reading cuộn hết / nộp tóm tắt đạt.
Khi cần "đánh dấu hoàn thành thay học viên"
Vd: học viên đã có chứng chỉ ngoài, đã được kiểm tra miệng, đã thành thạo qua dự án thực tế → muốn unlock các bài tiếp theo mà không bắt làm activity.
Cách hợp lý nhất trong Trainer Panel: dùng Activity Override:
- Mở Tab Học viên → học viên cần xử lý.
- Click Tùy chỉnh hoạt động.
- Đặt activity đó thành Ẩn (Hidden).
- Học viên không thấy activity đó trong khoá → không bị tính chậm.
Khác với "mark complete" thật:
- Ẩn loại activity khỏi tiến độ → tiến độ khoá vẫn lên 100% nếu các bài còn lại làm hết.
- Mark complete thật sẽ cộng vào tiến độ (chưa có UI v1).
Cho phần lớn case, Ẩn = tương đương mark complete về mặt UX (học viên không bận tâm, tiến độ không bị kéo xuống).
Câu hỏi thường gặp
Tôi không thấy khối "Chấm lại điểm" trong slide-over? Hai lý do thường gặp: bạn chưa được phân công dạy lớp đó (quyền chấm đi theo phân công lớp), hoặc hoạt động không mang điểm (video, bài đọc không bật tóm tắt, bài tập chỉ yêu cầu nộp). Khối chỉ hiện với Bài tập và Bài đọc có tóm tắt.
Tôi chấm rồi mà badge "Cần chấm" vẫn còn trên ma trận? Bảng ma trận cố ý không tự nạp lại sau khi bạn chấm — nó phải gửi lại toàn bộ lưới học viên × hoạt động, rất nặng với lớp đông. Tải lại trang là badge biến mất. Slide-over (chỗ bạn vừa chấm) đã hiện điểm mới ngay.
Học viên kêu AI chấm sai liên tục — tôi báo cáo thế nào? Trước mắt cứ chấm lại từng bài, đừng để học viên chờ. Song song, tổng hợp 3–5 ca cụ thể gửi người soạn khoá / quản trị viên: thường phải sửa tiêu chí chấm của chính hoạt động đó, đôi khi là đổi model ở Cài đặt → Trí tuệ nhân tạo → Chấm bài AI.
Tôi muốn cho điểm một bài tập không bật chấm AI? Được. Khối Chấm lại điểm có mặt với mọi Bài tập và Bài đọc có tóm tắt, không phụ thuộc vào việc chấm AI có bật hay không.
Comment của tôi có ảnh hưởng đến tiến độ khoá học không? Không. Comment chỉ là feedback, không cộng/trừ tiến độ.
Tôi muốn cho học viên điểm cộng (bonus) — làm sao? Chưa có cơ chế "điểm thưởng" riêng. Cách gần nhất là chấm lại với con số bạn thấy đúng, và nói rõ trong phần nhận xét vì sao.
Khi tôi comment, học viên có nhận email không? Mặc định chỉ in-app + bell (database channel). Học viên cần mở Learnspace / app để thấy. Email comment cần Tenant Admin bật trong cấu hình Notifications (chưa default v1).
Có thể chia sẻ comment cho cả lớp xem (announcement)? Không. Activity comment là riêng tư giữa trainer + học viên đó (+ trainer khác cùng lớp xem timeline). Để announcement cho cả lớp, dùng bảng tin khoá học (post pinned) hoặc nhắn trong buổi học live.
Hai trainer cùng comment một cell — có conflict? Không. Comments là append-only — mỗi comment có tác giả riêng. Học viên thấy timeline có cả 2.
Comment có rate limit? Không có rate limit cứng. Tự kiểm soát — học viên nhận notification mỗi lần, spam phản tác dụng.
Tôi muốn chấm lại cho cả lớp sau khi sửa đề? Chưa có thao tác hàng loạt — chấm lại là từng bài một. Với lớp đông, cách rẻ hơn là sửa tiêu chí chấm rồi nhờ học viên nộp lại (lần nộp mới được chấm lại từ đầu).