1. Deployment
One Push
  • Tổng Quan
  • Bussiness Logic
    • ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
    • ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐỒNG BỘ HEARTBEAT (REAL-TIME SYNC)
    • ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
    • Business Logic (Luồng Logic Nghiệp Vụ)
  • Project
    • API
      • Hướng dẫn sử dụng
        • 1.1 Khởi tạo Website Tham gia
        • 1.2 Cấu hình Bots Telegram
        • 1.3 Quản lý Chiến dịch (Campaigns)
        • 1.4 Lên Lịch Gửi Tự Động
        • 1.5 Tương tác & Thống kê
        • 1.6 Quản lý Tài khoản (RBAC)
        • 1.7 Báo cáo Chi tiết Tin nhắn (Web & Telegram)
      • Architecture
        • System Architecture (Kiến trúc Hệ thống)
        • Code Structure
        • Database Schema (Mô hình Dữ liệu)
      • Deployment
        • Local
        • Production
        • Development
      • API
        • Widget nhúng Website
          • Đăng ký Subscriber mới / Nhật ký Heartbeat
          • Cập nhật trạng thái Seen/Read
          • Ghi nhận hiển thị Alert Popup
          • Lấy dữ liệu Alert cho website
        • Tracking & Tương tác
          • Ghi nhận lựa chọn Yes/No
        • Báo cáo & Thống kê
          • Thống kê người dùng Real-time
          • Phân tích tăng trưởng Subscriber
          • Dữ liệu bản đồ nhiệt Vị trí
          • Xuất báo cáo thông báo Excel
        • Lịch gửi Thông báo
          • Danh sách lịch gửi thông báo
          • Tạo lịch gửi mới
          • Bật/Tắt lịch gửi
        • Betting Tips
          • Lấy Tip bóng đá HOT nhất
          • Lấy dữ liệu Mock Tip (Test)
        • Telegram Integration
          • Danh sách Telegram Bot
          • Telegram Webhook Endpoint
        • Email Marketing
          • Tạo và gửi chiến dịch Email
        • Hệ thống & RBAC
          • Danh sách tài khoản Admin/Nhân viên
          • Danh sách vai trò (Roles)
        • Tiện ích & Files
          • Truy xuất nhật ký hệ thống (System Logs)
        • Chiến dịch (Campaigns)
          • Danh sách chiến dịch
        • Website Khách hàng (Clients)
          • Danh sách website khách hàng
        • Quản lý Thành viên (Subscribers)
          • Danh sách người đăng ký (Subscribers)
          • Xóa người nhận tin
    • TOOL
      • Hướng dẫn sử dụng
        • Hướng dẫn sử dụng — Novu Notification Infrastructure
      • Architecture
        • System Architecture
        • Code Structure
        • Database Schema
      • Deployment
        • Deployment
      • API
        • 👥 Subscribers
          • Tạo/Cập nhật Subscriber
          • Cập nhật Profile
        • 🗺️ Workflows
          • Lấy danh sách Workflow Templates
          • Chi tiết Workflow
        • 📂 Notification History
          • Lịch sử biến động Notification
        • 🎯 Topics
          • Tạo Topic mới
        • 📐 Layouts
          • Lấy danh sách Layout (Email/Web)
        • 💬 Messages
          • Tra cứu vết tin nhắn chi tiết (Low-level)
        • 🔌 Integrations
          • Danh sách nhà cung cấp (Providers)
        • 🚀 Events & Triggers
          • Kích hoạt thông báo (Workflows)
          • Kích hoạt hàng loạt (Bulk Trigger)
  • Schemas
    • GenericResponse
  1. Deployment

Development

Tài Liệu Triển Khai Dự Án One Push — Development (Môi trường Phát triển)#

Docker  Laravel  PostgreSQL  GitHub

Cài Đặt & Phát Triển Dự Án One Push Local

🛠️ Tổng Quan Môi Trường Dev#

Môi trường phát triển được tối ưu để hỗ trợ lập trình viên (Developer) thực hiện các thay đổi mã nguồn ngay lập tức (Hot Reload / Bind Mount) mà không cần build lại image.
Công CụPhiên BảnGhi Chú
PHP≥ 8.2Chạy trên Container hoặc Local
MariaDB10.11CSDL Phát triển
Redis7.xChạy trên Container
Node.jsv20+Dùng cho Vite & Puppeteer

🏗️ Cấu Trúc Dự Án Dev#

OnePush/
├─ .env.example
├─ docker-compose.yml                           # Chế độ Native Docker cho Dev
├─ package.json                                 # Quản lý Frontend (Vite)
├─ composer.json                                # Quản lý Backend (Laravel)
└─ docs/                                        # Bộ tài liệu phát triển

🚀 Các Bước Cài Đặt Ban Đầu#

1. Clone & Setup Mã nguồn#

2. Cài đặt Dependencies#

3. Build & Khởi động Docker Dev#

Sử dụng file docker-compose.yml mặc định để chạy môi trường nền.

4. Thiết lập CSDL & Key#

⚡ Luồng Làm Việc (Daily Workflow)#

Việc phát triển Frontend và Backend diễn ra đồng thời:
1.
Frontend: Chạy Server Vite để biên dịch assets tự động.
2.
Backend: Chạy Server PHP.
3.
Queue: Chạy Worker Horizon để test tính năng bắn Push.

🧪 Chạy Kiểm Thử (Testing)#

Mọi thay đổi code mới phải đảm bảo không phá vỡ các tính năng cũ.

📚 Ghi Chú Quan Trọng#

Bind Mount: Trong docker-compose.yml bản Dev, mã nguồn sẽ được mount (liên kết) trực tiếp. Mọi thay đổi code trên VS Code của bạn sẽ được phản ánh ngay lập tức vào Container.
MailHog: Môi trường Dev tích hợp sẵn MailHog (port 1025) để bắt các email thông báo OTP mà không cần gửi ra ngoài internet.
Modified at 2026-03-27 03:49:16
Previous
Production
Next
Đăng ký Subscriber mới / Nhật ký Heartbeat
Built with