# Nhật ký hệ thống

> Theo dõi và tra cứu lịch sử các hoạt động trên hệ thống, bao gồm thao tác của người dùng, thay đổi dữ liệu và sự kiện bảo mật.

**Quyền truy cập:** `admin` hoặc quyền xem nhật ký **Điều hướng:** `Cài đặt > Nhật ký` hoặc trang quản lý nhật ký hệ thống

***

## Tổng quan

Nhật ký hệ thống (Audit Log) ghi lại tất cả các hoạt động quan trọng trên hệ thống. Mỗi bản ghi bao gồm thời gian, người thực hiện, loại hành động, tài nguyên bị tác động và đối tượng mục tiêu. Quản trị viên có thể lọc, tìm kiếm và xem chi tiết từng bản ghi.

***

## Giao diện

Trang nhật ký hệ thống bao gồm:

* **Bộ lọc thông minh (Smart Filter):** Lọc theo loại hành động, loại tài nguyên, loại đối tượng.
* **Bộ lọc thời gian:** Lọc theo khoảng thời gian.
* **Nút Refresh:** Tải lại dữ liệu mới nhất.
* **Bảng dữ liệu:** Hiển thị danh sách nhật ký.
* **Phân trang:** Điều hướng giữa các trang.

***

## Bảng dữ liệu

| Cột       | Mô tả                                                  |
| --------- | ------------------------------------------------------ |
| Thời gian | Ngày giờ thực hiện hành động                           |
| User      | Người thực hiện (tên và ID)                            |
| Action    | Loại hành động (VD: Tạo người dùng, Cập nhật khóa học) |
| Resource  | Tài nguyên bị tác động (loại:ID)                       |
| Target    | Đối tượng mục tiêu (loại:ID)                           |
| Chi tiết  | Nút xem chi tiết bản ghi                               |

Dữ liệu mặc định sắp xếp theo thời gian giảm dần (mới nhất trước).

***

## Bộ lọc

### Bộ lọc thông minh (Smart Filter)

| Bộ lọc                | Toán tử | Mô tả                            |
| --------------------- | ------- | -------------------------------- |
| AUDIT\_ACTION\_TYPE   | Bằng    | Lọc theo loại hành động          |
| AUDIT\_RESOURCE\_TYPE | Bằng    | Lọc theo loại tài nguyên         |
| AUDIT\_TARGET\_TYPE   | Bằng    | Lọc theo loại đối tượng mục tiêu |

### Bộ lọc thời gian

Cho phép lọc nhật ký theo khoảng thời gian tùy chỉnh hoặc các phím tắt có sẵn (hôm nay, hôm qua, tuần này, tháng này, tất cả thời gian).

***

## Các loại hành động

Hệ thống ghi nhận nhiều loại hành động, được phân nhóm theo module:

### Người dùng

| Mã hành động | Mô tả               |
| ------------ | ------------------- |
| USER\_CREATE | Tạo người dùng      |
| USER\_UPDATE | Cập nhật người dùng |
| USER\_DELETE | Xóa người dùng      |

### Khóa học

| Mã hành động      | Mô tả                |
| ----------------- | -------------------- |
| COURSE\_CREATE    | Tạo khóa học         |
| COURSE\_UPDATE    | Cập nhật khóa học    |
| COURSE\_PUBLISH   | Xuất bản khóa học    |
| COURSE\_UNPUBLISH | Gỡ xuất bản khóa học |
| COURSE\_DELETE    | Xóa khóa học         |

### Vai trò và quyền

| Mã hành động         | Mô tả                   |
| -------------------- | ----------------------- |
| ROLE\_CREATE         | Tạo vai trò             |
| ROLE\_UPDATE         | Cập nhật vai trò        |
| ROLE\_DELETE         | Xóa vai trò             |
| ROLE\_ASSIGN         | Gán role cho người dùng |
| ROLE\_UNASSIGN       | Gỡ role khỏi người dùng |
| ROLE\_ASSIGN\_BULK   | Gán role hàng loạt      |
| ROLE\_UNASSIGN\_BULK | Gỡ role hàng loạt       |
| PERMISSION\_ASSIGN   | Gán quyền               |
| PERMISSION\_REVOKE   | Thu hồi quyền           |

### Cấu hình hệ thống

| Mã hành động     | Mô tả              |
| ---------------- | ------------------ |
| SETTINGS\_UPDATE | Cập nhật cấu hình  |
| SETTINGS\_RESET  | Khôi phục cấu hình |

### Thư viện Media

| Mã hành động    | Mô tả          |
| --------------- | -------------- |
| LIBRARY\_UPLOAD | Tải lên media  |
| LIBRARY\_UPDATE | Cập nhật media |
| LIBRARY\_DELETE | Xóa media      |

### Bài học và Quiz

| Mã hành động   | Mô tả            |
| -------------- | ---------------- |
| LESSON\_CREATE | Tạo bài học      |
| LESSON\_UPDATE | Cập nhật bài học |
| LESSON\_DELETE | Xóa bài học      |
| QUIZ\_CREATE   | Tạo quiz         |
| QUIZ\_UPDATE   | Cập nhật quiz    |
| QUIZ\_DELETE   | Xóa quiz         |

