# One Push

## Docs
- [Tổng Quan](https://onepush-doc.nospace.network/t%E1%BB%95ng-quan-2053712m0.md): 
- Bussiness Logic [ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)](https://onepush-doc.nospace.network/%C4%91%E1%BA%B7c-t%E1%BA%A3-k%E1%BB%B9-thu%E1%BA%ADt-h%E1%BB%87-th%E1%BB%91ng-%C4%91i%E1%BB%81u-ph%E1%BB%91i-tin-nh%E1%BA%AFn-push-engine-2053713m0.md): 
- Bussiness Logic [ ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐỒNG BỘ HEARTBEAT (REAL-TIME SYNC)](https://onepush-doc.nospace.network/-%C4%91%E1%BA%B7c-t%E1%BA%A3-k%E1%BB%B9-thu%E1%BA%ADt-h%E1%BB%87-th%E1%BB%91ng-%C4%91%E1%BB%93ng-b%E1%BB%99-heartbeat-real-time-sync-2053714m0.md): 
- Bussiness Logic [ĐẶC TẢ KỸ THUẬT: HỆ THỐNG ĐIỀU PHỐI TIN NHẮN (PUSH ENGINE)](https://onepush-doc.nospace.network/%C4%91%E1%BA%B7c-t%E1%BA%A3-k%E1%BB%B9-thu%E1%BA%ADt-h%E1%BB%87-th%E1%BB%91ng-%C4%91i%E1%BB%81u-ph%E1%BB%91i-tin-nh%E1%BA%AFn-push-engine-2053715m0.md): 
- Bussiness Logic [Business Logic (Luồng Logic Nghiệp Vụ)](https://onepush-doc.nospace.network/business-logic-lu%E1%BB%93ng-logic-nghi%E1%BB%87p-v%E1%BB%A5-2053716m0.md): 
- Project [API](https://onepush-doc.nospace.network/api-7513266f0.md): 
- Project > API > Hướng dẫn sử dụng [1.1 Khởi tạo Website Tham gia](https://onepush-doc.nospace.network/1-1-kh%E1%BB%9Fi-t%E1%BA%A1o-website-tham-gia-2053718m0.md): 
- Project > API > Hướng dẫn sử dụng [1.2 Cấu hình Bots Telegram](https://onepush-doc.nospace.network/1-2-c%E1%BA%A5u-h%C3%ACnh-bots-telegram-2053719m0.md): 
- Project > API > Hướng dẫn sử dụng [1.3 Quản lý Chiến dịch (Campaigns)](https://onepush-doc.nospace.network/1-3-qu%E1%BA%A3n-l%C3%BD-chi%E1%BA%BFn-d%E1%BB%8Bch-campaigns-2053720m0.md): 
- Project > API > Hướng dẫn sử dụng [1.4 Lên Lịch Gửi Tự Động](https://onepush-doc.nospace.network/1-4-l%C3%AAn-l%E1%BB%8Bch-g%E1%BB%ADi-t%E1%BB%B1-%C4%91%E1%BB%99ng-2053721m0.md): 
- Project > API > Hướng dẫn sử dụng [1.5 Tương tác & Thống kê](https://onepush-doc.nospace.network/1-5-t%C6%B0%C6%A1ng-t%C3%A1c-th%E1%BB%91ng-k%C3%AA-2053722m0.md): 
- Project > API > Hướng dẫn sử dụng [1.6 Quản lý Tài khoản (RBAC)](https://onepush-doc.nospace.network/1-6-qu%E1%BA%A3n-l%C3%BD-t%C3%A0i-kho%E1%BA%A3n-rbac-2053723m0.md): 
- Project > API > Hướng dẫn sử dụng [1.7 Báo cáo Chi tiết Tin nhắn (Web & Telegram)](https://onepush-doc.nospace.network/1-7-b%C3%A1o-c%C3%A1o-chi-ti%E1%BA%BFt-tin-nh%E1%BA%AFn-web-telegram-2053724m0.md): 
- Project > API > Architecture [System Architecture (Kiến trúc Hệ thống)](https://onepush-doc.nospace.network/system-architecture-ki%E1%BA%BFn-tr%C3%BAc-h%E1%BB%87-th%E1%BB%91ng-2053725m0.md): 
- Project > API > Architecture [Code Structure](https://onepush-doc.nospace.network/code-structure-2053726m0.md): 
- Project > API > Architecture [Database Schema (Mô hình Dữ liệu)](https://onepush-doc.nospace.network/database-schema-m%C3%B4-h%C3%ACnh-d%E1%BB%AF-li%E1%BB%87u-2053727m0.md): 
- Project > API > Deployment [Local](https://onepush-doc.nospace.network/local-2053767m0.md): 
- Project > API > Deployment [Production](https://onepush-doc.nospace.network/production-2053728m0.md): 
- Project > API > Deployment [Development](https://onepush-doc.nospace.network/development-2053729m0.md): 
- Project > TOOL > Hướng dẫn sử dụng [Hướng dẫn sử dụng — Novu Notification Infrastructure](https://onepush-doc.nospace.network/h%C6%B0%E1%BB%9Bng-d%E1%BA%ABn-s%E1%BB%AD-d%E1%BB%A5ng-novu-notification-infrastructure-2053730m0.md): 
- Project > TOOL > Architecture [System Architecture](https://onepush-doc.nospace.network/system-architecture-2053731m0.md): 
- Project > TOOL > Architecture [Code Structure](https://onepush-doc.nospace.network/code-structure-2053732m0.md): 
- Project > TOOL > Architecture [Database Schema](https://onepush-doc.nospace.network/database-schema-2053733m0.md): 
- Project > TOOL > Deployment [Deployment](https://onepush-doc.nospace.network/deployment-2053735m0.md): 
- Project > TOOL [API](https://onepush-doc.nospace.network/api-7513286f0.md): 

## API Docs
- Project > API > API > Widget nhúng Website [Đăng ký Subscriber mới / Nhật ký Heartbeat](https://onepush-doc.nospace.network/%C4%91%C4%83ng-k%C3%BD-subscriber-m%E1%BB%9Bi-nh%E1%BA%ADt-k%C3%BD-heartbeat-31723032e0.md): API trái tim của hệ thống. Được widget gọi mỗi khi trang web tải xong để báo cáo người dùng đang online hoặc đăng ký mới.
- Project > API > API > Widget nhúng Website [Cập nhật trạng thái Seen/Read](https://onepush-doc.nospace.network/c%E1%BA%ADp-nh%E1%BA%ADt-tr%E1%BA%A1ng-th%C3%A1i-seenread-31723033e0.md): Đồng bộ trạng thái tin nhắn khi người dùng xem thông báo hoặc click nút.
- Project > API > API > Widget nhúng Website [Ghi nhận hiển thị Alert Popup](https://onepush-doc.nospace.network/ghi-nh%E1%BA%ADn-hi%E1%BB%83n-th%E1%BB%8B-alert-popup-31723034e0.md): Ghi nhận log vào hệ thống ngay khi cửa sổ Alert (Force Popup / Center) vừa xuất hiện trên thiết bị của người dùng để đo lường Imression chính xác.
- Project > API > API > Widget nhúng Website [Lấy dữ liệu Alert cho website](https://onepush-doc.nospace.network/l%E1%BA%A5y-d%E1%BB%AF-li%E1%BB%87u-alert-cho-website-31723035e0.md): Cung cấp tải trọng (Payload) cấu hình Alert động cho Client JS (Title, Content, URL Icon, Buttons) tùy thuộc vào Client Token và cài đặt của Campaign đang Active.
- Project > API > API > Tracking & Tương tác [Ghi nhận lựa chọn Yes/No](https://onepush-doc.nospace.network/ghi-nh%E1%BA%ADn-l%E1%BB%B1a-ch%E1%BB%8Dn-yesno-31723036e0.md): Ghi lại tương tác của người dùng trên popup (Chọn Có/Không/Tắt).
- Project > API > API >  Báo cáo & Thống kê [Thống kê người dùng Real-time](https://onepush-doc.nospace.network/th%E1%BB%91ng-k%C3%AA-ng%C6%B0%E1%BB%9Di-d%C3%B9ng-real-time-31723037e0.md): API Socket-Like truy xuất lượng người dùng online trong 5 phút qua thông qua cơ chế đếm Heartbeat từ Redis siêu tốc.
- Project > API > API >  Báo cáo & Thống kê [Phân tích tăng trưởng Subscriber](https://onepush-doc.nospace.network/ph%C3%A2n-t%C3%ADch-t%C4%83ng-tr%C6%B0%E1%BB%9Fng-subscriber-31723038e0.md): Trả về dữ liệu vẽ Biểu đồ (Trend Chart) sự tăng trưởng người đăng ký mới (Subscribers) trong N ngày để team Marketing đánh giá hiệu suất.
- Project > API > API >  Báo cáo & Thống kê [Dữ liệu bản đồ nhiệt Vị trí](https://onepush-doc.nospace.network/d%E1%BB%AF-li%E1%BB%87u-b%E1%BA%A3n-%C4%91%E1%BB%93-nhi%E1%BB%87t-v%E1%BB%8B-tr%C3%AD-31723039e0.md): Gom nhóm (Group by) số lượng người đăng ký theo Quốc gia và Ngôn ngữ (Language) phục vụ vẽ Heatmap trên bản đồ thế giới.
- Project > API > API >  Báo cáo & Thống kê [Xuất báo cáo thông báo Excel](https://onepush-doc.nospace.network/xu%E1%BA%A5t-b%C3%A1o-c%C3%A1o-th%C3%B4ng-b%C3%A1o-excel-31723040e0.md): Xuất toàn bộ dữ liệu thống kê Gửi tin, Nhận tin, Click (CTR) thành file Excel (.xlsx) thông qua thư viện Box/Spout.
- Project > API > API > Lịch gửi Thông báo [Danh sách lịch gửi thông báo](https://onepush-doc.nospace.network/danh-s%C3%A1ch-l%E1%BB%8Bch-g%E1%BB%ADi-th%C3%B4ng-b%C3%A1o-31723041e0.md): Lấy danh sách phân trang (Pagination) toàn bộ lịch gửi thông báo (Cronjobs, SendNow, Repeat) kèm trạng thái kích hoạt hiện tại.
- Project > API > API > Lịch gửi Thông báo [Tạo lịch gửi mới](https://onepush-doc.nospace.network/t%E1%BA%A1o-l%E1%BB%8Bch-g%E1%BB%ADi-m%E1%BB%9Bi-31723042e0.md): API khởi tạo một Kế hoạch Gửi tin (Schedule) mới. Cấu trúc Payload phức tạp bao gồm các Rule (Repeat, Day) và Template cấu hình Widget.
- Project > API > API > Lịch gửi Thông báo [Bật/Tắt lịch gửi](https://onepush-doc.nospace.network/b%E1%BA%ADtt%E1%BA%AFt-l%E1%BB%8Bch-g%E1%BB%ADi-31723043e0.md): Bật/Tắt nhanh một lịch gửi đang tự động chạy lặp lại (ngưng Dispatch Job Mới) bằng cách lật trạng thái Active Y/N.
- Project > API > API > Betting Tips [Lấy Tip bóng đá HOT nhất](https://onepush-doc.nospace.network/l%E1%BA%A5y-tip-b%C3%B3ng-%C4%91%C3%A1-hot-nh%E1%BA%A5t-31723044e0.md): API truy xuất tự động dữ liệu Kèo bóng đá nổi bật nhất (Best Odds) từ các nhà cái thể thao để gắn luồng tự động bắn Push Notification.
- Project > API > API > Betting Tips [Lấy dữ liệu Mock Tip (Test)](https://onepush-doc.nospace.network/l%E1%BA%A5y-d%E1%BB%AF-li%E1%BB%87u-mock-tip-test-31723045e0.md): API sinh dữ liệu ảo (Mockup Kèo Bóng Đá) giúp Frontend test giao diện Ticket mà không cần tốn Request quota gọi về Nguồn Thể thao thật.
- Project > API > API > Telegram Integration [Danh sách Telegram Bot](https://onepush-doc.nospace.network/danh-s%C3%A1ch-telegram-bot-31723046e0.md): Load danh sách các Bot Telegram đã được tích hợp vào hệ thống bằng API Token botFather.
- Project > API > API > Telegram Integration [Telegram Webhook Endpoint](https://onepush-doc.nospace.network/telegram-webhook-endpoint-31723047e0.md): Endpoint duy nhất tiếp nhận HTTP POST Webhook trực tiếp từ máy chủ Telegram khi có người dùng chat, click nút hoặc gia nhập nhóm.
- Project > API > API > Email Marketing [Tạo và gửi chiến dịch Email](https://onepush-doc.nospace.network/t%E1%BA%A1o-v%C3%A0-g%E1%BB%ADi-chi%E1%BA%BFn-d%E1%BB%8Bch-email-31723048e0.md): Đẩy danh sách Email hoặc khối CSV lớn của tập khách hàng vào hàng đợi Laravel để hệ thống Mailer nhả dần, tránh bị đưa vào Spam.
- Project > API > API > Hệ thống & RBAC [Danh sách tài khoản Admin/Nhân viên](https://onepush-doc.nospace.network/danh-s%C3%A1ch-t%C3%A0i-kho%E1%BA%A3n-adminnh%C3%A2n-vi%C3%AAn-31723049e0.md): Liệt kê danh sách tài khoản Admin & Staff nội bộ quản trị hệ thống kèm phân quyền (Role) tương ứng.
- Project > API > API > Hệ thống & RBAC [Danh sách vai trò (Roles)](https://onepush-doc.nospace.network/danh-s%C3%A1ch-vai-tr%C3%B2-roles-31723050e0.md): Bổ trợ cho mục RBAC (Role-Based Access Control) liệt kê vai trò và thẩm quyền cụ thể của từng Role.
- Project > API > API > Tiện ích & Files [Truy xuất nhật ký hệ thống (System Logs)](https://onepush-doc.nospace.network/truy-xu%E1%BA%A5t-nh%E1%BA%ADt-k%C3%BD-h%E1%BB%87-th%E1%BB%91ng-system-logs-31723051e0.md): API cấp phép đọc file text .log vật lý của Laravel (storage/logs) hỗ trợ bộ công cụ Log Viewer Frontend.
- Project > API > API > Chiến dịch (Campaigns) [Danh sách chiến dịch](https://onepush-doc.nospace.network/danh-s%C3%A1ch-chi%E1%BA%BFn-d%E1%BB%8Bch-31723052e0.md): Liệt kê danh sách nhóm Chiến dịch. Dùng để lấy Campaign ID trước khi nhóm các Schedules vào chung một luồng Marketing.
- Project > API > API > Website Khách hàng (Clients) [Danh sách website khách hàng](https://onepush-doc.nospace.network/danh-s%C3%A1ch-website-kh%C3%A1ch-h%C3%A0ng-31723053e0.md): Cung cấp danh sách các hệ thống/website (Client) đang kết nối với hệ sinh thái One Push kèm Token mã nhúng của chúng.
- Project > API > API > Quản lý Thành viên (Subscribers) [Danh sách người đăng ký (Subscribers)](https://onepush-doc.nospace.network/danh-s%C3%A1ch-ng%C6%B0%E1%BB%9Di-%C4%91%C4%83ng-k%C3%BD-subscribers-31723054e0.md): Hiển thị chi tiết hàng triệu người dùng cuối (Device / Token FCM / PAM ID) cùng lịch sử tương tác của từng user con.
- Project > API > API > Quản lý Thành viên (Subscribers) [Xóa người nhận tin](https://onepush-doc.nospace.network/x%C3%B3a-ng%C6%B0%E1%BB%9Di-nh%E1%BA%ADn-tin-31723055e0.md): API Hủy đăng ký thủ công từ phía Admin - Đóng gói quyền xóa Device ID ra khỏi hệ thống vĩnh viễn.
- Project > TOOL > API > 👥 Subscribers [Tạo/Cập nhật Subscriber](https://onepush-doc.nospace.network/t%E1%BA%A1oc%E1%BA%ADp-nh%E1%BA%ADt-subscriber-31723056e0.md): 
- Project > TOOL > API > 👥 Subscribers [Cập nhật Profile](https://onepush-doc.nospace.network/c%E1%BA%ADp-nh%E1%BA%ADt-profile-31723057e0.md): 
- Project > TOOL > API > 🗺️ Workflows [Lấy danh sách Workflow Templates](https://onepush-doc.nospace.network/l%E1%BA%A5y-danh-s%C3%A1ch-workflow-templates-31723058e0.md): 
- Project > TOOL > API > 🗺️ Workflows [Chi tiết Workflow](https://onepush-doc.nospace.network/chi-ti%E1%BA%BFt-workflow-31723059e0.md): 
- Project > TOOL > API > 📂 Notification History [Lịch sử biến động Notification](https://onepush-doc.nospace.network/l%E1%BB%8Bch-s%E1%BB%AD-bi%E1%BA%BFn-%C4%91%E1%BB%99ng-notification-31723060e0.md): 
- Project > TOOL > API > 🎯 Topics [Tạo Topic mới](https://onepush-doc.nospace.network/t%E1%BA%A1o-topic-m%E1%BB%9Bi-31723061e0.md): 
- Project > TOOL > API > 📐 Layouts [Lấy danh sách Layout (Email/Web)](https://onepush-doc.nospace.network/l%E1%BA%A5y-danh-s%C3%A1ch-layout-emailweb-31723062e0.md): 
- Project > TOOL > API > 💬 Messages [Tra cứu vết tin nhắn chi tiết (Low-level)](https://onepush-doc.nospace.network/tra-c%E1%BB%A9u-v%E1%BA%BFt-tin-nh%E1%BA%AFn-chi-ti%E1%BA%BFt-low-level-31723063e0.md): 
- Project > TOOL > API > 🔌 Integrations [Danh sách nhà cung cấp (Providers)](https://onepush-doc.nospace.network/danh-s%C3%A1ch-nh%C3%A0-cung-c%E1%BA%A5p-providers-31723064e0.md): 
- Project > TOOL > API > 🚀 Events & Triggers [Kích hoạt thông báo (Workflows)](https://onepush-doc.nospace.network/k%C3%ADch-ho%E1%BA%A1t-th%C3%B4ng-b%C3%A1o-workflows-31723065e0.md): Đầu nạp dữ liệu chính để gửi tin nhắn đến Subscriber dựa trên Template.
- Project > TOOL > API > 🚀 Events & Triggers [Kích hoạt hàng loạt (Bulk Trigger)](https://onepush-doc.nospace.network/k%C3%ADch-ho%E1%BA%A1t-h%C3%A0ng-lo%E1%BA%A1t-bulk-trigger-31723066e0.md): 

## Schemas
- [GenericResponse](https://onepush-doc.nospace.network/genericresponse-13839414d0.md):