# Ghi danh

> Quản lý việc ghi danh học viên vào khoá học, kỳ thi và khảo sát, theo dõi tiến độ và trạng thái hoàn thành.

**Quyền truy cập:** Admin hoặc người dùng có quyền **Xem ghi danh**, **Quản lý ghi danh** **Điều hướng:** `Nội dung LMS > Ghi danh` hoặc `/manage/enrollments`

***

## Tổng quan

Module Ghi danh quản lý tập trung việc gán học viên vào các nội dung đào tạo (khoá học, kỳ thi, khảo sát). Hệ thống hỗ trợ nhiều nguồn ghi danh (trực tiếp, phòng ban, vị trí, chương trình đào tạo), theo dõi tiến độ tự động, và quản lý deadline linh hoạt từ nhiều nguồn.

***

## Giao diện

Giao diện chính hiển thị danh sách ghi danh dưới dạng bảng:

* **Tên học viên** -- họ tên người được ghi danh
* **Email** -- địa chỉ email
* **Loại mục tiêu** -- Khoá học / Kỳ thi / Khảo sát
* **Tên mục tiêu** -- tên khoá học/kỳ thi/khảo sát
* **Trạng thái** -- trạng thái hiện tại của ghi danh
* **Tiến độ** -- phần trăm hoàn thành
* **Deadline** -- hạn chót
* **Ngày tạo**

Thanh công cụ hỗ trợ:

* Tìm kiếm theo tên học viên, email hoặc mã nhân viên
* Lọc theo trạng thái ghi danh
* Lọc theo loại mục tiêu (khoá học, kỳ thi, khảo sát)
* Lọc theo nguồn ghi danh
* Phân trang kết quả

***

## Trạng thái ghi danh

| Trạng thái                | Mô tả                              |
| ------------------------- | ---------------------------------- |
| **Chưa đến ngày bắt đầu** | Chưa đến ngày bắt đầu dự kiến      |
| **Được gán**              | Được gán nhưng chưa kích hoạt      |
| **Đang hoạt động**        | Đã kích hoạt, có thể bắt đầu học   |
| **Đang học**              | Đang trong quá trình học           |
| **Hoàn thành**            | Đã hoàn thành                      |
| **Không đạt**             | Không đạt yêu cầu                  |
| **Quá hạn**               | Quá deadline nhưng chưa hoàn thành |
| **Hết hạn**               | Đã hết hạn truy cập                |
| **Rút lui**               | Đã rút khỏi ghi danh               |
| **Được lưu trữ**          | Chương trình đã lưu trữ            |

***

## Nguồn ghi danh

Ghi danh có thể đến từ nhiều nguồn khác nhau:

| Nguồn                       | Mô tả                               |
| --------------------------- | ----------------------------------- |
| **Gán trực tiếp**           | Gán trực tiếp bởi admin             |
| **Từ chương trình đào tạo** | Tự động từ chương trình đào tạo     |
| **Theo phòng ban**          | Gán theo phòng ban                  |
| **Theo chức danh**          | Gán theo vị trí công việc           |
| **Theo nhóm chức danh**     | Gán theo nhóm vị trí                |
| **Theo nhóm nhân sự**       | Gán theo nhóm nhân viên             |
| **Từ khảo sát nhu cầu**     | Từ kết quả khảo sát nhu cầu đào tạo |

Mỗi ghi danh có một **nguồn chính** (primarySource) và có thể có **nguồn bổ sung** (additionalSources). Điều này cho phép một người được ghi danh vào cùng nội dung từ nhiều nguồn khác nhau.

***

## Tạo ghi danh mới

### Các bước

1. Truy cập trang quản lý ghi danh
2. Nhấn **Tạo ghi danh**
3. Nhập thông tin:

