Tài liệu kỹ thuật - Phiên bản 3.7.0
Mô tả chức năng, kiến trúc và quy trình vận hành của Core Notification Admin (One Push).
1. Giới thiệu#
One Push Notification là hệ thống quản trị tập trung, được thiết kế để hỗ trợ quản trị viên vận hành thiết lập, lên lịch và phân phối tự động các thông báo, sự kiện, chương trình khuyến mãi đến hàng trăm ngàn hội viên thông qua nền tảng trung gian (Novu API) một cách hiệu quả và có kiểm soát.Giá trị cốt lõi#
| Giá trị | Mô tả |
|---|
| ⚡ Phân phối tự động | Giảm thiểu thao tác thủ công trong việc hẹn giờ gửi tin, soi tỷ lệ kèo, chăm sóc khách hàng. |
| 🛡️ Vận hành an toàn | Tích hợp cơ chế Rate Limit chia lô và Circuit Breaker tự ngắt kết nối mạng bảo vệ máy chủ. |
| 🌐 Mở rộng Đa kênh | Một mẫu biên tập có thể phát sóng đồng thời qua Web App, Telegram Bot và Email cùng lúc. |
| 📊 Giám sát thời gian thực | Tracking và ghi vệt trạng thái gửi (Thành công, Thất bại, Chờ gửi) qua giao dịch transactionId. |
2. Kiến trúc tổng thể#
3. Các phân hệ chức năng (Nhóm APIs)#
Hệ thống được chia nhỏ thành các nhóm phân hệ nghiệp vụ API chính để dễ điều phối và tương tác với Frontend:3.1. Phân hệ Quản lý Lịch phát sóng (Scheduler API)#
Đảm nhận luồng dữ liệu sống yếu của toàn bộ chiến dịch:Cung cấp toàn bộ các phương thức Tạo, Đọc, Cập nhật, Xóa cho các kế hoạch nhắn tin.
Hệ thống hỗ trợ xử lý tắt/mở nóng trạng thái hoạt động (Toggle Active/Inactive) bằng 1 click.
Hỗ trợ lưu trữ, phân trang (limit, offset) và tìm kiếm từ khoá trong mạng lưới dữ liệu khổng lồ.
3.2. Phân hệ Định tuyến Kênh & Định dạng (Routing)#
Tiếp nhận nội dung và "nhào nặn" thành khuôn mẫu phù hợp cho bên nhận:Chuyên biệt hóa khung ảnh theo vị trí dạng Top (75x75), Popup (80x80) hoặc Center Banner (500x250).
Xác thực liên kết (Link Validate) đảm bảo mọi nút đẩy qua (CTA) đều hướng người chơi đến trang hợp lệ.
Phân luồng tín hiệu bắn gửi tới Web Browser, Email hoặc ứng dụng Telegram của hội viên thông qua tùy chọn kênh nhận (send_to_app).
3.3. Tự động hóa Soi kèo (Auto Betting Hooks)#
Giảm tải khối lượng công việc thao tác tay của quản trị viên:Kéo và đổ dữ liệu trận bóng đá (Tỷ lệ cược, Logo sân nhà/Sân khách, Thời gian) qua Service nối thẳng vào dữ liệu nguồn db.winfast.dev.
Trực tiếp xử lý logic (Parse) số liệu khô khốc để tự động chuyển hóa thành 1 mẫu quảng cáo tỷ lệ hấp dẫn nhất (Best odds).
Hỗ trợ xem trước mô phỏng giao diện (Preview API) tránh gửi nhầm mẩu tin lỗi cho máy khách.
3.4. Quản trị Báo cáo & Lịch sử gửi (Tracking API)#
Giám sát hiệu suất vận hành của các chiến dịch đã lên sóng:Truy vấn ngược lại hệ thống Novu qua mã định danh transactionId để truy vết tình trạng phát tới từng cá nhân (đã nhận, đã xem, hay bị lỗi báo chặn).
Rà soát lịch sử, phục vụ đối soát khi có sự kiện than phiền từ khách hàng là không nhận được khuyến mãi.
4. Quy trình vận hành#
Luồng thao tác tiêu chuẩn dành cho người điều hành hệ thống:1.
✍️ Khởi tạo dữ liệu: Người vận hành chọn dạng thông báo (Cảnh báo tĩnh hoặc Tỷ lệ kèo động). Điền nội dung và đính kèm đường liên kết, ảnh minh hoạ.
2.
🎯 Cài đặt Quy tắc: Lọc tập đối tượng người nhận (toàn mạng lưới hay cá nhân VIP cụ thể) và chọn đúng ngày/giờ bung lụa chu kỳ gửi.
3.
🚀 Kích hoạt System: Gạt bật Active bản khai báo để bảng điều khiển ghi nhận và nhấc nháp vào Hàng đợi Vận hành (Cron Queue).
4.
⚙️ Phân phối vòng lặp: Phía sau hậu trường, lập trình nhặt từng "đùm" 10 thư một lần để nhường đường truyền Internet. Tính năng tự sửa chữa hoặc báo hoãn nếu bên Gateway Novu nghẽn mạng.
Modified at 2026-03-30 16:43:06
