System Architecture (Kiến Trúc Hệ Thống)

Dự án GrowthHack SEO API tuân theo kiến trúc Client-Server với hệ thống Worker chuyên biệt mạnh mẽ.

Phân Tầng Kiến Trúc

1. Tầng Giao Diện (Presentation Layer)

Dashboard Admin (VueJS / Frontend riêng biệt) giao tiếp hoàn toàn qua chuẩn API RESTful JSON.

2. Tầng Controller (Application Layer)

Nằm hoàn toàn trong app/Http/Controllers/API.

Trực tiếp validate Request, và Map Data thông qua Model/Services.

Chế độ phân quyền chặn ngay ở Route Group/Form Request.

3. Tầng Background Queue Worker / Asynchronous Layer (Đặc thù SEO System)

Hệ thống sử dụng Laravel Horizon kết nối Redis phân luồng queue. Các luồng lớn nhất:

FillterDomain / ScanKeyword: Quét logs GSC, đối chiếu traffic / Volume, bóc tách API.

PushCheckDomain: Đòi hỏi limit rate qua Google APIs (vì Google Client API giới hạn 200 URLs/ngày với loại cơ bản cho dịch vụ Index).

PushRecordDomain: Lập lịch generate HTML/Files đẩy lên S3 hay FPT/VPS trực tiếp. Hàng ngàn jobs được nới lỏng batch (Laravel Job Batches).

Được trigger qua hệ thống Laravel Schedule Cronjob nội bộ php artisan schedule:run. Script phụ check_jobs.php.

4. Business API Layer (3rd Party Integrations)

Google Client Services: Giao tiếp Cloud Storage hoặc Google Search Console Indexing bằng Service Accounts JSON Key (Được tổ chức nhồi trong google_accounts). Thư viện guzzlehttp thực thi.

Telegram SDK: irazasyed/telegram-bot-sdk (bot notification đẩy báo cáo hệ thống hoặc lỗi GSC).

AWS S3 / Flysystem: Đẩy file sinh từ Template HTML lên Cloud để hosting tĩnh. Cấu hình bởi league/flysystem-aws-s3-v3.

ChatGPT Integration: Sinh content (ai_content trong keywords) hoặc re-write theo rule từ template_value_rules tự động.

5. Storage Layer (Database)

MySQL/MariaDB phân giải Schema lớn với Relational integrity.

Redis cache cho Queue (laravel/horizon).

System architecture

System Architecture (Kiến Trúc Hệ Thống)#

Phân Tầng Kiến Trúc#

1. Tầng Giao Diện (Presentation Layer)#

2. Tầng Controller (Application Layer)#

3. Tầng Background Queue Worker / Asynchronous Layer (Đặc thù SEO System)#

4. Business API Layer (3rd Party Integrations)#