NGƯỜI DÙNG - PHÂN QUYỀN VÀ HIỂN THỊ (PERMISSION & DISPLAY MANAGEMENT)

Tài liệu mô tả giao diện quản trị, luồng xử lý và dữ liệu tổng quan

Phạm vi: quản lý cấu trúc menu/module hiển thị trong hệ thống admin, cập nhật thông tin phân quyền, tạo mới module hoặc menu con, cấu hình icon, mã phân quyền, thứ tự hiển thị và trạng thái kích hoạt.

1. Tổng quan

Module Phân quyền và hiển thị thuộc nhóm Người dùng, dùng để quản lý cấu trúc menu và các quyền hiển thị trong hệ thống admin. Tại đây, người dùng có thể theo dõi toàn bộ danh sách module/menu đang tồn tại, mở rộng từng nhóm chức năng để xem menu con, đồng thời cập nhật hoặc tạo mới các mục phân quyền.

Module này đóng vai trò như nơi cấu hình cây menu hiển thị của hệ thống, đồng thời hỗ trợ ánh xạ giữa tên phân quyền, mã phân quyền, icon, đường dẫn API và trạng thái hiển thị/kích hoạt.

2. Chức năng chính

Quản lý danh sách module/menu trong hệ thống.

Hiển thị cấu trúc phân cấp giữa menu tổng và menu con.

Mở rộng từng module để xem danh sách phân quyền con.

Cập nhật thông tin menu hoặc phân quyền hiện có.

Tạo mới module tổng.

Tạo mới menu con hoặc quyền con trong từng nhóm.

Quản lý thứ tự hiển thị của menu.

Quản lý mã icon hiển thị.

Quản lý mã phân quyền.

Quản lý đường dẫn API tương ứng.

Bật/tắt hiển thị menu.

Bật/tắt trạng thái kích hoạt.

3. Màn hình Phân quyền và hiển thị

Màn hình chính dùng để hiển thị toàn bộ danh sách module/menu dưới dạng cây phân cấp, kèm khu vực thao tác nhanh để chỉnh sửa hoặc thêm mới.

Giao diện màn hình Phân quyền và hiển thị

3.1. Cấu trúc layout màn hình

A. Sidebar điều hướng: Hiển thị các module quản trị chính. Trong màn hình này, nhóm Người dùng được mở rộng và tab Phân quyền được highlight để thể hiện khu vực đang active.

B. Tiêu đề màn hình: Phần đầu hiển thị tiêu đề PHÂN QUYỀN VÀ HIỂN THỊ, giúp người dùng xác định đúng khu vực thao tác.

C. Nút hành động nhanh: Góc phải phía trên có nút + Tạo module để thêm mới module hoặc menu.

D. Danh sách module/menu: Hiển thị dạng cây phân cấp, mỗi dòng là một module lớn như Trang chủ, Quản lý Site, Quản lý Giải đấu, Tip & Chuyên gia, Whitelist, Tools, Người dùng...

E. Khu vực menu con: Khi mở rộng một nhóm, hệ thống hiển thị bảng dữ liệu các menu con tương ứng.

F. Cột thao tác: Ở mỗi module/menu có các icon để chỉnh sửa hoặc thêm mới mục con.

3.2. Cấu trúc danh sách phân cấp

Màn hình hiện tại cho phép hiển thị dữ liệu theo 2 cấp chính:

Cấp module tổng

Cấp menu con / quyền con

Ví dụ trong nhóm Tip & Chuyên gia, khi mở rộng có thể thấy các mục con như:

Quản lý Tip

Cấp Bậc Chuyên Gia

Chuyên gia

Điều này cho thấy module hỗ trợ tổ chức menu theo dạng cây, giúp quản trị quyền hiển thị rõ ràng và trực quan.

Khi một module được mở rộng, hệ thống hiển thị bảng dữ liệu các mục con thuộc module đó.

4.1. Ý nghĩa các cột dữ liệu

