⚔ VCT PLATFORM — Tài liệu Nghiệp vụ Toàn diện

I. Tổng quan các Phân hệ (Workspace)

VCT Platform tổ chức theo mô hình Multi-Workspace, mỗi workspace phục vụ một nhóm người dùng với vai trò riêng biệt.

II. Phân hệ Liên đoàn Quốc gia (Federation Admin)

2.1 Tổng quan & Lịch

• Dashboard — Thống kê tổng quan: số tỉnh/thành, CLB, VĐV, giải đấu, tài chính
• Lịch — Lịch sự kiện toàn liên đoàn, giải đấu, họp, tập huấn
• Phê duyệt — Xử lý yêu cầu: thành lập CLB, đăng ký giải, chuyển nhượng VĐV, cấp chứng chỉ

2.2 Tổ chức

• Tổ chức (Organizations) — CRUD các đơn vị trực thuộc liên đoàn
• CLB (Clubs) — Quản lý danh sách CLB toàn quốc
• Nhân sự (People) — HLV, trọng tài, cán bộ liên đoàn
• Tỉnh/Thành (Provinces) — Danh sách liên đoàn tỉnh, thống kê
• Sơ đồ tổ chức (Org Chart) — Biểu đồ cấu trúc tổ chức

2.3 Giải đấu

• Danh sách giải • Quản lý giải • Nội dung thi đấu • Đăng ký • Lịch thi • Kết quả • Báo cáo

2.4 Quy chế & Dữ liệu gốc

• Quy chế — Quản lý các quy chế, điều lệ thi đấu
• Master Data — Hạng cân, nội dung thi, cấp đai, môn phái, kỹ thuật

2.5 Xếp hạng & Di sản

• Bảng xếp hạng — VĐV, đoàn theo điểm tích lũy
• Di sản (Heritage) — Phả hệ môn phái, bài quyền, kỹ thuật đặc trưng
• Phả hệ (Lineage) — Dòng truyền thừa các hệ phái

2.6 Đào tạo

• Giáo trình • Thư viện kỹ thuật • Thi lên đai

2.7 Tài chính

• Tổng quan tài chính • Hóa đơn • Phí/Lệ phí • Tài trợ • Ngân sách

2.8 Cộng đồng

• Tin tức/Bài viết • Nhóm • Sự kiện cộng đồng

2.9 Hành chính

• Văn bản chính thức • Chứng chỉ/Chứng nhận • Thông báo • Cấu hình quy trình phê duyệt (Workflow)

III. Phân hệ Liên đoàn Tỉnh (Provincial)

Nghiệp vụ chính

• Dashboard tỉnh — Thống kê CLB, VĐV, HLV trong tỉnh
• CLB cấp tỉnh — Quản lý CLB trực thuộc: thành lập, cập nhật, tạm dừng
• VĐV cấp tỉnh — Hồ sơ VĐV, chuyển nhượng giữa CLB
• HLV cấp tỉnh — Danh sách, chứng chỉ HLV, phân công
• Giải đấu tỉnh — Tạo và quản lý giải cấp tỉnh/khu vực
• Đăng ký thi đấu — CLB đăng ký đoàn/VĐV tham gia giải
• Báo cáo — Thống kê, tổng hợp gửi liên đoàn quốc gia
• Tài chính tỉnh — Thu phí, ngân sách hoạt động tỉnh

IV. Phân hệ Kỷ luật (Discipline)

• Dashboard kỷ luật — Tổng quan vụ việc đang xử lý
• Vụ việc (Cases) — Tạo, theo dõi, phân loại vụ vi phạm
• Điều trần (Hearings) — Lập lịch, ghi biên bản phiên điều trần
• Xử phạt (Sanctions) — Ra quyết định: cảnh cáo, cấm thi đấu, tước đai
• Thanh tra (Inspections) — Kiểm tra CLB, giải đấu
• Báo cáo kỷ luật — Thống kê vi phạm theo thời gian, loại

V. Phân hệ Vận hành Giải đấu (Tournament Ops)

5.1 Tổng quan

• Dashboard giải đấu • Quản lý giải (CRUD) • Thống kê giải

5.2 Thiết lập