| Trường                           | Bắt buộc | Mô tả                                                   |
| -------------------------------- | -------- | ------------------------------------------------------- |
| Loại mục tiêu (targetType)       | Có       | Khoá học, Kỳ thi hoặc Chương trình đào tạo              |
| ID mục tiêu (targetId)           | Có       | ID nội dung cần ghi danh                                |
| Người dùng (userId)              | Có       | ID người dùng được ghi danh                             |
| Loại người dùng (userType)       | Không    | Nhân viên / Ứng viên / Người dùng (mặc định: nhân viên) |
| Nguồn ghi danh (source.type)     | Có       | Chọn nguồn ghi danh                                     |
| Deadline (source.deadline)       | Không    | Hạn chót hoàn thành                                     |
| Tự động kích hoạt (autoActivate) | Không    | Kích hoạt ngay sau khi tạo (mặc định: Có)               |
| Thông báo (notifyUser)           | Không    | Gửi thông báo cho người được ghi danh (mặc định: Có)    |

4. Nhấn **Tạo** để hoàn tất

***

## Quản lý deadline

Hệ thống quản lý deadline từ nhiều nguồn:

| Trường                        | Mô tả                               |
| ----------------------------- | ----------------------------------- |
| Deadline sớm nhất (earliest)  | Deadline sớm nhất từ tất cả nguồn   |
| Deadline muộn nhất (latest)   | Deadline muộn nhất từ tất cả nguồn  |
| Deadline hiệu lực (effective) | Deadline được áp dụng (= muộn nhất) |
| Nguồn deadline (sources)      | Chi tiết deadline từ mỗi nguồn      |

***

## Theo dõi tiến độ

Hệ thống tự động theo dõi tiến độ học tập:

| Trường                              | Mô tả                            |
| ----------------------------------- | -------------------------------- |
| Phần trăm (percent)                 | Tỷ lệ hoàn thành (0-100%)        |
| Hoạt động gần nhất (lastActivityAt) | Thời gian hoạt động cuối         |
| Ngày hoàn thành (completedAt)       | Thời gian hoàn thành             |
| Bài học đã xong (lessonsCompleted)  | Số bài học hoàn thành (khoá học) |
| Tổng bài học (totalLessons)         | Tổng số bài học (khoá học)       |
| Số lần thi (attempts)               | Số lần đã thi (kỳ thi)           |
| Điểm cao nhất (bestScore)           | Điểm thi cao nhất (kỳ thi)       |
| Đạt/Không đạt (passed)              | Kết quả đạt hay không            |

***

## Cập nhật trạng thái

1. Chọn ghi danh cần cập nhật
2. Chọn trạng thái mới
3. Nhập lý do (nếu cần)
4. Nhấn **Cập nhật**

Trạng thái có thể chuyển đổi: **Được gán**, **Đang hoạt động**, **Đang học**, **Hoàn thành**, **Không đạt**, **Hết hạn**, **Rút lui**.

***

## Rút ghi danh

1. Chọn ghi danh cần rút
2. Nhấn **Rút ghi danh**
3. Nhập lý do
4. Xác nhận

Chỉ áp dụng cho trạng thái: **Được gán**, **Đang hoạt động**, **Đang học**, **Quá hạn**.

***

## Thêm/Xoá nguồn

### Thêm nguồn

Thêm nguồn ghi danh bổ sung cho ghi danh hiện có:

1. Chọn ghi danh
2. Nhấn **Thêm nguồn**
3. Chọn loại nguồn và deadline
4. Xác nhận

### Xoá nguồn

Xoá một nguồn ghi danh khỏi ghi danh:

1. Chọn ghi danh
2. Chọn nguồn cần xoá
3. Nhập lý do
4. Xác nhận

Nếu xoá hết tất cả nguồn, ghi danh sẽ bị vô hiệu hoá.

***

## Xoá ghi danh

1. Chọn ghi danh cần xoá
2. Nhấn **Xoá**
3. Nhập lý do
4. Xác nhận

Yêu cầu quyền **Xóa ghi danh**. Xoá bắt buộc (force delete) yêu cầu quyền **Xóa ghi danh bắt buộc**.

***

## Thống kê ghi danh