Cột	Ý nghĩa
Sắp xếp	Thứ tự hiển thị của menu con trong module.
Menu	Nhãn xác định đây là một mục menu.
Icon	Biểu tượng được dùng để hiển thị cho menu.
Tên menu	Tên hiển thị của menu con trên giao diện.
Mã	Mã định danh hoặc mã phân quyền của menu.
Phân quyền	Khu vực ánh xạ quyền liên quan đến menu đó.
Trạng thái	Cho biết menu đang Hoạt động hoặc ở trạng thái khác.
Tùy chọn	Khu vực thao tác nhanh để cập nhật hoặc thêm mục con tiếp theo.

4.2. Ý nghĩa nghiệp vụ

Bảng này giúp người dùng:

kiểm tra cấu trúc menu con của từng module

xác định đúng mã phân quyền đang sử dụng

cập nhật icon, vị trí và trạng thái hiển thị

thêm nhanh các quyền/menu con mới trong cùng nhóm

Từ icon chỉnh sửa tại cột Tùy chọn, người dùng có thể mở popup cập nhật thông tin của một menu hoặc quyền hiện có.

Popup cập nhật phân quyền hoặc menu

5.1. Các trường dữ liệu

Trường dữ liệu	Mô tả
Trực thuộc	Xác định menu hiện tại thuộc module hoặc nhóm cha nào.
Tên phân quyền	Tên hiển thị của menu/quyền trên hệ thống.
Mã phân quyền	Mã định danh logic của quyền hoặc menu.
Mã icon	Mã icon dùng để render biểu tượng trên giao diện.
Đường dẫn API	Đường dẫn hoặc key API liên quan đến menu/quyền này.
Vị trí	Thứ tự hiển thị của menu trong nhóm.
Hiển thị menu	Công tắc xác định menu có được hiển thị trên sidebar/giao diện hay không.
Kích hoạt	Công tắc xác định menu/quyền có đang được bật sử dụng hay không.
Cập nhật	Nút lưu thay đổi dữ liệu hiện tại.

5.2. Ý nghĩa nghiệp vụ

Popup cập nhật cho phép người dùng chỉnh sửa đồng thời cả phần hiển thị và phần logic quyền, bao gồm:

tên hiển thị

mã quyền

icon

vị trí

trạng thái hiển thị

trạng thái kích hoạt

Điều này giúp một mục menu vừa được quản lý như một phần tử giao diện, vừa được quản lý như một đối tượng phân quyền.

5.3. Luồng xử lý cập nhật

Người dùng nhấn icon chỉnh sửa tại module/menu cần thao tác.

Hệ thống mở popup Cập nhật và nạp sẵn thông tin hiện tại.

Người dùng chỉnh sửa các trường như:

trực thuộc

tên phân quyền

mã phân quyền

mã icon

đường dẫn API

vị trí

hiển thị menu

kích hoạt

Nhấn Cập nhật để lưu thay đổi.

Hệ thống cập nhật lại cấu trúc menu/phân quyền trên màn hình.

Từ nút + Tạo module, người dùng có thể mở popup tạo mới một module tổng hoặc một mục menu mới.

Popup tạo mới module hoặc menu tổng

6.1. Các trường dữ liệu

Popup tạo mới hiện có cấu trúc tương tự popup cập nhật, bao gồm:

Trực thuộc

Tên phân quyền

Mã phân quyền

Mã icon

Đường dẫn API

Vị trí

Hiển thị menu

Kích hoạt

nút Tạo mới

6.2. Ý nghĩa của trường “Trực thuộc”

Trường Trực thuộc quyết định mục mới sẽ được tạo ở cấp nào:

nếu chọn Menu tổng thì bản ghi mới sẽ trở thành một module/menu cấp cha

nếu chọn một menu cha cụ thể thì bản ghi mới sẽ trở thành menu con hoặc quyền con trong nhóm đó

6.3. Luồng xử lý tạo mới module tổng

Người dùng nhấn + Tạo module.

Hệ thống mở popup tạo mới.

Người dùng chọn Trực thuộc = Menu tổng nếu muốn tạo module lớn.

Nhập các trường còn lại như tên phân quyền, mã phân quyền, icon, vị trí...

Chọn trạng thái hiển thị và kích hoạt.

Nhấn Tạo mới để lưu dữ liệu.

Ngoài việc tạo module tổng, hệ thống còn hỗ trợ tạo mới mục con trực tiếp bên trong một nhóm đang tồn tại.

Popup tạo mới menu con hoặc quyền con

7.1. Cách hoạt động

