Appearance
Cài đặt: bản đồ các hub và khối
Mọi cấu hình của tổ chức nằm trong nhóm menu Cài đặt của khu vực quản trị (/admin). Trang này là bản đồ: mỗi trang cài đặt chứa những khối nào, khối nào cần quyền gì, và hướng dẫn chi tiết của từng khối nằm ở đâu.
Dành cho: Quản trị viên và mọi vai trò được giao cấu hình một phần (marketing cấu hình lead, quản lý đào tạo cấu hình phiên trực tiếp…).
Hub và khối
Thay vì mỗi cấu hình một trang riêng, hệ thống gom chúng vào năm trang cài đặt (gọi là hub). Mỗi hub chia thành nhiều khối (tab), mỗi khối là cấu hình của một tính năng:
| Hub (nhãn trên menu) | Tiêu đề trang | Địa chỉ |
|---|---|---|
| Chung | Cài đặt chung | /admin/settings/general |
| Học tập | Cài đặt học tập | /admin/settings/learning |
| Trí tuệ nhân tạo | Cài đặt trí tuệ nhân tạo | /admin/settings/ai |
| Email & Thông báo | Cài đặt email & thông báo | /admin/settings/notifications |
| Tích hợp | Tích hợp & kết nối | /admin/settings/integrations |
Bấm vào một tab, địa chỉ trên thanh trình duyệt đổi thành …?tab=<khoá>, ví dụ /admin/settings/learning?tab=live_sessions. Địa chỉ đó mở thẳng đúng khối — dùng nó để đánh dấu trang hoặc gửi cho đồng nghiệp.
Lưu
Nút Lưu ở cuối trang ghi mọi khối của hub cùng lúc, không chỉ tab đang mở (phím tắt Ctrl/⌘ + S). Rời trang khi còn thay đổi chưa lưu, trình duyệt sẽ hỏi lại.
Nếu mọi khối bạn thấy đều chỉ để đọc (ví dụ khối Gói dịch vụ), nút Lưu không hiện.
Vì sao tôi không thấy một khối
Một khối chỉ hiện khi đủ cả hai điều kiện:
- Tính năng của khối đang bật cho tổ chức. Khối của một module bị tắt sẽ biến mất cùng module đó. Bật lại module, cấu hình cũ còn nguyên.
- Bạn có quyền cấu hình khối đó. Mỗi khối gác sau một quyền riêng, tên bắt đầu bằng
configure_(cột Quyền trong các bảng dưới). Quyền này gán trong Vai trò — xem Vai trò và phân quyền.
Hub không còn khối nào hiện được với bạn thì cả mục đó biến khỏi menu Cài đặt.
Màn hình vận hành có nút "Cấu hình"
Nhiều màn hình làm việc hằng ngày (ví dụ Hộp thư Zalo) có nút Cấu hình ở góc trên, dẫn thẳng tới khối cài đặt của nó. Nút chỉ hiện khi bạn thật sự mở được khối đó.
Khi một khối báo "Không đọc được nhóm cấu hình"
Tab hiện biểu tượng cảnh báo và câu "Không đọc được nhóm cấu hình … Nhóm này chưa có dữ liệu khởi tạo trong cơ sở dữ liệu của tổ chức bạn". Nghĩa là bản cài của tổ chức thiếu bước cập nhật dữ liệu cho tính năng đó. Báo nhà cung cấp dịch vụ; các khối khác trên trang vẫn dùng và lưu bình thường.
Hub Chung
/admin/settings/general
| Khối | ?tab= | Dùng để | Quyền | Hướng dẫn |
|---|---|---|---|---|
| Gói dịch vụ (chỉ đọc) | tenant_plan | Gói, số tài khoản, dung lượng, hạn dùng của tổ chức | view_tenant_plan | Gói dịch vụ và hạn dùng |
| Thương hiệu & trang chủ | branding | Tên, biểu tượng, logo; trang chủ; chuyển hướng sau đăng nhập; đường dẫn tài liệu hướng dẫn; mã chèn header/footer | configure_branding | Thương hiệu và giao diện |
| Tài khoản | accounts | Vai trò mặc định cho người dùng mới, tự đổi họ tên, tự đăng ký, domain bắt buộc SSO | configure_accounts | Tài khoản |
| Giao diện | theme | Bố cục và màu của header, menu, chân trang | configure_theme | Thương hiệu và giao diện |
| Thu thập liên hệ | contact_capture | Xin số điện thoại ở các bước đăng ký; ô tick nhận tiếp thị | configure_contact_capture | Dữ liệu cá nhân & thu thập liên hệ |
| Dọn thùng rác | trash_retention | Tự xoá hẳn bản ghi nằm quá lâu trong thùng rác | configure_trash_retention | Dọn thùng rác (dưới đây) |
| Dữ liệu cá nhân | privacy | Công tắc áp dụng Nghị định 13/2023 | configure_privacy | Dữ liệu cá nhân & thu thập liên hệ |
| Nhật ký kiểm toán | audit_trail | Thời hạn lưu nhật ký | configure_audit_trail | Nhật ký kiểm toán |
| Tổ chức doanh nghiệp | corporate_org | Đơn vị/chức danh mặc định cho tài khoản tạo qua SSO | configure_corporate_org | Cơ cấu tổ chức |
| CV Reviewer | cv_reviewer | Trang công khai chấm CV cho khách (/tools/cv-review) | configure_cv_reviewer | — |
| Lead & tư vấn | leads | Giờ làm việc, SLA phản hồi, tự chia lead, câu đồng ý, nguồn tự tạo lead | configure_leads | Khách hàng tiềm năng |
| Trang lộ trình cho khách | roadmap_funnel | Câu chữ trang lộ trình công khai | configure_roadmap_funnel | Lộ trình cho khách |
| Mã học viên | student_code | Quy tắc sinh mã cho học viên mới (mã đã cấp không đổi) | configure_student_code | Học viên |
| Người dùng online | presence | Cửa sổ thời gian để tính một người là "đang online" | configure_presence | Người dùng và nhóm |
| Kho lưu trữ | storage | Hạn mức theo vai trò, trần file, thùng rác của kho | configure_storage | Kho lưu trữ |
Hub Học tập
/admin/settings/learning
| Khối | ?tab= | Dùng để | Quyền | Hướng dẫn |
|---|---|---|---|---|
| Loại hoạt động khuyên dùng | activity_picker | Tab Khuyên dùng khi người soạn thêm hoạt động | configure_activity_picker | Tạo khoá học |
| Khóa học | assignment | Kích thước file tối đa và loại file được phép khi nộp bài tập | configure_assignment | Chấm bài tập |
| Trang khoá học | course_display | Thông tin nào hiện trên thẻ khoá học và trang chi tiết (danh mục, tag, số chương/bài/học viên, người tạo, đề cương…), ngưỡng số học viên tối thiểu để hiện | configure_course_display | Thông tin hiển thị của khoá học |
| Sự kiện | event | Mặc định khi tạo sự kiện, lịch lặp lại, các mốc nhắc trước giờ diễn ra | configure_event | — |
| Cam kết liêm chính | exam_integrity | Bản cam kết thí sinh xác nhận trước khi mở đề | configure_exam_integrity | Chống gian lận |
| Gamification | gamification | Loại điểm dùng để xếp hạng | configure_gamification | Thành tích & điểm thưởng |
| Kho tri thức | knowledge | Mặc định cho không gian mới, đính kèm, chuyên gia | configure_knowledge_hub | Kho tri thức |
| Phiên trực tiếp | live_sessions | Lọc từ tục | configure_live_sessions | Phiên trực tiếp |
| Phần tương tác trong bài đọc | content_blocks | Bật Lưu và chấm câu trả lời ở máy chủ cho quiz và các khối tương tác chèn trong bài đọc. Tắt thì chỉ quiz trong bài còn làm được (chấm trên trình duyệt, không lưu), các khối khác chỉ hiện nội dung; không có thống kê, khối bắt buộc không chặn hoàn thành bài | configure_content_blocks | Khối tương tác trong bài đọc |
| Mini-game | minigames | Cài đặt chung của trò chơi | configure_minigames | Trò chơi & level |
| Cài đặt luyện tập | practice | Kích thước phiên luyện tập | configure_practice | Luyện tập điểm yếu |
| Năng lực theo vị trí | role_competency | Thang 5 mức dùng chung và quy tắc chọn mức năng lực | configure_role_competency | Năng lực theo vị trí |
| Xưởng Scratch | scratch_studio | Bật xưởng tự do, hạn mức | configure_scratch_studio | Scratch |
| Bảng tin | feed | Bảng tin toàn công ty, thông báo bài mới | configure_feed | Bảng tin |
| Ôn tập giãn cách | spaced_repetition | Giới hạn số thẻ ôn mỗi ngày | configure_spaced_repetition | Ôn tập giãn cách |
| Tự điểm danh | attendance_capture | Bật cho học viên tự điểm danh bằng QR/PIN, mốc đi muộn, thời lượng phiên, dải IP Wi-Fi của cơ sở | configure_attendance_capture | Tự điểm danh |
| Kho công cụ | toolbox | Chính sách mặc định cho công cụ chưa có chính sách riêng, ngày dùng thử, ân hạn | configure_toolbox | Kho công cụ |
Hub Trí tuệ nhân tạo
/admin/settings/ai — khối Khoá API đứng đầu: không có khoá thì các khối còn lại chỉ là cấu hình chưa dùng được. Hướng dẫn chung cho cả hub: Cài đặt AI và khoá API.
| Khối | ?tab= | Quyền | Hướng dẫn chi tiết |
|---|---|---|---|
| Khoá API | ai_keys | configure_ai_keys | Cài đặt AI |
| Phân tích bài thi | ai_exam_feedback | configure_ai_exam_feedback | Cài đặt AI |
| Chấm bài AI | ai_grading | configure_ai_grading | Chấm bài tập |
| Hạn mức credits AI | ai_credits | configure_ai_credits | Credits AI |
| AI viết nội dung | ai_content | configure_ai_content | AI soạn nội dung |
| Tư vấn viên khóa học | ai_advisor | configure_advisor | Tư vấn viên AI |
| Hội thoại AI | ai_dialogue | configure_ai_dialogue | Cài đặt AI |
| AI Tạo Outline | ai_course_outline | configure_ai_course_outline | AI soạn nội dung |
| AI công cụ CV | ai_cv | configure_ai_cv | Công cụ CV |
| CV Reviewer | ai_cv_reviewer | configure_cv_reviewer_ai | Cài đặt AI |
| AI của kho tri thức | knowledge_ai | configure_knowledge_hub | AI của kho tri thức |
| AI Lộ trình học tập | ai_roadmap | configure_ai_roadmap | Cài đặt AI |
| AI Quiz Generator | ai_quiz | configure_ai_quiz | Cài đặt AI |
| Trợ lý lộ trình cho khách | ai_roadmap_funnel | configure_roadmap_funnel_ai | Lộ trình cho khách |
| Giọng đọc | speech | configure_speech | Giọng đọc |
Chi phí của mọi khối AI theo dõi ở Theo dõi chi phí AI.
Hub Email & Thông báo
/admin/settings/notifications
| Khối | ?tab= | Dùng để | Quyền | Hướng dẫn |
|---|---|---|---|---|
| Gửi Email | email_delivery | Gửi email qua tài khoản AWS SES riêng của tổ chức | configure_email_delivery | Gửi email (AWS SES) |
| Chứng chỉ sắp hết hạn | certificate | Nhắc chứng chỉ sắp hết hạn | configure_certificate | Chính sách email học viên |
| Nhắc hạn đào tạo bắt buộc | corp_training | Nhắc hạn đào tạo được giao | configure_corp_training | Giao đào tạo |
| Thu hồi đơn bỏ dở | ecommerce_payment_recovery | Email nhắc khách thanh toán đơn bỏ dở | configure_payment_recovery | Thu hồi đơn bỏ dở |
| Chuyển đổi học thử | ecommerce_trial_conversion | Mã giảm giá và email mời mua cho người học thử | configure_trial_conversion | — |
| Nhắc học viên ngưng học | idle_reminder | Nhắc người học lâu không vào học | configure_idle_reminder | Chính sách email học viên |
| Email học viên | learner_engagement | Các email gửi học viên | configure_learner_engagement | Chính sách email học viên |
| Nhắc thông báo chưa đọc | activity_reminder | Email nhắc thông báo chưa đọc | configure_activity_reminder | Chính sách email học viên |
| Chăm sóc cộng đồng | feed_care | Báo người phụ trách khi bài trên bảng tin chưa ai trả lời | configure_feed_care | Bảng tin |
Mẫu nội dung email sửa ở màn hình Mẫu email (nhóm Marketing), không phải ở hub này — xem Mẫu email.
Hub Tích hợp
/admin/settings/integrations
| Khối | ?tab= | Dùng để | Quyền | Hướng dẫn |
|---|---|---|---|---|
| Chuyển đổi quảng cáo | ads_conversions | Đẩy chuyển đổi về Meta và Google Ads | configure_ads_conversions | Facebook Ads |
| Tích hợp GetResponse | getresponse | Đồng bộ liên hệ sang GetResponse | configure_getresponse | — |
| Đăng nhập bằng Google | google_sso | Đăng nhập Google | configure_google_sso | Đăng nhập bằng Google |
| Mã theo dõi trang phễu | funnel_tracking | GTM/pixel riêng cho trang phễu khảo sát | configure_funnel_tracking | Phễu khảo sát |
| Tích hợp Mautic | mautic | Đồng bộ liên hệ sang Mautic | configure_mautic | — |
| Đăng nhập bằng Microsoft | microsoft_sso | Đăng nhập Microsoft (Entra ID) | configure_microsoft_sso | Đăng nhập bằng Microsoft |
| Kết nối AI (MCP) | mcp | Địa chỉ connector cho Claude, số ngày lưu nhật ký công cụ AI | configure_mcp | Kết nối Claude (MCP) |
| Zalo Official Account | zalo_oa | Kết nối Zalo OA | configure_zalo_oa | Zalo OA |
| Chống spam biểu mẫu | form_protection | Cloudflare Turnstile cho biểu mẫu công khai | configure_form_protection | Chống spam biểu mẫu (dưới đây) |
Chống spam biểu mẫu (Cloudflare Turnstile)
Bảo vệ mọi biểu mẫu công khai của tổ chức — biểu mẫu liên hệ, trang đích khảo sát — bằng Cloudflare Turnstile, một dạng CAPTCHA không bắt người dùng giải đố.
- Tạo Site Key và Secret Key miễn phí trong Cloudflare Dashboard → Turnstile, gắn với tên miền của tổ chức.
- Mở
/admin/settings/integrations?tab=form_protection, bật Bật Turnstile, dán hai khoá, bấm Lưu.
| Ô | Ghi chú |
|---|---|
| Bật Turnstile | Khi bật, người gửi biểu mẫu phải vượt thử thách Turnstile. Chưa nhập đủ hai khoá thì thử thách chưa có hiệu lực. |
| Site Key | Khoá công khai hiển thị trong widget. |
| Secret Key | Khoá bí mật để xác minh phía máy chủ. Không chia sẻ công khai. |
Hub Hệ thống (nhà cung cấp)
Panel quản trị trung tâm của nhà cung cấp dịch vụ có thêm hub Hệ thống (khối Thương hiệu Central và AI). Hub này không nằm trong khu vực quản trị của tổ chức bạn.
Mục khác trong nhóm Cài đặt
Ngoài năm hub, nhóm menu Cài đặt còn có những màn hình riêng:
| Mục | Dùng để | Hướng dẫn |
|---|---|---|
| Bố cục dashboard | Kéo thả widget trên trang chủ quản trị | Dashboard |
| Chatbot & Tư vấn AI | Bật chatbot, index nội dung | Chatbot học tập |
| Quản lý AI Chatbot | Màn hình quản lý của chatbot học tập | Chatbot học tập |
| Tư vấn khóa học | Quản lý trợ lý tư vấn khoá học cho khách | Tư vấn viên AI |
| Nội dung tư vấn | Nội dung trợ lý tư vấn dùng để trả lời | Tư vấn viên AI |
| Cảnh báo vận hành | Luật cảnh báo, kênh nhận cảnh báo | Cảnh báo vận hành |
| Nhật ký kiểm toán | Ai đã sửa gì, khi nào | Nhật ký kiểm toán |
Dọn thùng rác
/admin/settings/general?tab=trash_retention — quyền configure_trash_retention, mặc định chỉ Quản trị viên có.
Bản ghi bị xoá ở nhiều màn hình không biến mất ngay: chúng vào thùng rác của màn hình đó và khôi phục được. Khối này quyết định có tự xoá hẳn những bản ghi nằm trong thùng rác quá lâu hay không.
| Ô | Mặc định | Ghi chú |
|---|---|---|
| Tự động xoá hẳn bản ghi quá hạn | Tắt | Khi tắt, bản ghi nằm trong thùng rác vô thời hạn và chỉ bị xoá hẳn khi có người bấm tay. |
| Giữ trong thùng rác | — | Số ngày một bản ghi được nằm trong thùng rác trước khi bị xoá hẳn. Tối thiểu 7 ngày, tối đa 3650. |
Khi bật, hệ thống dọn mỗi ngày một lần vào ban đêm.
Xoá hẳn không hoàn tác được
Xoá hẳn kéo theo dữ liệu liên quan — ví dụ xoá hẳn một lớp là mất luôn điểm danh của lớp đó. Trước khi bật, nhờ nhà cung cấp chạy lệnh xem trước để biết sẽ mất những gì:
php artisan trash:purge --pretendLệnh chạy trong phạm vi một tổ chức, chỉ đếm, không xoá gì — kể cả khi công tắc đang tắt.
Xoá vĩnh viễn bằng tay (nút trong thùng rác của từng màn hình) mặc định chỉ dành cho Quản trị viên; các vai trò mặc định khác bị chặn quyền xoá vĩnh viễn, kể cả khi được khôi phục bản ghi. Xem Vai trò và phân quyền.