1. Architecture
Marketing Tool
  • Module mặc định
    • TỔNG QUAN HỆ THỐNG
    • Bussiness | Logic
      • XÁC THỰC & HỒ SƠ NGƯỜI DÙNG
      • THỐNG KÊ & NHẬT KÝ
      • CÔNG CỤ TÌM KIẾM
      • TRÍCH XUẤT URL
      • KIỂM TOÁN CHUYỂN HƯỚNG
      • THEO DÕI WEBSITE
      • KIỂM TRA TRANG WEB
      • TÌM KIẾM VĂN BẢN NEO
      • WHITELIST
      • Tổng Quan
    • Project
      • MKT Tool
        • Architecture
          • Code Structure
          • System Architecture
          • Database Schema
        • Deployment
          • Local
          • Staging
          • Production
        • Internal API
          • API Interface
          • Public API
            • 2.1 Auth & User Profile
              • Đăng nhập
              • Đăng ký
              • Cập nhật Profile
            • 2.2 Search Engine & Anchor Text
              • Tạo yêu cầu quét thứ hạng
              • Lấy kết quả quét từ khóa
              • Tạo yêu cầu quét Anchor Text
            • 2.3 URL Extract & Redirect
              • Khởi tạo URL Extract
              • Khởi tạo dò tìm Redirect
            • 2.4 Check Website & Detect Domain
              • Kiểm tra Website (Content/IP)
              • Nạp data Detect Domain
            • 2.5 Track Requests & Advanced Tools
              • Tạo list Tracking
              • Webhook Add Tracking Record
            • 2.6 Whitelist & Statistic App
              • Import Whitelist
              • Ping Check Whitelist
        • Hướng dẫn sử dụng
          • TỔNG QUAN
          • CÔNG CỤ TÌM KIẾM
          • TÌM KIẾM VĂN BẢN NEO
          • TRÍCH XUẤT URL
          • SO SÁNH NỘI DUNG
          • CHUYỂN HƯỚNG URL
          • KIỂM TRA TRANG WEB
          • KIỂM TRA NỘI DUNG
          • KIỂM TRA ĐỊNH KÌ
          • THEO DÕI WEBSITE
          • TẠO TRANG WEB MKT
  1. Architecture

Code Structure

CẤU TRÚC MÃ NGUỒN (CODE STRUCTURE)#

Cấu trúc mã nguồn của dự án được tổ chức theo tiêu chuẩn của Laravel 10+, kết hợp mô hình Service - Repository Pattern nhằm phục vụ khả năng mở rộng nhanh chóng và chịu tải cao.
C:\MarketingTool
│
├── app/
│   ├── Console/            # Chứa các Custom Commands và Cấu hình Cronjob Daemon (Tác vụ đặt lịch)
│   ├── Http/
│   │   ├── Controllers/    # Điều hướng logic API & Web Views (Ví dụ: UrlExtractController)
│   │   ├── Middleware/     # Bộ lọc Request: Khóa Auth Sanctum, Roles, Whitelist Block IP...
│   │   └── Services/       # (*Business Logic*) Lớp xử lý nghiệp vụ nặng, gọi API bên ngoài
│   ├── Jobs/               # Chứa các tác vụ chạy ngầm (Queue Jobs) cho hệ thống Async Crawler
│   ├── Models/             # Eloquent Model đại diện cho Database Schema (User, SearchEngine...)
│   └── Repositories/       # Database Query Layers (Tách biệt logic truy xuất DB khỏi Controller)
│
├── build/                  # (*Tùy chỉnh bổ sung*) Nơi chứa cấu hình Dockerfile (Local/Stg/Prod)
├── config/                 # Nơi cài đặt các biến tĩnh của Hệ Thống (*.php)
│
├── database/
│   ├── migrations/         # Các file script quản lý lịch sử tạo/sửa đổi cấu trúc DB
│   └── seeders/            # Code sinh dữ liệu giả (Fake Data Generator) để test
│
├── public/                 # Thư mục public chứa file index.php, CSS/JS đã được build
├── resources/
│   ├── views/              # Chứa các giao diện UI Blade Render (Ví dụ: folder `/search-engine`)
│   └── css/ & js/          # Source Files Tailwind Config / Vite JS Build
│
├── routes/
│   ├── api.php             # Nơi định nghĩa các endpoint API cho Frontend / Tool (Dùng Sanctum)
│   ├── console.php         # Nơi định nghĩa các lịch trình chạy ngầm (Schedules/Cronjobs)
│   └── web.php             # Chứa Routes cho Frontend Blade Views
│
├── storage/                # Thư mục lưu trữ Storage Disks (File upload), Cache, Logs hệ thống
├── .env.example            # File mẫu chứa cấu hình biến môi trường của dự án
└── docker-compose.yml      # Cấu hình cài đặt System Services ảo hóa Docker (Nginx, PHP, Redis...)

Xác thực & Quản lý Phiên (Authentication & Session)#

Hệ thống Marketing Tool là một ứng dụng Client-Server (SPA/Mobile App giao tiếp với API), do đó nghiệp vụ xác thực được thiết kế theo kiến trúc Stateless Token-based thông qua thư viện Laravel Sanctum.

Sơ đồ Luồng Xác thực (Authentication Flow)#

Ngày cập nhật 2026-03-27 04:54:50
Trước
Tổng Quan
Tiếp theo
System Architecture
Built with