### Chứng chỉ

| Mã hành động                  | Mô tả                  |
| ----------------------------- | ---------------------- |
| CERTIFICATE\_TEMPLATE\_CREATE | Tạo mẫu chứng chỉ      |
| CERTIFICATE\_TEMPLATE\_UPDATE | Cập nhật mẫu chứng chỉ |
| CERTIFICATE\_TEMPLATE\_DELETE | Xóa mẫu chứng chỉ      |

### Email và Automation

| Mã hành động           | Mô tả                     |
| ---------------------- | ------------------------- |
| EMAILSERVICE\_CREATE   | Tạo chiến dịch email      |
| EMAILSERVICE\_UPDATE   | Cập nhật chiến dịch email |
| EMAILSERVICE\_DELETE   | Xóa chiến dịch email      |
| AUTOMATION\_CREATE     | Tạo automation            |
| AUTOMATION\_ACTIVATE   | Kích hoạt automation      |
| AUTOMATION\_DEACTIVATE | Ngừng automation          |

### Đăng nhập/Đăng xuất

| Mã hành động | Mô tả     |
| ------------ | --------- |
| LOGIN        | Đăng nhập |
| LOGOUT       | Đăng xuất |

***

## Xem chi tiết bản ghi

Nhấn nút chi tiết ở cột cuối cùng để mở popup xem đầy đủ thông tin bản ghi, bao gồm:

* Thời gian chính xác
* Thông tin người thực hiện (actor)
* Loại hành động và mô tả
* Tài nguyên bị tác động (resource)
* Đối tượng mục tiêu (target)
* Dữ liệu thay đổi (diff) nếu có
* Các thẻ (tags) liên quan

***

## Phân trang

| Tùy chọn             | Mô tả                                                   |
| -------------------- | ------------------------------------------------------- |
| Số bản ghi mỗi trang | 10, 20, 50, 100                                         |
| Điều hướng           | Trang đầu, trang trước, số trang, trang sau, trang cuối |
| Tổng số bản ghi      | Hiển thị ở góc dưới bên trái                            |

***

## Nhật ký phân quyền

Ngoài nhật ký chung, hệ thống có tab riêng theo dõi các hành động liên quan đến phân quyền và vai trò.

### Truy cập

Điều hướng đến tab **"Nhật ký phân quyền"** trong trang Nhật ký hệ thống.

### Bộ lọc

| Bộ lọc             | Mô tả                             |
| ------------------ | --------------------------------- |
| **Thời gian**      | Chọn khoảng thời gian cần xem     |
| **Loại hành động** | Lọc theo loại thay đổi phân quyền |

### Các loại hành động phân quyền

| Mã hành động         | Mô tả                      |
| -------------------- | -------------------------- |
| ROLE\_CREATE         | Tạo vai trò mới            |
| ROLE\_UPDATE         | Cập nhật thông tin vai trò |
| ROLE\_DELETE         | Xóa vai trò                |
| ROLE\_ASSIGN         | Gán vai trò cho người dùng |
| ROLE\_UNASSIGN       | Gỡ vai trò khỏi người dùng |
| ROLE\_ASSIGN\_BULK   | Gán vai trò hàng loạt      |
| ROLE\_UNASSIGN\_BULK | Gỡ vai trò hàng loạt       |
| ROLE\_SCOPE\_CHANGE  | Thay đổi phạm vi vai trò   |
| PERMISSION\_ASSIGN   | Gán quyền trực tiếp        |
| PERMISSION\_REVOKE   | Thu hồi quyền              |

### Bảng dữ liệu

| Cột             | Mô tả                                     |
| --------------- | ----------------------------------------- |
| Thời gian       | Ngày giờ thực hiện                        |
| Người thực hiện | Tên người thay đổi phân quyền             |
| Hành động       | Loại hành động (hiển thị bằng tiếng Việt) |
| Vai trò         | Tên vai trò bị ảnh hưởng                  |
| Đối tượng       | Người dùng hoặc nhóm bị ảnh hưởng         |
| Chi tiết        | Dữ liệu thay đổi chi tiết                 |

### Xuất dữ liệu

Nhấp nút **"Export CSV"** để tải xuống nhật ký phân quyền dạng CSV. File CSV gồm các cột: Thời gian, Người thực hiện, Hành động, Role, Đối tượng, Chi tiết.

***

## Lưu ý

* Nhật ký hệ thống chỉ cho phép xem, không thể xóa hoặc chỉnh sửa bản ghi.
* Dữ liệu luôn sắp xếp theo thời gian giảm dần (mới nhất trước), không thể thay đổi thứ tự sắp xếp.
* Nhấn **Refresh** để cập nhật dữ liệu mới nhất mà không cần tải lại trang.
* Bộ lọc thời gian mặc định hiển thị tất cả thời gian. Nên thu hẹp khoảng thời gian khi số lượng bản ghi lớn.

***

## Xem thêm

* [Cài đặt chung](https://docs.noova.vn/truyen-thong-va-he-thong/24-cai-dat/cai-dat-chung) -- Thiết lập giao diện website
* [Phiên bản](https://docs.noova.vn/truyen-thong-va-he-thong/24-cai-dat/phien-ban) -- Lịch sử cập nhật phiên bản