Bắt đầu (Trainer)

Trang này dành cho giảng viên / huấn luyện viên được phân làm trainer cho một hoặc nhiều lớp đào tạo (Batch) trong hệ thống. Trainer Panel là khu vực riêng (URL /trainer) tách biệt với Tenant Admin Panel — bạn chỉ nhìn thấy lớp mình phụ trách + các công cụ giảng dạy chuyên dụng.

Trainer ≠ Tenant Admin

• Tenant Admin quản lý cả tổ chức: tạo Program, Batch, gán trainer, cấu hình AI, billing, …
• Trainer chỉ làm việc với lớp được phân: điểm danh, xem tiến độ học viên, lập kế hoạch bù, ghi nhật ký, …

Một tài khoản có thể vừa là Tenant Admin vừa là Trainer — sẽ thấy cả hai panel.

Điều kiện truy cập

Trang Trainer Panel (/trainer) chỉ cho phép vào khi tài khoản thỏa một trong:

• Tài khoản của bạn được Tenant Admin gán làm trainer cho ít nhất một lớp.
• Module Quản lý đào tạo đang được tổ chức bật. Nếu tắt, panel trả 404.

Nếu không thấy nút / chức năng nào đó trong panel, có thể tài khoản của bạn đang ở vai trò Trợ giảng (giới hạn hơn Trainer chính) hoặc tổ chức cấu hình khác mặc định — liên hệ Tenant Admin để được mở.

Vai trò trong từng lớp

Một lớp có thể có nhiều trainer với 3 vai trò:

Vai trò	Mô tả	Trách nhiệm điển hình
Lead (Giảng viên chính)	Trainer chịu trách nhiệm chính	Lên kế hoạch + dạy chính + đại diện liên lạc với Tenant Admin
Assistant (Trợ giảng)	Hỗ trợ giảng dạy	Điểm danh, chấm bài, bù buổi khi Lead vắng
Mentor	Cố vấn / kèm 1-1	Tư vấn cá nhân hoá, theo dõi at-risk, comment chi tiết bài tập

Vai trò này chỉ nội bộ trong lớp — phân chia trách nhiệm giữa các trainer cùng phụ trách. Mỗi trainer có thể giữ vai trò khác nhau ở các lớp khác nhau (Lead lớp A, Mentor lớp B). Xem Phối hợp đội ngũ giảng viên.

Trainer vs Trợ giảng

Tổ chức có thể tách trainer thành 2 mức:

Chức năng	Trainer	Trợ giảng
Xem lớp được phân	✅	✅
Xem buổi học	✅	✅
Cập nhật thông tin buổi	✅	❌
Điểm danh	✅	✅
Xem & tạo nhật ký lớp	✅	✅
Sửa nhật ký lớp	✅	❌
Bản đồ năng lực lớp	✅	❌
Kế hoạch bắt kịp	✅	❌
Tùy chỉnh hoạt động	✅	❌
Chấm/cập nhật activity	✅	❌
Xem phiên thi học viên	✅	❌

Trợ giảng có panel giống nhưng không thấy nút cho các chức năng giới hạn. Khi cần can thiệp sâu (heatmap, catch-up, override, chấm), Trợ giảng chuyển cho trainer chính.

Đăng nhập & truy cập

