Tổng quan API - Business Logic
Tổng quan API, Business Logic#
1. Giới thiệu Domain/Mục đích#
Project này (Social Growth Hack API) là một hệ thống tự động hoá SEO, quản lý domain và crawl/push keywords lên các hệ thống indexing (đặc biệt liên quan đến Google Accounts và Keyword Ranking).
Hệ thống xử lý một lượng lớn Keyword và Domain tĩnh/động, thực hiện việc sinh nội dung hàng loạt (Bulk HTML generation), đẩy sitemap lên Google Search Console và tự động thu thập thông tin xếp hạng từ khoá (Rank tracking).2. Các Business Entity chính#
Mã nguồn Laravel sử dụng hệ thống kiến trúc quản lý đa layer.
Tài khoản người dùng (Users) & Quyền (Roles/Permissions): Quản lý quyền hệ thống nội bộ, quản trị và phân chia luồng dữ liệu. Tài khoản hỗ trợ đăng nhập qua JWT (tymon/jwt-auth).
Domains (Tên miền): Quản lý trạng thái indexing, thông tin GSC (Google Search Console), file và chứng chỉ SSL cho domain.
Keywords (Từ khoá): Quản lý tập từ khoá và các job sinh nội dung (HTML) theo mẫu.
Templates (Mẫu thiết kế): Cho phép đặt mẫu template (có thể sinh content hàng loạt) qua các syntax riêng, với sự tuỳ biến từ TemplateValueRule.
Google Accounts: Tài khoản Google dùng trung gian chạy API Service Account Indexing và GSC checking.
Jobs & Logs: Một hệ thống ngầm chạy thường xuyên (Queue/Horizon) để scan, index và check ranking của hàng loạt Domain.
3. Business Logic Flow#
1.
Khởi tạo dữ liệu: Người dùng (admin) import keywords và domains.
2.
Setup Server: Liên kết các domains với Cloud (S3/VPS) để sinh HTML hàng loạt cho các keyword đã gán với domains.
3.
Generate Content: Sử dụng API sinh trang từ template POST /keywords/generate-html-bulk.
4.
Push Index: Trigger tự động bắt các Domains mới hoặc Keywords mới chạy Google Indexing API, theo dõi lịch sử và cập nhật trạng thái đã index lên DB (Domain, KeywordFileJob, KeywordJobLog).
5.
Check Ranking & Traffic: Chạy các cron/job ngầm kiểm tra hạng từ khoá và crawl traffic, lưu logs.
Ngày cập nhật 2026-03-31 10:30:16