Khi người dùng bấm icon thêm tại một module hoặc menu cha, popup tạo mới sẽ tự gán trường Trực thuộc theo nhóm hiện tại, ví dụ:

Tip & Chuyên gia - Quản lý Tip

Điều này cho phép tạo nhanh một quyền con ngay trong đúng nhánh chức năng mà không cần chọn lại thủ công toàn bộ cấu trúc cha.

Người dùng chọn icon thêm mới tại một module hoặc menu cha.

Hệ thống mở popup tạo mới với trường Trực thuộc đã gắn sẵn theo nhánh hiện tại.

Người dùng nhập:

tên phân quyền

mã phân quyền

mã icon

đường dẫn API

vị trí

Chọn trạng thái Hiển thị menu và Kích hoạt.

Nhấn Tạo mới để thêm menu con/quyền con vào đúng nhóm.

8. Trạng thái hiển thị và kích hoạt

Trong popup tạo mới/cập nhật, hệ thống có hai công tắc quan trọng:

Công tắc này quyết định mục đó có xuất hiện trên giao diện menu hay không.

Bật: menu được hiển thị cho người dùng phù hợp quyền.

Tắt: menu không hiển thị trên giao diện, nhưng vẫn có thể tồn tại ở mức cấu hình/quyền.

8.2. Kích hoạt

Công tắc này quyết định mục đó có đang được bật sử dụng trong hệ thống hay không.

Bật: menu/quyền đang active.

Tắt: menu/quyền bị vô hiệu hóa tạm thời.

8.3. Ý nghĩa nghiệp vụ

Việc tách riêng Hiển thị menu và Kích hoạt giúp hệ thống linh hoạt hơn trong quản trị:

có thể ẩn menu nhưng vẫn giữ logic cấu hình

có thể hiển thị menu nhưng tắt chức năng trong một số trường hợp đặc biệt

hỗ trợ kiểm soát giao diện và nghiệp vụ một cách độc lập

9. Luồng thao tác tổng quan của module

Người dùng truy cập tab Phân quyền trong nhóm Người dùng.

Hệ thống hiển thị toàn bộ cấu trúc module/menu dưới dạng cây.

Người dùng có thể mở rộng từng nhóm để xem menu con.

Khi cần chỉnh sửa, người dùng nhấn icon chỉnh sửa.

Khi cần tạo mới, người dùng:

nhấn + Tạo module để tạo module/menu tổng

hoặc nhấn icon thêm tại từng nhóm để tạo menu con

Sau khi lưu, hệ thống cập nhật lại cấu trúc phân quyền và hiển thị trên màn hình.

10. API / Data tổng quan

API tải danh sách phân quyền/menu: dùng để lấy toàn bộ cấu trúc module và menu hiển thị trên màn hình.

API lấy chi tiết menu/quyền: dùng khi mở popup cập nhật.

API cập nhật menu/quyền: dùng để lưu thay đổi từ popup cập nhật.

API tạo mới module/menu: dùng khi thêm mới module tổng hoặc menu con.

API cập nhật thứ tự hiển thị: dùng để lưu vị trí menu trong từng nhóm.

Dữ liệu cơ bản gồm: parent_id, tên phân quyền, mã phân quyền, mã icon, đường dẫn API, vị trí, hiển thị menu, trạng thái kích hoạt.

11. Kết luận

Module Phân quyền và hiển thị là khu vực quản trị cấu trúc menu và quyền hiển thị của toàn bộ hệ thống admin. Giao diện cho phép quản lý theo dạng cây, hỗ trợ rõ ràng cả việc tạo mới module lớn lẫn menu con trong từng nhánh chức năng. Với các trường như mã phân quyền, icon, đường dẫn API, vị trí, hiển thị menu, kích hoạt, module này giúp đội vận hành và quản trị hệ thống kiểm soát đồng thời cả mặt giao diện lẫn logic phân quyền một cách tập trung và linh hoạt.

NGƯỜI DÙNG - PHÂN QUYỀN VÀ HIỂN THỊ (PERMISSION & DISPLAY MANAGEMENT)

NGƯỜI DÙNG - PHÂN QUYỀN VÀ HIỂN THỊ (PERMISSION & DISPLAY MANAGEMENT)

1. Tổng quan

2. Chức năng chính