Trang thống kê hiển thị tổng quan:

| Chỉ số         | Mô tả                           |
| -------------- | ------------------------------- |
| Tổng ghi danh  | Tổng số ghi danh trong hệ thống |
| Đã gán         | Số ghi danh chờ kích hoạt       |
| Đang hoạt động | Số ghi danh đang hoạt động      |
| Đang học       | Số người đang học               |
| Hoàn thành     | Số đã hoàn thành                |
| Không đạt      | Số không đạt                    |
| Hết hạn        | Số đã hết hạn                   |
| Rút lui        | Số đã rút                       |

Phân tích theo loại mục tiêu: khoá học, kỳ thi, chương trình đào tạo.

***

## Lịch sử thay đổi

Mỗi ghi danh lưu lại lịch sử đầy đủ:

| Hành động               | Mô tả               |
| ----------------------- | ------------------- |
| **Tạo ghi danh**        | Tạo ghi danh        |
| **Thêm nguồn**          | Thêm nguồn          |
| **Xoá nguồn**           | Xoá nguồn           |
| **Thay đổi deadline**   | Thay đổi deadline   |
| **Thay đổi trạng thái** | Thay đổi trạng thái |
| **Kích hoạt**           | Kích hoạt           |
| **Cập nhật tiến độ**    | Cập nhật tiến độ    |
| **Hoàn thành**          | Hoàn thành          |
| **Hết hạn**             | Hết hạn             |
| **Rút lui**             | Rút lui             |

***

## Thông báo

Hệ thống theo dõi các thông báo đã gửi:

| Loại thông báo                        | Mô tả                             |
| ------------------------------------- | --------------------------------- |
| **Thông báo ghi danh**                | Thông báo ghi danh                |
| **Nhắc nhở 1 ngày trước khi bắt đầu** | Nhắc nhở 1 ngày trước khi bắt đầu |
| **Nhắc nhở 30 phút trước**            | Nhắc nhở 30 phút trước            |
| **Nhắc nhở 7 ngày trước deadline**    | Nhắc nhở 7 ngày trước deadline    |
| **Nhắc nhở 3 ngày trước deadline**    | Nhắc nhở 3 ngày trước deadline    |
| **Nhắc nhở 1 ngày trước deadline**    | Nhắc nhở 1 ngày trước deadline    |
| **Thông báo hoàn thành**              | Thông báo hoàn thành              |
| **Thông báo hết hạn**                 | Thông báo hết hạn                 |

Kênh thông báo: email, trong ứng dụng, OneSignal, SMS, Zalo, push notification trình duyệt.

***

## Lưu ý

* Ghi danh có thể đến từ nhiều nguồn, deadline hiệu lực là deadline muộn nhất
* Khi xoá nguồn, nếu còn nguồn khác, ghi danh vẫn hoạt động
* Hệ thống tự động theo dõi tiến độ từ khoá học và kỳ thi
* Sử dụng nguồn phòng ban/vị trí để gán tự động cho nhóm nhân viên
* Lịch sử thay đổi giúp kiểm toán và theo dõi mọi thao tác
* Ghi danh cho ứng viên (candidate) sử dụng trong tuyển dụng
* Thông báo được quản lý để tránh gửi trùng lặp

***

## Xem thêm

* [Khoá học](https://docs.noova.vn/hoc-tap-va-dao-tao/04-noi-dung-lms/khoa-hoc) -- Nội dung khoá học để ghi danh
* [Kỳ thi](https://docs.noova.vn/hoc-tap-va-dao-tao/04-noi-dung-lms/ky-thi) -- Nội dung kỳ thi để ghi danh
* [Khảo sát](https://docs.noova.vn/hoc-tap-va-dao-tao/04-noi-dung-lms/khao-sat) -- Nội dung khảo sát để ghi danh
* [Báo cáo](https://docs.noova.vn/hoc-tap-va-dao-tao/04-noi-dung-lms/bao-cao) -- Báo cáo ghi danh và tiến độ