QUẢN LÝ GIẢI ĐẤU (LEAGUE MANAGEMENT)

Tài liệu mô tả giao diện quản trị, luồng thao tác và dữ liệu tổng quan

Phạm vi: sắp xếp giải đấu theo quốc gia, tìm kiếm và lọc danh sách giải đấu, thay đổi vị trí ưu tiên, ghim giải đấu, thêm mới và xuất bản cấu hình.

1. Tổng quan

Module Quản lý Giải đấu dùng để quản lý thứ tự hiển thị và danh sách giải đấu theo từng quốc gia trên website. Hệ thống hỗ trợ mở từng nhóm quốc gia để thao tác với danh sách giải đấu bên trong, từ đó phục vụ việc biên tập và ưu tiên nội dung hiển thị ngoài giao diện người dùng.

Người dùng có thể tìm kiếm giải đấu, thay đổi vị trí ưu tiên, ghim các giải đấu quan trọng, thêm giải đấu mới vào danh sách và xuất bản cấu hình sau khi hoàn tất.

2. Chức năng chính

Quản lý danh sách giải đấu theo từng quốc gia.

Sắp xếp thứ tự ưu tiên hiển thị của giải đấu.

Ghim hoặc bỏ ghim giải đấu quan trọng.

Thêm giải đấu mới vào danh sách của từng quốc gia.

Xuất bản cấu hình giải đấu và theo dõi lịch sử xuất bản.

3. Màn hình Sắp xếp giải đấu theo quốc gia

Màn hình tổng quan hiển thị các nhóm quốc gia đang có dữ liệu cấu hình trong hệ thống. Mỗi quốc gia có một bộ thao tác riêng để xuất bản, xuất bản danh sách đã ghim, xem lịch sử hoặc thêm giải đấu mới.

Giao diện màn hình Sắp xếp giải đấu theo quốc gia

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

A. Sidebar điều hướng: Hiển thị các module chính của hệ thống admin. Trong màn hình hiện tại, menu Quản lý Giải đấu được active.

B. Tiêu đề màn hình: Phần đầu nội dung hiển thị tiêu đề lớn “SẮP XẾP GIẢI ĐẤU THEO QUỐC GIA”.

C. Danh sách nhóm quốc gia: Mỗi dòng tương ứng với một quốc gia hoặc khu vực như Việt Nam, Thái Lan, Mỹ. Người dùng có thể mở rộng để xem danh sách giải đấu chi tiết.

D. Nhóm nút thao tác nhanh: Bên phải từng quốc gia có các nút Xuất bản, Xuất bản giải đã ghim, Lịch sử xuất bản và Thêm giải đấu.

E. Phân trang: Cuối bảng hiển thị số bản ghi, trang hiện tại và số lượng dòng mỗi trang.

3.2. Ý nghĩa các nút thao tác

Nút chức năng	Ý nghĩa nghiệp vụ
Xuất bản	Phát hành cấu hình giải đấu hiện tại của quốc gia ra giao diện thực tế.
Xuất bản giải đã ghim	Chỉ xuất bản nhóm giải đấu đang được đánh dấu ghim/ưu tiên.
Lịch sử xuất bản	Tra cứu các lần xuất bản trước đó để kiểm tra hoặc đối soát thay đổi.
Thêm giải đấu	Mở popup để thêm giải đấu mới vào danh sách cấu hình của quốc gia.

4. Màn hình chi tiết giải đấu theo quốc gia

Khi mở một quốc gia, hệ thống hiển thị danh sách giải đấu bên trong cùng bộ lọc tra cứu, trạng thái ghim và các thao tác chỉnh sửa/xóa trên từng dòng dữ liệu.

Giao diện danh sách giải đấu trong một quốc gia

4.1. Thành phần chính

Tên quốc gia đang thao tác, ví dụ: VIỆT NAM.

Bộ lọc gồm Thể loại, ô Tìm kiếm và nút Tìm kiếm.

Bảng dữ liệu giải đấu với các cột STT, Mã, Giải đấu, Loại, Ghim và Tùy chọn.

Nhãn “Phiên bản mới nhất” ở góc phải để nhận biết bản dữ liệu hiện tại.

Các nút thao tác ở đầu khối: Xuất bản, Xuất bản giải đã ghim, Lịch sử xuất bản, Thêm giải đấu.

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

