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