Khung năng lực

Khung năng lực là "bản đồ kỹ năng" của tổ chức: một cây 4 cấp mô tả người học cần làm được gì. Khi nội dung khoá học (hoạt động, câu hỏi) được gắn vào các chỉ số ở cấp cuối của cây, hệ thống đo được mỗi học viên đã đi tới đâu trên từng năng lực, và nhiều màn hình khác dùng con số đó: trang Tiến độ năng lực của học viên, bản đồ năng lực của lớp, gợi ý luyện tập, lộ trình học.

Trang này dành cho quản lý đào tạo (vai trò training_manager) và quản trị viên, những người dựng và duy trì khung.

Một dòng tóm tắt

/admin → Năng lực & Luyện tập → Khung năng lực → Tạo (hoặc Nhập dữ liệu từ CSV/JSON) → Xây dựng cấu trúc để dựng cây 4 cấp → gắn khung vào khoá học (và chương trình đào tạo) → duyệt tag ở Tag chờ duyệt → xem chỗ còn thiếu ở Độ phủ năng lực.

Cấu trúc 4 cấp

Cấp	Tên trong trình dựng	Ví dụ
1	Lĩnh vực	Frontend Development
2	Nhóm kỹ năng	JavaScript
3	Chủ đề	ES6+
4	Chỉ số năng lực	Arrow Functions

Chỉ cấp 4 (chỉ số) được gắn với hoạt động và câu hỏi. Ba cấp trên dùng để gom nhóm và hiển thị; tiến độ của chúng là tổng hợp từ các chỉ số bên dưới.

Mức thành thạo

Mỗi khung có thang mức thành thạo riêng. Khi tạo khung, hệ thống tự sinh 5 mức mặc định:

Mức	Từ (% tối thiểu)	Ý nghĩa mặc định
Chưa học	0%	Chưa tiếp cận nội dung
Cơ bản	1%	Biết các khái niệm cơ bản
Trung cấp	41%	Có thể áp dụng kiến thức
Thành thạo	71%	Sử dụng thành thục, độc lập
Chuyên gia	91%	Có thể hướng dẫn người khác

Sửa thang ở form sửa khung, mục Mức thành thạo: mỗi mức có Tên mức, % tối thiểu, Màu sắc, Mô tả mức; kéo để đổi thứ tự, Thêm mức thành thạo để thêm mức. Sắp các mức theo thứ tự tăng dần của phần trăm.

Tạo khung

Cách 1: tạo trống rồi dựng cây

1. /admin → nhóm Năng lực & Luyện tập → Khung năng lực (/admin/competency-frameworks).
2. Bấm Tạo → nhập Tên khung năng lực, Mô tả → lưu. 5 mức thành thạo mặc định được tạo kèm.
3. Ở danh sách, bấm Xây dựng cấu trúc trên dòng của khung để mở trình dựng cây.

Cách 2: nhập từ file CSV hoặc JSON

Hợp với khung có sẵn trong Excel, hoặc khung lớn hàng trăm chỉ số.

1. Ở danh sách khung, bấm Nhập dữ liệu.
2. Chọn Định dạng file: CSV (tương thích Excel) hoặc JSON.
3. Bấm Tải template mẫu để lấy file mẫu đúng định dạng, điền nội dung của bạn vào đó.
   • CSV: các cột Level 1, Level 1 Description, Level 2, Level 3, Level 4; mỗi dòng một chỉ số. Ô của cấp cha để trống nếu giống dòng trên. Với CSV bạn nhập thêm Tên khung năng lực và Mô tả ngay trong hộp thoại.
   • JSON: file phải có trường name và tree (tên khung lấy từ file).
4. Tải file lên → hệ thống tạo khung mới và đưa bạn thẳng vào trình dựng cây để kiểm tra, chỉnh sửa.

Lỗi thường gặp khi nhập CSV

"Dòng N không có Level 1 cha được định nghĩa phía trên": dòng đầu tiên của file (sau tiêu đề) phải có ô Level 1. Chỉ các dòng sau đó mới được để trống ô cha.

Dựng cây trong trình dựng

Trang Xây dựng cấu trúc (/admin/competency-frameworks/{id}/builder):

• Thêm lĩnh vực ở đầu trang; trên mỗi nút có nút thêm cấp con (Nhóm, Chủ đề, Chỉ số).
• Kéo-thả để sắp xếp · Double-click để đổi tên; mỗi mục có thể thêm một câu mô tả ngắn (Thêm mô tả…).
• Xoá một lĩnh vực / chủ đề sẽ xoá cả các cấp con bên dưới (có hộp xác nhận).
• Ở mỗi chỉ số, khối Liên kết Activities cho phép tìm hoạt động theo tên và gắn vào chỉ số, kèm Điểm đóng góp (mức hoạt động đó đóng góp vào chỉ số). Gỡ bằng nút Hủy liên kết.

Gắn tay ở đây được tính là tag do người gắn, có hiệu lực ngay.

Gắn hàng loạt không cần làm tay

Với khoá có nhiều hoạt động và câu hỏi, người xây dựng khoá học có thể dùng nút AI gắn năng lực cho cả khoá trên trang sửa khoá. Xem Tạo khoá học. Gợi ý của AI phải được duyệt mới tính (xem Tag chờ duyệt bên dưới).

Gắn khung vào khoá học và chương trình

Khung chỉ "sống" khi được gắn vào nơi học viên học:

