1. Architecture
GrowthHack
  • Business Logic
  • Projects
    • ADMIN
      • Tổng quan ADMIN
      • Architecture
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • Hướng Dẫn Sử Dụng
        • Tổng Quan Hệ Thống
        • TRANG CHỦ (DASHBOARD)
        • Tạo Trang HTML
        • Báo Cáo
          • Báo Cáo_Thứ Hạng
          • Báo Cáo_Volume
          • Báo cáo_Report Index
        • Từ Khóa
          • Từ Khóa_Từ Khóa
          • Từ Khóa_Thương Hiệu
          • Từ Khóa_Ngành
          • Từ Khóa_Kho Hình Ảnh
        • Quản Lý Trang
          • Quản Lý Trang_Quản lý trang mẫu
          • Quản Lý Trang_Trang Nguồn
          • Quản Lý Trang_Trang Đích
          • Quản Lý Trang_Tài Khoản Google
        • Tài Khoản
          • Tài Khoản_Tài Khoản
          • Tài Khoản_Hoạt Động
    • API
      • Tổng quan API - Business Logic
      • Architecture
        • System architecture
        • Database schema
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • Auth
          • Login
          • Get Me
        • Domains
          • Get All Domains
          • Push Indexing
        • Keywords
          • Generate HTML Bulk
          • Import Keywords
  1. Architecture

Code structure

Cấu Trúc Mã Nguồn (Code Structure)#

App tuân theo Laravel Framework v10, cấu trúc chuẩn với mở rộng Services.
.
├── app
│   ├── Exceptions        # Bắt ngoại lệ và xử lý trả về Error JSON.
│   ├── Helpers           # `functions.php`: Các Function Core Custom chung (Mảng, Format dữ liệu...).
│   ├── Http
│   │   ├── Controllers   # Group thư mục `API` logic thực thi routing, phân mảng.
│   │   ├── Middleware    # `VerifyAccessAdmin` & CORS... chặn truy cập ngoài luồng, JWT.
│   │   └── Requests      # Form Request logic, Validation API.
│   ├── Models            # Tất cả ORM Models (Lọc rác bằng Eloquent scope, SoftDeletes...).
│   └── Providers         # Khai báo boot event Guzzle / Register Dependency Injection.
├── bootstrap             # Cache routes / Config Laravel auto loader.
├── config                # Tất cả tham chiếu config môi trường (JWT, Database, Horizon, FileSystem).
├── database
│   ├── factories         # Hỗ trợ Mock test fake data PHPUnit.
│   ├── migrations        # Cấu trúc DB Version Control.
│   └── seeders           # Script chèn mẫu dữ liệu vào Google Accounts/Template/Rules mặc định.
├── lang                  # Ngôn ngữ và Custom API Rules Notification Errors.
├── public                # Index file (Không dùng cho view nhưng lưu index cache/logs debug).
├── resources
│   └── views             # Có thể chứa các file template blade SEO để generate ra HTML string.
├── routes
│   └── api.php           # File Tổng đăng ký API pathing (Không dùng `web.php` vì System rặt API).
├── tests                 # Đơn vị Unit Testing / Feature Testing.
├── artisan               # CLI Laravel
├── composer.json         # Danh sách packages cài đặt.
└── docker-compose.yml    # Build infrastructure local.

Các thư viện lõi đáng chú ý:#

darkaonline/l5-swagger: Export OpenAPI Swagger docs tự động.
tymon/jwt-auth: Core bảo mật JSON Web Token Authentication API.
spatie/laravel-permission: Lõi phân quyền cho Controller.
irazasyed/telegram-bot-sdk: Bot Tele push lỗi cron, job tiến độ.
opcodesio/log-viewer: Xem lỗi queue jobs giao diện UI Admin trên nhánh riêng.
maatwebsite/excel: Export từ khoá, thống kê báo cáo ra file excel gửi user (/api/keywords/export).
Ngày cập nhật 2026-03-31 10:33:25
Trước
Database schema
Tiếp theo
Local
Built with