Appearance
Quản lý học viên trong lớp
Tab Học viên trong trang chi tiết lớp là điểm trung tâm để theo dõi từng học viên — bạn nhìn được tỉ lệ điểm danh, tiến độ từng khoá song song, và launch các action cá nhân hoá (override, catch-up).
Một dòng tóm tắt
Mở Lớp của tôi, chọn lớp, mở tab Học viên: bảng tất cả học viên trong lớp với cột tỉ lệ điểm danh và cột tiến độ cho mỗi khoá thuộc Program. Bấm tên để xem nhanh hồ sơ; cuối mỗi dòng có nút Đánh giá năng lực, Tùy chỉnh hoạt động, Kế hoạch bắt kịp.
Vào tab Học viên
- Sidebar trái → Lớp của tôi.
- Click một lớp → trang chi tiết lớp mở.
- Click tab Học viên (icon nhóm người).
URL state lưu tab đang mở qua ?tab=... — chia sẻ link giữ đúng tab.
Bố cục bảng
Các cột mặc định
| Cột | Nguồn dữ liệu | Mô tả |
|---|---|---|
| Họ tên | users.first_name + users.last_name | Có thể tìm kiếm |
users.email | Có thể bật/tắt qua toggle | |
| Trạng thái | Trạng thái ghi danh trong lớp | Nhãn màu: Đang học, Tạm dừng, Đã chuyển lớp, Đã thôi học, Hoàn tất |
| Tỉ lệ điểm danh | AttendanceReportService::batchSummary() | % theo công thức (Present + Late) / sessions held |
| (mỗi khoá thuộc Program) | enrollments.progress | % hoàn thành tiến độ khoá đó |
Mã màu
Tỉ lệ điểm danh
| Khoảng | Màu | Ý nghĩa |
|---|---|---|
| ≥ 85% | Xanh (success) | Tốt |
| 70%–84% | Vàng (warning) | Khá |
| < 70% | Đỏ (danger) | Cần lưu ý — at-risk threshold |
| Không có dữ liệu | Xám | Chưa có buổi nào diễn ra / chưa attach |
Tiến độ khoá
| Khoảng | Màu |
|---|---|
| ≥ 100% | Xanh — đã hoàn thành |
| 50%–99% | Vàng — đang học |
| < 50% | Đỏ — chậm |
| Chưa enroll | Xám với dấu - |
Đọc nhanh bảng
- Hàng có nhiều ô đỏ → học viên cần can thiệp toàn diện.
- Một cột nhiều ô đỏ → khoá đó quá khó hoặc chưa được giới thiệu đủ.
- Tỉ lệ điểm danh đỏ + tiến độ khoá xanh → học viên tự học rất tốt nhưng vắng buổi → có thể họ đi làm / khác múi giờ; cân nhắc record buổi.
- Tỉ lệ điểm danh xanh + tiến độ khoá đỏ → học viên có mặt nhưng không làm bài → can thiệp về động lực, không phải nội dung.
Tìm kiếm & sắp xếp
Tìm kiếm
Ô tìm kiếm ở góc phải bảng — search trên first_name, last_name, email đồng thời.
Sắp xếp
Click tiêu đề cột → sort. Mỗi cột có thể sort tăng/giảm:
- Họ tên — alphabet.
- Email — alphabet.
- Tỉ lệ điểm danh — số.
- Mỗi cột khoá — % tiến độ.
Toggle ẩn/hiện cột
Mặc định hiện 3 cột chính + tất cả khoá. Email toggle được. Bạn có thể ẩn các cột khoá không cần để tập trung — không ảnh hưởng người khác.
Nút thao tác (mỗi dòng)
Cuối mỗi dòng học viên có các nút:
1. Đánh giá năng lực
Mở lịch sử các đợt đánh giá năng lực của học viên trong lớp này.
2. Tùy chỉnh hoạt động
Mở trang Override cho học viên đó.
3. Kế hoạch bắt kịp
Mở trang Catch-up Plan cho học viên đó.
Nút chỉ hiện khi đủ quyền
Tùy chỉnh hoạt động và Kế hoạch bắt kịp chỉ hiện với tài khoản được cấp quyền tương ứng. Trợ giảng thường không thấy hai nút này: vẫn xem được bảng, nhưng để can thiệp cá nhân hoá phải nhờ giảng viên chính.
Xem hồ sơ một học viên
Có hai mức xem: hộp xem nhanh ngay trong lớp, và trang Hồ sơ học tập đầy đủ.
Hộp xem nhanh
Bấm Họ tên của học viên trong bảng. Một hộp thoại mở ra, tiêu đề là họ tên học viên, gồm các phần:
- Hồ sơ: Email, Số điện thoại. Nếu học viên đã có hồ sơ học viên của trung tâm thì thêm Mã học viên, Trạng thái học vụ, Ngày nhập học, Ngày sinh, Địa chỉ; Số CCCD và Ngày cấp CCCD chỉ hiện với người được phép xem.
- Trong lớp này: Trạng thái ghi danh, Ngày tham gia (thêm Ngày rời lớp, Lý do rời lớp nếu học viên đã rời), Tỉ lệ điểm danh, Buổi tham dự (số buổi có mặt trên số buổi đã diễn ra), Chuỗi điểm danh (hiện tại / dài nhất), Điểm tổng kết (khi lớp có cột điểm và học viên đã có điểm).
- Tiến độ khoá học: % hoàn thành từng khoá thuộc chương trình của lớp.
- Nhật ký lớp có nhắc đến học viên: 5 nhật ký gần nhất có @nhắc tên học viên này, xem Nhật ký lớp.
Cuối hộp có nút Hồ sơ học tập để mở trang đầy đủ, và nút Đóng.
Trang Hồ sơ học tập
Trang đầy đủ về một học viên, mở từ nút Hồ sơ học tập trong hộp xem nhanh (đường dẫn dạng /trainer/learning-profile/{id}). Bạn chỉ mở được hồ sơ của học viên thuộc lớp mình phụ trách.
- Đầu trang: ảnh đại diện, họ tên, vai trò, email và số điện thoại, ngày Tham gia, Truy cập gần nhất, Học gần nhất, và nhãn cho biết học viên còn đang trong một lớp hoặc khoá còn hạn hay không.
- Các khối bên dưới, mỗi khối chỉ hiện khi học viên có dữ liệu tương ứng và tổ chức bật tính năng đó, ví dụ: Tổng quan học tập, Nhịp hoạt động 12 tháng, Khoá học ghi danh, Học viên trung tâm, Thi cử, Gamification (điểm, chuỗi ngày học, huy hiệu gần đây), Năng lực, Ôn tập ngắt quãng, Lộ trình học tập, Luyện tập, Chứng chỉ, Sự kiện, Yêu cầu học vụ, Hoạt động cộng đồng.
Các khối về tiền (Tín dụng AI, Đơn hàng, Gói thuê bao) chỉ hiện với người có quyền xem hồ sơ học tập của mọi người dùng (thường là quản trị viên), không hiện với giảng viên chỉ phụ trách lớp.
Học viên không có trang hồ sơ công khai
Hệ thống không có trang hồ sơ để học viên xem lẫn nhau. Hộp xem nhanh và trang Hồ sơ học tập chỉ dành cho đội ngũ giảng dạy và quản trị. Giảng viên của lớp khác không mở được hồ sơ học tập của học viên không thuộc lớp mình.
Học viên cần lưu ý (at-risk)
Bảng này không tự highlight at-risk — bạn dùng widget Học viên cần lưu ý ở trang chủ Trainer Panel để có danh sách tổng hợp xuyên lớp.
Tuy nhiên, mã màu cột Tỉ lệ điểm danh + cột tiến độ giúp bạn nhanh chóng phát hiện at-risk trong một lớp cụ thể — đặc biệt khi sort tăng dần theo tỉ lệ điểm danh.
Quy trình nhận diện at-risk hằng tuần
- Mở tab Học viên, sort theo Tỉ lệ điểm danh tăng dần.
- 3 đến 5 hàng đầu là nhóm cần lưu ý.
- Bấm vào tên để mở hộp xem nhanh, đọc phần Trong lớp này (tỉ lệ điểm danh, số buổi tham dự, chuỗi điểm danh). Muốn xem từng buổi, mở trang Điểm danh của các buổi học.
- Quyết định:
- Liên hệ: gửi email, nhắn tin, gọi điện ngoài hệ thống.
- Comment trên activity đang dở để nhắc nhở nhẹ (qua Tiến độ khoá học).
- Catch-up plan: nếu vẫn theo được nhưng chậm.
- Override Ẩn: nếu phần đó đã thành thạo hoặc có chứng chỉ ngoài.
- Ghi vào Nhật ký lớp với @mention học viên để giảng viên khác xem cùng. Lưu ý học viên được nhắc tên thấy khoảng 90 ký tự đầu của nhật ký, xem Nhật ký lớp.
Học viên đăng ký nhiều khoá song song
Lớp có nhiều khoá thuộc Program → mỗi cột khoá hiện độc lập:
- Học viên có thể đăng ký một số khoá, không phải tất cả → cột đó hiện
-xám. - Nếu Program yêu cầu thứ tự khoá (curriculum sequencing), thường khoá tiếp theo bị lock đến khi xong khoá trước.
Khoá pivot trong Program
Cột khoá lấy từ program.courses (đã orderByPivot('order')). Nếu Tenant Admin đổi Program của lớp giữa chừng, các cột khoá có thể đổi → tiến độ cũ không mất nhưng cột mới hiện cho khoá mới (chưa enroll thì xám).
Khi học viên rời lớp
Quản trị viên có hai cách đưa học viên ra khỏi lớp, và tab Học viên phản ánh khác nhau:
- Đổi trạng thái (các nút Chuyển lớp, Tạm dừng, Cho thôi học, Hoàn tất ở trang lớp của quản trị): học viên vẫn nằm trong bảng, cột Trạng thái đổi sang Đã chuyển lớp, Tạm dừng, Đã thôi học hoặc Hoàn tất. Dùng bộ lọc Trạng thái của bảng để chỉ xem người Đang học. Tỉ lệ điểm danh của lớp chỉ tính học viên đang học. Tạm dừng thì quản trị viên bấm Khôi phục để đưa học viên về Đang học.
- Tách học viên khỏi lớp: học viên biến mất khỏi bảng ngay. Bản ghi điểm danh và tiến độ khoá không bị xoá; nếu học viên được thêm lại vào lớp, dữ liệu cũ hiện lại.
Với nhật ký lớp: nhật ký đã @nhắc tên học viên vẫn giữ nguyên. Học viên đã bị tách không còn xuất hiện trong gợi ý khi gõ @; học viên chỉ đổi trạng thái thì vẫn còn.
So sánh: Tab Học viên vs Tiến độ khoá học vs At-Risk widget
| Tab Học viên | Tiến độ khoá học | At-Risk widget | |
|---|---|---|---|
| Phạm vi | Một lớp | Một (lớp × khoá) | Tất cả lớp của bạn |
| Đơn vị hàng | Học viên | Học viên | Học viên × Lớp |
| Đơn vị cột | Khoá học (% tổng) | Activity (% từng bài) | (chỉ hiện rate + lý do) |
| Xem sâu | Hộp xem nhanh, rồi Hồ sơ học tập | Timeline activity | Lớp tương ứng |
| Thao tác | Đánh giá năng lực / Override / Catch-up | Comment | Bấm để mở lớp |
| Khi nào dùng | Quản lý chung lớp | Theo dõi chi tiết một khoá | Quét at-risk hằng ngày |
Ba tab/trang này bổ sung cho nhau — không thay thế.
Câu hỏi thường gặp
Tôi không thấy tỉ lệ điểm danh — cột hiện - cho tất cả? Lớp chưa có buổi nào ở trạng thái Live hoặc Completed. Buổi Scheduled không được tính vào mẫu số. Sau khi diễn ra ≥ 1 buổi, cột sẽ có dữ liệu.
Tiến độ khoá hiện 0% nhưng học viên đã làm vài bài?
- Refresh trang.
- Kiểm tra: học viên có đúng là đã enroll khoá đó? (dấu
-= chưa enroll,0%= đã enroll nhưng chưa làm xong activity nào). - Tiến độ tính theo activity hoàn thành / activity bắt buộc — vd: học viên làm Reading nhưng chưa nộp summary → activity chưa "complete" → 0%.
Tôi có thể export bảng thành CSV? Trainer Panel hiện chưa có nút export ở tab Học viên. Tenant Admin có BatchStudentExportService để export — nhờ admin nếu cần file.
Học viên thay đổi tên — bảng hiển thị khi nào cập nhật? Bảng đọc trực tiếp từ users table → cập nhật ngay khi học viên save profile. Refresh trang để thấy.
Search bằng email không tìm ra dù tôi gõ đúng?
- Search dùng
LIKE '%query%'→ gõ một phần email cũng được. - Email có thể đã đổi gần đây và bạn đang nhìn cache UI cũ → reload.
Có thể bulk action cho nhiều học viên cùng lúc? Hiện chưa có. Mỗi học viên xử lý riêng qua action menu. Nếu cần override / catch-up cho nhiều người cùng lúc, bạn lặp action — hoặc đề xuất Tenant Admin batch update qua tool admin.
Tab Học viên không hiện trong Trainer Panel của tôi? Trợ giảng vẫn xem được tab Học viên mặc định. Nếu không thấy, kiểm tra với Tenant Admin xem cấu hình quyền tài khoản đã đúng chưa.