QUẢN LÝ MINIGAME (MINIGAME 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ý danh sách mini game, tra cứu theo tên/SEO, tạo mới, cập nhật thông tin cơ bản và xóa mềm bản ghi không còn sử dụng.

1. Tổng quan

Module Quản lý minigame dùng để quản lý danh sách các mini game trong hệ thống admin. Người dùng có thể theo dõi danh sách game hiện có, truy cập nhanh vào khu vực quản lý item, quản lý kết quả và số lượt chơi của từng game, đồng thời hỗ trợ tạo mới hoặc cập nhật thông tin cơ bản của từng mini game.

Module này đóng vai trò là điểm quản trị trung tâm cho các game vận hành trong hệ thống, giúp kiểm soát thông tin hiển thị, đường dẫn truy cập và liên kết tới các dữ liệu vận hành liên quan.

2. Chức năng chính

Quản lý danh sách toàn bộ mini game trong hệ thống.

Tìm kiếm mini game theo tên hoặc SEO.

Tạo mới mini game.

Cập nhật thông tin cơ bản của mini game.

Xóa mềm mini game không còn sử dụng.

Truy cập nhanh vào khu vực Quản lý item của từng game.

Truy cập nhanh vào khu vực Quản lý kết quả của từng game.

Theo dõi Số lượt chơi của từng game.

3. Màn hình Danh sách mini game

Màn hình chính dùng để hiển thị toàn bộ danh sách mini game, kèm bộ lọc tìm kiếm, nút tạo mới và menu thao tác trên từng dòng dữ liệu.

Giao diện màn hình Danh sách mini game

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 của hệ thống. Trong màn hình này, nhóm menu Quản lý minigame được mở rộng và tab Danh sách game đượ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 đề Danh sách mini game, giúp người dùng xác định đúng khu vực thao tác.

C. Bộ lọc và tìm kiếm: Gồm ô Tìm theo name/seo, nút Xóa lọc và nút Tìm để tra cứu dữ liệu nhanh.

D. Nhóm hành động nhanh: Bao gồm nút + Tạo mới để thêm một mini game mới.

E. Bảng dữ liệu: Bảng hiển thị các cột STT, ID, Tên / SEO, URL, Quản lý item, Quản lý kết quả, Số lượt chơi và Hành động.

F. Phân trang: Cuối bảng thể hiện số lượng bản ghi hiển thị, tổng số dòng, điều hướng trang và số dòng mỗi trang.

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

Cột	Ý nghĩa
STT	Đánh số thứ tự từng dòng dữ liệu trong danh sách.
ID	Mã định danh nội bộ của mini game.
Tên / SEO	Hiển thị tên game và slug/seo tương ứng.
URL	Đường dẫn truy cập thực tế của mini game.
Quản lý item	Liên kết nhanh tới khu vực quản lý item của game, kèm số lượng item hiện có.
Quản lý kết quả	Liên kết nhanh tới khu vực quản lý kết quả của game, kèm số lượng bản ghi kết quả.
Số lượt chơi	Hiển thị tổng số lượt chơi đã ghi nhận của mini game.
Hành động	Khu vực thao tác nhanh để mở menu chỉnh sửa hoặc xóa mềm bản ghi.

3.3. Bộ lọc tra cứu dữ liệu

Tìm theo name/seo: tra cứu nhanh theo tên game hoặc slug SEO.

Xóa lọc: đưa điều kiện tìm kiếm về trạng thái mặc định.

Tìm: gửi điều kiện lọc lên hệ thống và cập nhật lại danh sách kết quả.

3.4. Các liên kết vận hành trong bảng

Ngoài dữ liệu cơ bản, bảng danh sách còn hỗ trợ truy cập nhanh vào các khu vực vận hành liên quan:

Quản lý item: hiển thị số lượng item đang gắn với mini game.

Quản lý kết quả: hiển thị số lượng bản ghi kết quả đã phát sinh.

Số lượt chơi: hiển thị tổng số lần người dùng đã tham gia mini game.

Các liên kết này giúp người vận hành theo dõi nhanh tình trạng game mà không cần vào từng module phụ riêng biệt trước.

3.5. Luồng thao tác tổng quan

Người dùng truy cập module Quản lý minigame.

Hệ thống tự động tải danh sách mini game hiện có và hiển thị lên bảng.

Người dùng có thể tìm kiếm theo tên hoặc SEO để thu hẹp dữ liệu.

Nếu cần bổ sung game mới, người dùng nhấn + Tạo mới.

Nếu cần chỉnh sửa hoặc xóa, người dùng mở menu Hành động tại từng dòng dữ liệu.

Người dùng cũng có thể đi sâu sang các khu vực Quản lý item, Quản lý kết quả hoặc xem nhanh Số lượt chơi.

Tại cột Hành động, người dùng có thể mở menu thao tác nhanh trên từng dòng mini game.

Menu hành động trên từng dòng mini game

Menu này hỗ trợ các thao tác:

Edit

Soft Delete

4.1. Ý nghĩa nghiệp vụ

Edit: dùng để cập nhật thông tin cơ bản của mini game như tên, SEO và URL.

Soft Delete: dùng để ẩn hoặc vô hiệu hóa bản ghi khỏi luồng sử dụng chính mà không nhất thiết xóa cứng hoàn toàn khỏi hệ thống dữ liệu.

Từ menu Hành động, người dùng có thể mở popup cập nhật để sửa nhanh thông tin của một mini game đang có trong hệ thống.

Popup cập nhật mini game

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

Trường dữ liệu	Mô tả
Tên	Tên hiển thị của mini game trong hệ thống.
SEO	Slug hoặc định danh SEO của mini game.
URL	Đường dẫn truy cập trực tiếp tới mini game.
Hủy	Nút đóng popup và hủy thao tác chỉnh sửa.
Lưu	Nút lưu thay đổi sau khi cập nhật dữ liệu.

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

Người dùng nhấn menu Hành động tại dòng dữ liệu cần xử lý.

Chọn Edit.

Hệ thống mở popup Cập nhật mini game và nạp sẵn dữ liệu hiện tại.

Người dùng chỉnh sửa Tên, SEO hoặc URL.

Nhấn Lưu để ghi nhận thay đổi.

Nút + Tạo mới mở popup dùng để thêm một mini game mới theo cách thủ công.

Popup tạo mới mini game

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

Trường dữ liệu	Mô tả
Tên	Tên hiển thị chính của mini game.
SEO	Slug/seo của game, có thể là tùy chọn theo mô tả giao diện.
URL	Đường dẫn truy cập tới mini game, có thể nhập tùy chọn.
Hủy	Nút đóng popup và hủy thao tác tạo mới.
Tạo	Nút lưu bản ghi mini game mới vào hệ thống.

6.2. Luồng xử lý tạo mới

Người dùng nhấn + Tạo mới ở góc phải màn hình.

Hệ thống mở popup nhập dữ liệu cơ bản của mini game.

Người dùng nhập Tên, SEO và URL.

Nhấn Tạo để lưu bản ghi.

Sau khi tạo thành công, mini game mới sẽ xuất hiện trong danh sách quản lý.

7. Tính năng xóa mềm (Soft Delete)

Ngoài chỉnh sửa, hệ thống còn hỗ trợ Soft Delete từ menu hành động trên từng dòng dữ liệu.

7.1. Mục đích

Tính năng này dùng để loại bỏ mini game khỏi luồng hiển thị hoặc vận hành chính trong các trường hợp:

game không còn sử dụng

cần ẩn tạm thời khỏi danh sách hoạt động

dữ liệu được tạo nhầm hoặc không còn phục vụ nghiệp vụ hiện tại

7.2. Luồng xử lý xóa mềm

Người dùng mở menu Hành động.

Chọn Soft Delete.

Hệ thống thực hiện thao tác vô hiệu hóa/xóa mềm đối với bản ghi tương ứng.

Danh sách được cập nhật lại sau khi thao tác thành công.

8. API / Data tổng quan

API tải danh sách mini game: dùng để lấy dữ liệu hiển thị trên bảng, kết hợp với tìm kiếm và phân trang.

API tạo mới mini game: dùng khi người dùng tạo một mini game mới từ popup tạo mới.

API cập nhật mini game: dùng khi chỉnh sửa thông tin cơ bản của game.

API soft delete mini game: dùng để vô hiệu hóa hoặc xóa mềm bản ghi khỏi danh sách vận hành.

Dữ liệu cơ bản gồm: id, tên game, seo, url, số lượng item, số lượng kết quả, số lượt chơi, trạng thái hiển thị.

9. Kết luận

Module Quản lý minigame là khu vực trung tâm để quản trị danh sách game trong hệ thống admin. Giao diện tập trung vào thao tác nhanh, dễ tra cứu và dễ cập nhật, đồng thời liên kết trực tiếp tới các thành phần vận hành quan trọng như item, kết quả và lượt chơi. Điều này giúp việc quản trị mini game trở nên tập trung, rõ ràng và thuận tiện hơn trong quá trình vận hành.

1. Tổng quan#

2. Chức năng chính#

3. Màn hình Danh sách mini game#

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

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

3.3. Bộ lọc tra cứu dữ liệu#

3.4. Các liên kết vận hành trong bảng#

3.5. Luồng thao tác tổng quan#

4. Menu hành động#

4.1. Ý nghĩa nghiệp vụ#

5. Popup Cập nhật mini game#

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

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

6. Popup Tạo mới mini game#

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

6.2. Luồng xử lý tạo mới#

7. Tính năng xóa mềm (Soft Delete)#

7.1. Mục đích#

7.2. Luồng xử lý xóa mềm#

8. API / Data tổng quan#

9. Kết luận#