Cột	Ý nghĩa
STT	Số thứ tự hiển thị của giải đấu trong danh sách ưu tiên.
Mã	Mã định danh nội bộ của giải đấu, ví dụ AFC U23, UEFA CL, ENG PR.
Giải đấu	Tên hiển thị của giải đấu kèm logo hoặc icon minh họa.
Loại	Phân loại giải đấu, thường là “Cup” hoặc “Giải đấu”.
Ghim	Công tắc bật/tắt để đánh dấu giải đấu là mục ưu tiên.
Tùy chọn	Nhóm thao tác nhanh để chỉnh sửa vị trí/cấu hình hoặc xóa khỏi danh sách.

4.3. Luồng xử lý tổng quan

Người dùng mở một quốc gia trong danh sách tổng quan.

Hệ thống tải danh sách giải đấu tương ứng của quốc gia đó.

Người dùng có thể tìm kiếm, lọc, ghim hoặc thay đổi vị trí ưu tiên của giải đấu.

Sau khi hoàn tất chỉnh sửa, người dùng thực hiện Xuất bản để áp dụng thay đổi.

Popup này dùng để cập nhật lại thứ tự hiển thị của một giải đấu trong danh sách ưu tiên, đồng thời cho phép thay đổi trạng thái ghim ngay tại thời điểm chỉnh sửa.

Popup thay đổi vị trí giải đấu

Tên giải đấu đang được chỉnh sửa.

Trường “Số thứ tự cần thay đổi” để nhập lại vị trí hiển thị.

Công tắc “Ghim giải đấu” để bật/tắt ưu tiên.

Nút Hủy bỏ và Xác nhận.

5.2. Luồng xử lý

Người dùng nhấn icon chỉnh sửa tại dòng giải đấu cần thay đổi.

Hệ thống mở popup hiển thị thông tin giải đấu hiện tại.

Người dùng nhập vị trí mới và tùy chỉnh trạng thái ghim.

Nhấn Xác nhận để lưu thay đổi.

Popup này dùng để tìm kiếm giải đấu chưa có trong danh sách và thêm vào cấu hình ưu tiên của quốc gia hiện tại.

Popup thêm ưu tiên giải đấu

Ô Tìm kiếm để tra cứu giải đấu theo mã hoặc tên.

Bộ lọc Trạng thái để lọc tập dữ liệu tìm kiếm.

Bảng kết quả gồm STT, Mã, Giải đấu, Loại và cột Thêm.

Nút “+” trong cột Thêm để đưa giải đấu vào danh sách ưu tiên.

Phân trang ở cuối popup để duyệt qua tập dữ liệu lớn.

6.2. Luồng xử lý

Người dùng nhấn nút Thêm giải đấu tại quốc gia cần thao tác.

Hệ thống mở popup tìm kiếm giải đấu.

Người dùng nhập từ khóa hoặc chọn điều kiện lọc.

Danh sách kết quả hiển thị theo từng trang.

Người dùng nhấn biểu tượng thêm để đưa giải đấu vào cấu hình hiện tại.

7. API / Data tổng quan

Nhóm API	Mục đích sử dụng	Dữ liệu/tham số cơ bản
API lấy danh sách quốc gia	Tải các nhóm quốc gia đang có cấu hình giải đấu.	`page`, `limit`
API lấy danh sách giải đấu theo quốc gia	Hiển thị bảng dữ liệu khi mở một quốc gia.	`country_id`, `type`, `keyword`, `page`, `limit`
API cập nhật vị trí giải đấu	Lưu lại thứ tự ưu tiên và trạng thái ghim của một giải đấu.	`league_id`, `position`, `pinned`
API thêm giải đấu	Bổ sung một giải đấu mới vào cấu hình của quốc gia.	`country_id`, `league_id`
API xuất bản	Phát hành cấu hình giải đấu ra ngoài website.	`country_id`, `version` hoặc phạm vi xuất bản
API lịch sử xuất bản	Tra cứu các lần xuất bản trước đó.	`country_id`, `page`, `limit`

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

Truy cập menu Quản lý Giải đấu.

Chọn quốc gia cần quản lý.

Xem, tìm kiếm hoặc lọc danh sách giải đấu.

Thay đổi vị trí, ghim hoặc thêm mới giải đấu.

Xuất bản cấu hình sau khi hoàn tất chỉnh sửa.

1. Tổng quan#

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

3. Màn hình Sắp xếp giải đấu theo quốc gia#

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

3.2. Ý nghĩa các nút thao tác#

4. Màn hình chi tiết giải đấu theo quốc gia#

4.1. Thành phần chính#

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

4.3. Luồng xử lý tổng quan#

5. Popup Thay đổi vị trí Giải đấu#

5.1. Thành phần popup#

5.2. Luồng xử lý#

6. Popup Thêm ưu tiên Giải đấu#

6.1. Thành phần popup#

6.2. Luồng xử lý#

7. API / Data tổng quan#

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