Gắn ở đâu	Làm thế nào	Tác dụng
Khoá học	Ô Khung năng lực trên form khoá học, hoặc tab Khung năng lực trên trang sửa khoá. Chiều ngược lại: tab Khóa học áp dụng trên trang sửa khung	AI gợi ý tag và đo tiến độ năng lực của học viên trong khoá
Chương trình đào tạo	Ô Khung năng lực trên form chương trình (xem Chương trình đào tạo)	Khung chính mà chương trình hướng tới. Học viên trong các lớp của chương trình thấy khung này ở trang tiến độ năng lực, kể cả khi chưa ghi danh khoá nào. Lưu ý: Bản đồ năng lực của lớp lấy khung từ các khoá học của lớp, không từ ô này — muốn bản đồ có dữ liệu thì gắn khung vào khoá học

Đừng gắn quá nhiều khung vào một khoá

Khi các khung gắn vào khoá có quá nhiều năng lực (hơn 800), AI không gợi ý tag được nữa và báo "gỡ bớt khung không liên quan".

Tag chờ duyệt

Gợi ý gắn năng lực của AI nằm ở trạng thái AI gợi ý (chưa duyệt) và không được tính vào tiến độ của học viên cho tới khi có người duyệt. Gợi ý đạt mức tin cậy cao được người xây dựng khoá duyệt hàng loạt; phần còn lại dồn về hàng đợi này.

1. /admin → Năng lực & Luyện tập → Tag chờ duyệt (/admin/pending-competency-tags). Huy hiệu trên menu cho biết số tag đang chờ.
2. Lọc theo Khoá học và Dưới mức tin cậy. Danh sách xếp từ gợi ý kém tin cậy nhất.
3. Mỗi dòng cho biết Mục (câu hỏi hoặc hoạt động), Năng lực AI gợi ý, Tin cậy. Bấm Duyệt để tag có hiệu lực, hoặc Bỏ tag nếu AI đoán sai (mục trở lại trạng thái chưa gắn năng lực).

Đọc hàng đợi như một tín hiệu

Một cụm tag kém dồn vào cùng một năng lực thường có nghĩa là mô tả năng lực đó mơ hồ, không phải câu hỏi có vấn đề. Sửa mô tả của chỉ số trong trình dựng.

Nguồn của mỗi tag hiện ở bảng Năng lực liên kết trên trang sửa hoạt động: Gắn tay, AI — đã duyệt, hoặc AI gợi ý (chưa duyệt).

Độ phủ năng lực

Trang Năng lực & Luyện tập → Độ phủ năng lực (/admin/competency-coverage) trả lời câu hỏi "chương trình đang thiếu gì". Chọn một khung, mỗi chỉ số rơi vào một trong ba trạng thái:

Trạng thái	Nghĩa	Nên làm gì
Đã đo	Đã dạy và đã đo (có cả hoạt động lẫn câu hỏi gắn vào)	Không cần làm gì
Có dạy, chưa đo	Đã có bài học phủ, chưa có câu hỏi	Bổ sung câu hỏi
Chưa có gì	Chưa dạy, chưa đo	Cần xây nội dung mới

Bật Chỉ hiện chỗ thiếu để ẩn các chỉ số đã đủ. Tag còn ở Tag chờ duyệt chưa được tính vào độ phủ, nên duyệt hàng đợi trước khi đọc trang này.

Theo dõi tiến độ năng lực

• Ma trận năng lực: widget trên dashboard /admin, chọn một khung (và lọc theo khoá) để xem lưới học viên × năng lực, tô màu theo mức thành thạo.
• Bản đồ năng lực của lớp: nút trên trang lớp, xem Cá nhân hoá học tập.
• Phân tích năng lực (nhóm Báo cáo & Phân tích): kiểm tra độ tin cậy của ước lượng năng lực (dự đoán so với thực tế, phân bố học viên). Trang này mặc định chỉ quản trị viên vào được.

Quyền

Quyền	Cho phép	Vai trò có sẵn
view_any/view/create/update/delete_competency_framework	Xem, tạo, sửa, xoá khung; update_competency_framework cũng là quyền vào trình dựng cây	training_manager, admin
page_PendingCompetencyTags	Trang Tag chờ duyệt	training_manager, admin
page_CompetencyCoverage	Trang Độ phủ năng lực	training_manager, admin
widget_CompetencyMatrixWidget	Widget Ma trận năng lực	training_manager, admin

Người xây dựng khoá học không dựng khung

Vai trò course_manager không có quyền trên khung năng lực. Người xây dựng khoá vẫn gắn được khung có sẵn vào khoá của mình và chạy AI gắn năng lực, nhưng việc dựng cây, duyệt hàng đợi và đọc độ phủ là của quản lý đào tạo. Vai trò hr_admin (đào tạo doanh nghiệp) cũng không có sẵn quyền này: nhờ quản trị viên dựng khung, hoặc cấp thêm quyền ở Vai trò. Xem Năng lực theo vị trí.

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

Học viên hoàn thành hoạt động nhưng phần trăm năng lực không đổi? Kiểm tra hoạt động đã gắn chỉ số chưa, và tag đó đã được duyệt chưa. Tag AI gợi ý (chưa duyệt) không được tính.

Nhập lại cùng file CSV có ghi đè khung cũ không? Không. Mỗi lần Nhập dữ liệu tạo một khung mới. Sửa khung có sẵn trong trình dựng.

Liên quan

• Chương trình đào tạo
• Tạo khoá học
• Đánh giá năng lực định kỳ
• Năng lực theo vị trí (doanh nghiệp)