• Cấu hình giải — Tên, cấp độ, ngày, địa điểm, đơn vị tổ chức
• Nội dung thi đấu — Đối kháng (hạng cân, giới, lứa tuổi), Quyền (bài bắt buộc/tự chọn)
• Sàn đấu (Arena) — Tạo sàn, vị trí, kích thước, sức chứa, phân công phụ trách
• Trọng tài — Danh sách, cấp bậc, chuyên môn, đơn vị

5.3 Đăng ký

• Quản lý đăng ký — Duyệt/từ chối đăng ký đoàn, VĐV
• Đoàn (Team) — Mã, tên, tỉnh, trưởng đoàn, trạng thái (nháp→chờ duyệt→xác nhận→check-in)
• VĐV (Athlete) — Họ tên, giới, ngày sinh, cân nặng, chiều cao, đoàn, trạng thái
• Đăng ký nội dung — VĐV đăng ký thi ở nội dung cụ thể, validation tự động
• Cân đo (Weigh-in) — Kiểm tra cân nặng trước thi đấu

5.4 Vận hành

• Lịch thi đấu — Xếp lịch tối ưu theo ràng buộc (VĐV, sàn, trọng tài)
• Họp chuyên môn — Biên bản cuộc họp kỹ thuật trước giải
• Bốc thăm — Xếp cặp đấu, seed VĐV hạt giống
• Phân công trọng tài — Gán trọng tài cho từng trận/sàn
• Đối kháng (Combat) — Chấm điểm real-time, võ sĩ đỏ/xanh
• Quyền (Forms) — Chấm điểm biểu diễn quyền thuật
• Bracket — Nhánh thi đấu loại trực tiếp/vòng tròn

5.5 Kết quả

• Quản lý kết quả • Bảng kết quả • Huy chương • Khiếu nại • Gallery media • Báo cáo giải

VI. Phân hệ Quản lý Câu lạc bộ (Club Management)

• Dashboard CLB — Tổng quan: số võ sinh, buổi tập, doanh thu
• Võ sinh (Students) — Danh sách, hồ sơ, lịch sử tập luyện, đai
• HLV (Coaches) — Phân công, chứng chỉ, lịch dạy
• Giáo trình — Chương trình đào tạo theo đai/cấp
• Thư viện kỹ thuật — Video, hình ảnh các bài quyền, kỹ thuật
• Kế hoạch tập luyện — Lịch tập tuần/tháng
• Lớp học (Classes) — Quản lý lớp, khung giờ, sĩ số
• Điểm danh (Attendance) — Theo dõi chuyên cần từng buổi
• Thi lên đai (Belt Exams) — Tổ chức, chấm điểm, cấp đai
• E-Learning — Học trực tuyến, video bài giảng
• Cơ sở (Facilities) — Quản lý phòng tập, sàn tập
• Trang thiết bị (Equipment) — Theo dõi, bảo trì thiết bị
• Tài chính CLB — Học phí, hóa đơn, phí/lệ phí, doanh thu & chi
• Giải đấu — Xem giải, đăng ký VĐV tham gia

VII. Phân hệ Trọng tài (Referee Console)

• Dashboard — Lịch trình hôm nay, trận sắp chấm
• Lịch thi đấu — Xem lịch theo sàn, ngày, nội dung
• Phân công — Xem phân công sàn/trận của bản thân
• Chấm Đối kháng — Giao diện chấm real-time, nút điểm đỏ/xanh
• Chấm Quyền — Chấm điểm biểu diễn, trừ điểm lỗi
• Bảng điểm (Scoreboard) — Hiển thị live điểm số
• Khiếu nại — Xem/xử lý khiếu nại kết quả
• Kết quả — Xem bảng kết quả tổng hợp

VIII. Phân hệ Vận động viên (Athlete Portal)

• Trang chủ — Dashboard cá nhân, thông báo, giải sắp tới
• Hồ sơ (Profile) — Thông tin cá nhân, ảnh, cấp đai, đoàn/CLB
• Xếp hạng — Thứ hạng cá nhân theo nội dung/cấp
• Thành tích (Results) — Lịch sử thi đấu, huy chương
• Giải đấu — Xem giải đang/sắp diễn ra
• CLB — CLB đang sinh hoạt, lịch sử thành viên
• Luyện tập (Training) — Log buổi tập, tiến trình
• E-Learning — Khóa học online, video kỹ thuật

IX. Phân hệ Công chúng (Public / Spectator)

