1. Deployment
One Push
  • Tổng quan hệ thống
  • Bussiness Logic
    • Business Logic
    • HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
    • HỆ THỐNG ĐỒNG BỘ HEARTBEAT (REAL-TIME SYNC)
    • HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)
  • Project
    • API
      • Tổng quan 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)
      • 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
      • Architecture
        • System Architecture (Kiến trúc Hệ thống)
        • Code Structure
        • Database Schema (Mô hình Dữ liệu)
      • Deployment
        • Local
        • Production
        • Development
    • TOOL
      • Tổng quan 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
      • 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)
      • Deployment
        • Deployment
  • Schemas
    • NotificationWidget
    • TrackingStats
    • NotificationSchedule
  1. Deployment

Local

DockerLaravelMySQLGitLab

Cài đặt môi trường Lập trình (Local Development)#

Tài liệu hướng dẫn setup môi trường Local dành cho Developer tham gia hệ thống One Push.

🛠️ 1. Yêu cầu hệ thống (Prerequisites)#

Môi trường phát triển sử dụng Docker để đồng bộ giữa các thiết bị. Tính năng Bind Mount đã được kích hoạt, các Code thay đổi sẽ được cập nhật liên tục (Hot Reload) vào Container mà không cần Build lại Image.
ComponentVersionChú thích
PHP≥ 8.2Ngôn ngữ API chạy trên Container Linux.
MariaDB / MySQL10.11Cơ sở dữ liệu lưu trữ cấu hình, lịch gửi và Log.
Redis7.xDùng làm Cache Driver và Queue Connection cho Horizon.
Node.jsv20+Phục vụ Vite (Frontend build) và Puppeteer.

🏗️ 2. Cấu trúc thư mục#


🚀 3. Các bước cài đặt luồng One Push#

Hướng dẫn thiết lập dự án lần đầu trên máy Local.

Bước 1: Clone mã nguồn#


Bước 3: Khởi chạy Docker#

Lệnh khởi chạy Web, DB, Redis ở chế độ chìm (background).

Bước 4: Thiết lập dự án (Trong container)#

Chạy các lệnh này để hoàn tất việc cài đặt thư viện và khởi tạo Database.

⚡ 4. Quy trình làm việc (Daily Workflow)#

Khi phát triển tính năng, bạn chỉ cần giữ Docker đang chạy. Mọi thay đổi code sẽ được tự động cập nhật (Hot Reload qua Bind Mount).

🔹 Truy cập ứng dụng#

Mở trình duyệt và truy cập: http://localhost:801 (Vì Docker đã thay thế hoàn toàn lệnh php artisan serve).

🔹 Xử lý Hàng Đợi (Queue Worker)#

Bắt buộc duy trì một Terminal chạy lệnh này nếu bạn đang phát biểu các tính năng Gửi thông báo (Đặt lịch, Delay, Vòng lặp):

🔹 Chỉnh sửa giao diện (Tùy chọn)#

Chỉ khi bạn muốn sửa CSS/JS và muốn hệ thống biên dịch ngay lập tức (Vite), hãy chạy lệnh:

🧪 5. Testing & QC#

Trước khi Push code, bạn hãy chạy bộ Test để đảm bảo không làm "hư" các logic cũ:

📚 6. Lưu ý quan trọng cho môi trường Dev#

🔄 Cơ chế Docker Bind Mount: Trong file docker-compose.yml, thư mục chứa dự án hiện hành đã được mount trực tiếp vào hệ trục /var/www/html bên trong Container API. Do đó, bạn code trên VS Code hay PhpStorm thì trong Docker cũng nhận được Source Code mới ngay lập tức.
📧 Chặn Luồng MailHog: File .env nội bộ đã có sẵn config điều hướng mọi Email bắt vào cổng lưới MailHog (Port 1025). Tất cả Request đẩy gửi Email OTP/Cảnh báo bảo mật từ luồng One Push ra thế giới bên ngoài sẽ bị ngắt và giả lập hiển thị trên giao diện Web cục bộ. Tuyệt đối yên tâm không bao giờ vô tình Spam gửi Spam trúng luồng Email tài khoản nhà đầu tư nội bộ.

📚 7. Hướng dẫn đăng ký Firebase#

Bước 1: Truy cập vào đường link https://console.firebase.google.com/ sau đó đăng nhập#

Ảnh màn hình 2026-04-09 lúc 09.51.15.png

Bước 2: Tạo project mới và điền đầy đủ thông tin cơ bản của Google sau đó đợi ít phút để Google tạo dự án #

Ảnh màn hình 2026-04-09 lúc 09.52.59.png

Bước 3: truy cập vào setting > General > Your apps > Webs #

Ảnh màn hình 2026-04-09 lúc 10.00.04.png

Bước 4: Tạo dư án sau đó copy SDK được cung cấp #

Ảnh màn hình 2026-04-09 lúc 10.01.11.png

Bước 5: Truy cập vào https://web-dev.1now.pro/ chọn connect Provider > Push > Firebase Cloud Messaging#

🚀 Quy trình Triển Khai và theo dõi Novu#

Việc gửi thông báo sẽ được theo dõi ở link https://web-dev.1now.pro/
Ảnh màn hình 2026-04-09 lúc 10.10.51.png
Modified at 2026-04-09 07:45:39
Previous
Database Schema (Mô hình Dữ liệu)
Next
Production
Built with