1. Architecture
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. Architecture

System Architecture

System Architecture — Novu Infrastructure Engine#

Hệ thống Novu được thiết kế theo kiến trúc Monorepo với khả năng chịu tải cực lớn (Scalable), chia nhỏ các tác vụ thông qua hàng đợi không đồng bộ.

MỤC LỤC#

1.
🟦 Sơ đồ Kiến trúc (Architecture Overview)
2.
🟩 Thành phần Dịch vụ (Apps)
3.
🟪 Thành phần Hạ tầng (Infrastructure)

Architecture#

Sơ đồ dưới đây mô tả luồng dữ liệu từ khi có sự kiện Trigger đến khi tin nhắn được gửi đi thực tế:

Apps#

Dịch vụCông nghệVai trò chủ chốt
APINestJSTiếp nhận Trigger và quản lý Dashboard Backend
WorkerNode.jsBộ máy Render Template và gọi Provider API
WSSocket.ioĐẩy thông báo In-app real-time đến Client
WebhNestJSTiếp nhận Webhook trạng thái từ nhà cung cấp

Infra#

Hệ thống phụ thuộc vào 3 thành phần trụ cột sau:
1. MongoDB (Primary Database)
Lưu trữ toàn bộ dữ liệu tĩnh và động (Workflows, Subscribers, Messages). Đảm bảo tính nhất quán (Consistency) của dữ liệu xuyên suốt các phiên bản.
2. Redis (Message Broker)
Bộ định tuyến hàng đợi cực nhanh cho BullMQ, giúp duy trì trạng thái hàng triệu Job không đồng bộ mỗi phút mà không bị tắc nghẽn.
3. Storage (S3/Local)
Lưu trữ các Assets tĩnh như hình ảnh, mẫu Layout phức tạp và các file đính kèm phục vụ cho luồng gửi tin Email.
Modified at 2026-03-27 03:49:16
Previous
Hướng dẫn sử dụng — Novu Notification Infrastructure
Next
Code Structure
Built with