• Bảng điểm Live — Xem trực tiếp điểm trận đấu
• Chế độ Khán giả — Giao diện tối ưu xem trận trên thiết bị cá nhân
• Lịch thi đấu — Tra cứu trận theo ngày/sàn/VĐV
• Bảng xếp hạng — Xem BXH VĐV, đoàn
• Kết quả — Tra cứu kết quả sau trận
• Huy chương — Bảng tổng sắp huy chương
• Di sản Võ Cổ Truyền — Tìm hiểu lịch sử, phả hệ môn phái
• Cộng đồng — Tin tức, bài viết, sự kiện

X. Phân hệ Quản trị Hệ thống (System Admin)

• Platform Analytics — Thống kê toàn hệ thống: user active, API calls, storage
• Tenant Management — Quản lý tổ chức thuê (multi-tenant): LĐ quốc gia, LĐ tỉnh, CLB
• User Management — CRUD người dùng, gán vai trò, khóa/mở tài khoản
• Role Management — Định nghĩa vai trò, phân quyền RBAC
• Feature Flags — Bật/tắt tính năng theo tenant/vai trò
• System Health — Giám sát server, DB, cache, WebSocket
• Notifications — Quản lý thông báo hệ thống, template
• Integrity Monitoring — Phát hiện gian lận, bất thường điểm số
• Data Quality — Kiểm tra chất lượng dữ liệu: completeness, accuracy, consistency
• Audit Logs — Lịch sử thao tác: ai, làm gì, lúc nào, từ đâu

XI. Hệ thống Vai trò & Phân quyền (RBAC)

11.1 Danh sách 12 vai trò

11.2 Ma trận Phân quyền

Chú thích: V=View, C=Create, U=Update, D=Delete, I=Import, E=Export, FULL=Toàn quyền

XII. Cấu trúc Tổ chức

12.1 Hierarchy Tổ chức (Multi-Tenant)

12.2 Đối tượng Người dùng

XIII. Các Module Nghiệp vụ Backend (23 Domain Modules)

XIV. Tính năng Nâng cao V7 (Enterprise)

Layer A — Bảo vệ Dữ liệu & Đồng bộ

• Crypto-Shredding (GDPR) — Mã hóa dữ liệu cá nhân VĐV bằng DEK, xóa an toàn khi có yêu cầu
• Erasure Tombstone — Ghi nhận chứng chỉ xóa dữ liệu tuân thủ GDPR
• Offline Sync & Conflict Resolution — Đồng bộ offline, phát hiện xung đột, tự động merge hoặc escalate
• Config Changelog — Version control cho cấu hình, rollback khi cần

Layer B — Quản trị & An ninh

• Event Schema Registry — Quản lý schema sự kiện domain: versioning, compatibility
• Zanzibar-style ReBAC — Authorization tuple (object-relation-subject), derived permissions
• Digital Signatures — Ký số kết quả, chứng nhận huy chương (PKI, chain hash)
• Translation (i18n) — Đa ngôn ngữ centralized: machine → human reviewed → official
• Data Quality Monitoring — Kiểm tra chất lượng dữ liệu: completeness, accuracy, consistency, timeliness
• Multi-channel Notifications — Push/email/SMS, quiet hours, delivery tracking

Layer C — Vận hành Giải đấu

• Resource Scheduling — Lập lịch tối ưu: sàn đấu, trọng tài, y tế (constraint-based)
• Document Templates — Template HTML cho chứng nhận, giấy khen, huy chương
• Issued Documents + QR — Cấp văn bản kỹ thuật số, xác minh bằng QR code
• Integrity Monitoring — Phát hiện gian lận: unusual scoring pattern, anti-match-fixing
• Scoring Baselines — Baseline thống kê cho anomaly detection

Layer D — Khả năng Mở rộng

• Federation Merge — Sáp nhập liên đoàn: mapping, duplicate detection, rollback
• Multi-Sport Profile — Cấu hình đa môn: loại thi đấu, hạng cân, xếp hạng riêng
• Team Events — Thi đấu đồng đội: team entry, bout system, substitution
• Athlete Daily Load — Theo dõi tải trọng VĐV/ngày: an toàn sức khỏe thi đấu
• Auth Provider Abstraction — Hỗ trợ đa provider: Supabase, Auth0, Firebase, Keycloak
• Storage Provider Abstraction — Hỗ trợ đa storage: Supabase Storage, S3, GCS

XV. Tổng quan API Endpoints