TỔNG QUAN HỆ SINH THÁI ONE PUSH ADMIN

1. 📘 HƯỚNG DẪN SỬ DỤNG (USER GUIDE)

One Push Admin là hệ sinh thái tự động hoá tương tác đa kênh (Web Push, Telegram, Email). Hãy làm theo luồng thao tác chuẩn dưới đây:

Bước	Phân hệ		Kết quả kỳ vọng
01	Clients	Nhập Tên miền & Kích hoạt Report	Hệ thống cấp mã nhúng & Client Token
02	Telegram	Khai báo API Token từ `@BotFather`	Webhook tự động kích hoạt cho Bot
03	Campaigns	Khởi tạo thư mục Chiến dịch	Gom nhóm thống kê CTR cho Marketing
04	Layouts	Lựa chọn Notification Type	Xác định vị trí hiển thị (Center/Top/Popup)
05	Schedules	Thiết lập Cronjob (Ngay/Hẹn giờ/Lặp)	Tin nhắn được nạp vào hàng đợi Redis

Hệ thống giao tiếp thông qua thiết kế Stateless RESTful API với định dạng JSON đồng nhất.

Cookie Session: Bảo mật giao diện Admin Dashboard (auth middleware).

Client Token: Định danh các yêu cầu từ Widget nhúng (token header/body).

{
  "success": true,
  "message": "Thao tác thành công",
  "data": { "subscriber_id": "PAM_001", "status": "active" }
}

Cấu trúc Entity-Relationship (ERD) tập trung vào hiệu năng xử lý hàng triệu Subscribers.

Sử dụng kiến trúc hàng đợi phân tán để đảm bảo không nghẽn mạng (Non-blocking I/O).

Dự án được tổ chức chuẩn Laravel 10 kết hợp với bộ công cụ Automation Node.js.

Folder	Chức năng
`app/Models/`	Eloquent Models	Định nghĩa quan hệ DB & Data Sanitization
`app/Controllers/`	Request Handlers	Điều hướng nghiệp vụ tới Jobs/Services
`app/Jobs/`	Queue Processing	Chốt chặn xử lý gửi Push ngầm (Asynchronous)
`Node Scripts/`	Automation Tools	Chạy Puppeteer test, Parse API & Doc compile

One Push System - Hệ thống thông báo thông minh cho kỷ nguyên tương tác số.