1. Đăng nhập tại trang chính của tổ chức (vd: https://truong-cua-ban.lms.example/login).
2. Sau khi đăng nhập, có 2 cách vào Trainer Panel:
   • Từ Learnspace: click avatar (góc phải trên) → Bảng huấn luyện viên. Item này chỉ hiện khi tài khoản đủ điều kiện trainer (xem trên).
   • URL trực tiếp: /trainer — Filament panel với layout, sidebar, top bar riêng (khác Learnspace).

Phiên đăng nhập dùng chung cho Learnspace + Trainer Panel + Tenant Admin Panel — chỉ cần đăng nhập một lần. Đăng xuất ở bất kỳ panel nào sẽ đăng xuất toàn bộ.

Trainer Panel là Filament panel

Khác với Learnspace (Livewire + Preline UI custom), Trainer Panel chạy trên Filament 5 — bạn sẽ thấy giao diện chuẩn Filament: sidebar trái cố định, top bar mảnh, table/form theo phong cách admin. Nếu đã quen với Tenant Admin Panel, Trainer Panel có cảm nhận tương tự nhưng với scope hẹp hơn.

Bố cục Trainer Panel

Thanh điều hướng trái (sidebar)

Sidebar chỉ hiện những mục mà tổ chức đã bật module tương ứng, nên bạn có thể thấy ít mục hơn danh sách dưới đây. Thứ tự nhóm từ trên xuống:

Nhóm Đào tạo:

Mục	Nội dung
Lịch buổi học (/trainer/sessions/calendar)	Lịch tháng các buổi học — xem Buổi học & Điểm danh
Lớp của tôi (/trainer/batches)	Tất cả các lớp bạn được phân
Học viên	Hồ sơ học viên thuộc các lớp bạn phụ trách — chỉ đọc hồ sơ, được ghi chú. Xem Quản lý học viên
Bài chờ chấm	Bài nộp AI không cho điểm được, xuyên mọi lớp — xem Hàng đợi Bài chờ chấm
Buổi học của tôi (/trainer/batch-sessions)	Danh sách buổi học của các lớp bạn phụ trách
Đợt đánh giá năng lực	Đợt đánh giá năng lực định kỳ của lớp — xem Đánh giá năng lực định kỳ
Đơn từ học viên	Đơn của học viên lớp bạn — xem Đơn từ học viên
Khảo sát	Kết quả khảo sát sau khoá học (chỉ xem) — xem Xem phản hồi khảo sát

Nhóm Thực tập (khi tổ chức dùng module thực tập): Duyệt nhật ký thực tập — hàng đợi nhật ký của intern trong lớp bạn phụ trách. Xem Mentor thực tập.

Nhóm Công cụ tương tác:

Mục	Nội dung
Phiên tương tác (/trainer/live-sessions)	Bình chọn, đám mây từ, quiz tính điểm, hỏi đáp — chiếu lên lớp theo thời gian thực. Chỉ liệt kê phiên do bạn điều khiển. Xem Phiên tương tác trực tiếp

Nhóm Quản lý khóa học (chỉ đọc, chỉ khoá của các lớp bạn phụ trách):

Mục	Nội dung
Khóa học	Danh sách khoá trong chương trình của lớp bạn
Ghi danh	Ghi danh của học viên vào các khoá đó

Nhóm Năng lực & Luyện tập: Bộ thẻ flashcard — xem Bộ thẻ ôn tập (Flashcard).

Nhóm Kiểm tra:

Mục	Nội dung
Bài thực hành cần chấm	Bài thi thực hành của các lịch thi bạn được gán chấm; huy hiệu đếm số bài chưa chấm. Xem Chấm bài thi thực hành
Lượt thi	Lượt thi của học viên lớp bạn — xem Lượt thi

Nhóm Sự kiện: Sự kiện (danh sách chỉ đọc) và Điểm danh sự kiện — xem Điểm danh sự kiện.

Trang chủ Trainer Panel (/trainer)

Hiển thị 4 widget tập trung vào công việc giảng dạy:

1. Tổng quan (TrainerStatsOverview)

Bốn ô thống kê:

Ô	Ý nghĩa
Lớp đang hoạt động	Tổng số lớp bạn phụ trách (chưa kết thúc)
Buổi học hôm nay	Số buổi cần dạy hôm nay (đang chờ điểm danh)
Buổi học trong tuần	Tính từ Thứ Hai đến Chủ Nhật
Học viên	Tổng số học viên (distinct) trong các lớp của bạn

2. Buổi học hôm nay

Bảng các buổi học bạn cần dạy hôm nay (starts_at trong khoảng [hôm nay 00:00, hôm nay 23:59]):

• Tên buổi, lớp, giờ bắt đầu, hình thức (online/offline/hybrid).
• Quick action: nút Điểm danh dẫn thẳng vào trang điểm danh của buổi.

Empty state: "Không có buổi học nào hôm nay — Hãy tận hưởng một ngày nghỉ ngơi!"

3. Sắp diễn ra (7 ngày tới)

Bảng các buổi học từ ngày mai đến +7 ngày, sắp xếp theo starts_at tăng dần. Giúp bạn chuẩn bị trước.

4. Học viên cần lưu ý (At-Risk Learners)

Tổng hợp các học viên trong mọi lớp của bạn có dấu hiệu cần can thiệp:

• Tỉ lệ điểm danh < 70%, hoặc
• Vắng ≥ 3 buổi liên tiếp (consecutive_absences)

Mỗi dòng hiển thị: tên + email + lớp + tỉ lệ + lý do (below_threshold / consecutive_absences). Sắp xếp theo độ nghiêm trọng (rate thấp lên đầu). Top 10.

Hành động đề xuất với at-risk

1. Liên hệ trực tiếp tìm hiểu lý do.
2. Mở Bản đồ năng lực xem có yếu kéo dài.
3. Nếu chậm tiến độ → áp Kế hoạch bắt kịp.
4. Nếu đã thành thạo phần đang yếu → Tùy chỉnh hoạt động ẩn phần đó.

Trang Lớp của tôi

Click Lớp của tôi → bảng tất cả lớp bạn phụ trách. Mỗi dòng có:

• Tiêu đề + mã lớp (code).
• Chương trình (Program) — chương trình đào tạo của lớp.
• Số học viên + số buổi học.
• Thời gian (start_date → end_date).
• Trạng thái (Active / Completed / Cancelled).

Click một lớp → mở Trang chi tiết lớp (read-only, không cho Trainer sửa thông tin lớp).

Trang chi tiết lớp

Trang chi tiết lớp có header + tabs:

Header actions

• Bản đồ năng lực — nút mở BatchCompetencyHeatmap (Trợ giảng có thể không thấy).

Các tab

Tab	Nội dung
Thông tin	Metadata lớp: tên, mô tả, chương trình, lộ trình mặc định, ngày bắt đầu/kết thúc, sĩ số tối đa
Khóa học	Danh sách khóa thuộc Program của lớp (read-only). Click một khóa → Tiến độ khóa học cho lớp
Buổi học	Bảng buổi học của lớp — xem Buổi học & Điểm danh
Học viên	Bảng học viên + cột tiến độ từng khóa + 2 action: Tùy chỉnh hoạt động, Kế hoạch bắt kịp (xem Cá nhân hóa)
Nhật ký	Nhật ký lớp với @mention và rich text editor — chỉ trainer của lớp xem được

URL state lưu tab đang mở qua query string ?tab=... — chia sẻ link sẽ giữ đúng tab.

Trang Buổi học của tôi

Bảng tất cả buổi học của các lớp bạn phụ trách (gộp từ nhiều lớp). Phù hợp khi muốn nhìn lịch tổng cá nhân, không cần lọc theo lớp.

Cột chính: tên buổi, lớp, thời gian, hình thức, trạng thái, hành động (Điểm danh / Xem chi tiết).

Quy trình một ngày làm việc của Trainer

Một workflow gợi ý cho lịch làm việc hằng ngày:

1. Sáng — Mở trang chủ Trainer Panel:
   • Kiểm tra widget Buổi học hôm nay: chuẩn bị giáo án, mở phòng họp online sớm.
   • Lướt Học viên cần lưu ý xem có ai mới rơi vào danh sách → cân nhắc liên hệ.
2. Trước buổi học — Click nút Điểm danh trên widget → kiểm tra danh sách lớp, sẵn sàng đánh dấu khi bắt đầu.
3. Trong buổi học — Khi đến giờ, click Bắt đầu buổi học (chuyển status → Live). Điểm danh từng học viên hoặc dùng Đánh dấu tất cả có mặt rồi sửa cá nhân.
4. Sau buổi học — Mở tab Nhật ký của lớp → ghi tóm tắt buổi học, @mention học viên cần chú ý.
5. Định kỳ (1 lần/tuần) — Mở Bản đồ năng lực xem tổng thể; nếu một học viên rõ ràng chậm → lập Kế hoạch bắt kịp.
6. Gần kết thúc lớp — Mở Tiến độ khóa học từng khóa, kiểm tra ai chưa nộp bài tập, gửi nhắc.

Bước tiếp theo

Trang	Khi nào đọc
Buổi học & Điểm danh	Tổ chức buổi học, vòng đời session, điểm danh, báo cáo điểm danh
Quản lý học viên trong lớp	Tab Học viên: filter, sort, action menu, hồ sơ cá nhân
Tiến độ khóa học	Theo dõi học viên hoàn thành activity, comment cho bài nộp
Chấm điểm thủ công	Override điểm AI, chấm assignment, đánh dấu hoàn thành tay
Phiên thi học viên	Xem ExamSession của học viên trong lớp
Nhật ký lớp	Ghi nhật ký nội bộ + @mention
Phiên tương tác trực tiếp	Hỏi cả lớp giữa buổi: bình chọn, đám mây từ, quiz tính điểm, bảng hỏi đáp
Phối hợp đội ngũ giảng viên	Lead/Assistant/Mentor trong batch, cộng tác giữa nhiều trainer
Cá nhân hóa & theo dõi học viên	Heatmap, catch-up, override hoạt động, at-risk learners

Câu hỏi thường gặp

Tôi đăng nhập rồi nhưng không thấy "Cổng giảng viên" trong menu avatar? Tài khoản của bạn chưa được gán làm trainer của lớp nào. Liên hệ Tenant Admin (hoặc super admin) yêu cầu thêm vào bảng batch_trainers cho lớp tương ứng.

Tôi vào /trainer thì bị 403 / 404?

• 403 Forbidden: bạn đã đăng nhập nhưng chưa phải trainer của lớp nào — gặp Tenant Admin để được gán.
• 404 Not Found: module TrainingManagement đang bị tắt trên tổ chức của bạn — gặp Tenant Admin / Central Admin.

Tôi thấy lớp của trainer khác? Không. Trainer Panel chỉ hiển thị lớp được phân cho bạn. Nếu cần xem lớp toàn cục (vd: là teaching coordinator), bạn phải có role super_admin hoặc Tenant Admin Panel access.

Tôi muốn tạo Batch / Program mới — làm sao? Trainer Panel không cho tạo Batch / Program. Tenant Admin tạo và gán bạn vào. Lý do: phân quyền tổ chức — tạo lớp ảnh hưởng billing, enrollment auto-sync, nên cần admin.

Tôi muốn thêm học viên vào lớp? Tương tự, attach/detach học viên do Tenant Admin làm trên Tenant Admin Panel. Trainer chỉ nhìn thấy danh sách + làm việc với học viên đã có sẵn trong lớp.

Tôi sửa thông tin lớp không được? Trang lớp ở Trainer Panel read-only. Mọi sửa đổi (đổi tên lớp, đổi default_roadmap_template_id, gia hạn end_date) đều ở Tenant Admin Panel.

Có thể đăng xuất khỏi Trainer Panel mà vẫn giữ Learnspace? Phiên dùng chung — đăng xuất ở bất kỳ đâu sẽ đăng xuất toàn bộ. Nếu chỉ muốn ra khỏi Trainer Panel, đóng tab hoặc click logo về Learnspace.