1. Architecture
DATA SPORT
  • DATABASE-SPORT
    • Tổng quan
    • Logic
      • Logic tổng thể
    • Projects
      • Yêu cầu hệ thống
      • Architecture
        • Database
    • Public APi
      • Tổng quan
    • Cron Make File
      • Tổng quan
  • GOLANG-THESPORT
    • Tổng quan
    • Architecture
      • System
      • Database
      • Source Code
    • Development
      • Local
      • Production
  • GOLANG-KSPORT
    • Tổng quan
    • Architecture
      • System
      • Database
      • Source Code
    • Development
      • Production
  • CRONJOB-LARAVEL
    • Tổng quan
    • Logic
      • Logic tổng thể
    • Projects
      • Yêu cầu hệ thống
      • Architecture
        • System
        • Source code
        • Database
      • Development
        • Dev
        • Production
      • Public API
        • Common API
          • League & Cup Profile (Basic)
          • Schedule & Results (Basic)
          • Match Modify Record
          • List of Countries
          • List of Bookmakers
          • Configuration instructions
        • Live animation
          • Configuration instructions
          • Schedule & Results
        • Live Data
          • Livescores for Today
          • Livescores Changes
          • Schedule & Results
          • Schedule Changes
          • Events
          • Stats
          • Corner
          • Lineups
          • Injury
          • Match List of Live Text
          • Live Text
          • Transfer
        • Profile
          • League & Cup Profile
          • Subleague Profile
          • Cup Stage Profile
          • Team Profile
          • Team Profile Copy
          • Team Profile for Search
          • Player Profile
          • Player Profile for Search
          • Referee Profile
          • Teamlist with Player Profile
        • Stats
          • Matches Analysis
          • List of Player Stats (Match)
          • Player Stats (Match)
          • List of Player Stats (League & Cup)
          • Player Stats (League & Cup)
          • League Standing (Get Subleague)
          • League Standing
          • Cup Standing
          • Top Scorer
          • FIFA Ranking
        • Odds (18 bookmakers)
          • Pre-match and In-play Odds (Main)
          • Live Odds Changes (Main)
          • Historical Odds (Main)
          • Future Odds (Main)
          • Pre-match and In-play Odds (All)
          • Live Odds Changes (All)
          • Historical Odds (All)
          • Future Odds (All)
          • European Odds (Halftime)
          • In-play Odds
          • In-play Odds (Halftime)
          • Odd Modify Record
        • European Odds (200+ Bookmakers)
          • European Odds (200+ Bookmakers)
        • Other Odds
          • Outrights
          • First/Last Team To Score (pre-match)
          • Goals Odd/Even (pre-match)
          • Goals Odd/Even (In-play)
          • Number of Goals in Match (pre-match)
          • Number of Goals in Match (In-play)
          • Half Time/Full Time (pre-match)
          • Half Time/Full Time (In-play)
          • Correct Score (pre-match)
          • Correct Score (In-play)
          • Half Time Correct Score (pre-match)
          • Half Time Correct Score (In-play)
          • Handicap Corners (pre-match)
          • Handicap Corners (In-play)
          • Total Corners (pre-match) - Tổng phạt góc trước trận đấu: First Odds
          • Total Corners (In-play) - Tổng số quả phạt góc (Trong trận) - Run Odds
          • Double Chance(pre-match)
          • EuroHandicap(pre-match)
  • GOLANG-WEBSOCKET
    • Tổng Quan
    • Logic
      • Logic tổng thể
    • Projects
      • Yêu cầu hệ thống
      • Architecture
        • System
        • Source code
      • Development
        • Dev
        • Production
      • Public API
        • API
  • ADMIN-BANNER
    • Tổng quan
    • Logic
      • Logic tổng thể
    • Projects
      • Architecture
        • System
        • Source Code
      • Development
        • Develop
        • Production
      • Public API
        • API
      • Database
        • Cấu trúc Database
      • Admin FE
        • HƯỚNG DẪN CÀI ĐẶT MÔI TRƯỜNG DỰ ÁN SPORT ADMIN
        • Hướng dẫn Đăng nhập
        • QUẢN LÝ SITE (SITE MANAGEMENT)
        • QUẢN LÝ GIẢI ĐẤU (LEAGUE MANAGEMENT)
        • QUẢN LÝ NHÀ CUNG CẤP (SUPPLIER MANAGEMENT)
        • TIP & CHUYÊN GIA - TAB QUẢN LÝ TIPS (TIPS MANAGEMENT)
        • WHITELIST
        • QUẢN LÝ MINIGAME (MINIGAME MANAGEMENT)
        • TRAFFIC REPORT
        • TOOLS - RAPID DATA
        • TOOLS - LIVE SITES
        • TOOLS - SUPPLIERS
        • THEME / PLUGIN
        • NGƯỜI DÙNG - PHÂN QUYỀN VÀ HIỂN THỊ (PERMISSION & DISPLAY MANAGEMENT)
        • QUẢN LÝ NGƯỜI DÙNG (USER MANAGEMENT)
        • NGƯỜI DÙNG - QUẢN LÝ NHÓM QUYỀN (ROLE GROUP MANAGEMENT)
  1. Architecture

System

Kiến trúc hệ thống#

Luồng dữ liệu#

Thành phần chính#

Frontend Admin
Cung cấp giao diện quản trị cho người dùng nội bộ
Công nghệ chính: Vue 3, Vite, TypeScript, Pinia, Vue Router
Các module chính: banner, project, user, whitelist, traffic-report, tool, theme-plugin
Backend API
Cung cấp REST API cho frontend admin
Công nghệ chính: Laravel 11, PHP 8.2
Xử lý nghiệp vụ chính:
quản lý domain/project
quản lý banner/template/banner image
phân quyền người dùng
whitelist domain
license key
SEO content
zone/banner notification
Authentication / Authorization
Backend sử dụng cơ chế xác thực qua JWT và các cấu hình auth của Laravel
Phục vụ đăng nhập admin, kiểm soát phiên đăng nhập và phân quyền theo role/role group
Database
Sử dụng MySQL làm nơi lưu trữ dữ liệu chính
Chứa các nhóm dữ liệu:
user / role / role group
domain / domain page / domain sport
banner template / domain banner / banner image
SEO content / language
whitelist / license key
settings / zone / tracking
Queue / Background Jobs
Hệ thống có các tác vụ xử lý bất đồng bộ thông qua Laravel Queue
Một số job chính:
PublishDomainBannerJob
ProcessMassUpload
CheckWhitelistDomainJob
Phù hợp cho các tác vụ nặng hoặc không cần xử lý đồng bộ ngay trên request người dùng
Storage Service
Hỗ trợ upload file/banner qua local storage hoặc S3
Các service liên quan:
UploadService
UploadServiceNew
S3UploadService
Notification Service
Hệ thống hỗ trợ gửi thông báo qua:
Telegram
Email
Áp dụng cho các luồng như:
duyệt / từ chối license
whitelist notification
các cảnh báo nghiệp vụ khác
External Integrations
Backend có tích hợp với một số dịch vụ ngoài:
DB API
Traffic API
Sport API
live sites / supplier / remote services
Frontend cũng được cấu hình nhiều axios instance để gọi đúng từng nhóm API

Requirements#

Runtime#

Frontend
Node.js
npm hoặc bun
Vite
Backend
PHP >= 8.2
Laravel 11

Storage / Queue / Cache#

MySQL → dữ liệu chính
Queue backend → xử lý job bất đồng bộ
Local Storage / S3 → lưu banner, file upload
Có thể mở rộng thêm Redis nếu triển khai queue/cache theo môi trường thực tế

Tools bắt buộc#

Docker & Docker Compose
Composer
Node.js / npm
Vite
Laravel Artisan

Ghi chú kiến trúc#

Frontend và Backend được tách riêng thành 2 source độc lập:
thscore-client-admin
thscore-api-admin
Frontend đóng vai trò giao diện quản trị, không xử lý nghiệp vụ lõi
Backend là trung tâm xử lý nghiệp vụ, truy cập database, queue, storage và tích hợp ngoài
Kiến trúc hiện tại phù hợp với mô hình admin system, dễ mở rộng theo module nghiệp vụ mới
Modified at 2026-03-27 09:10:55
Previous
Logic tổng thể
Next
Source Code
Built with