TÀI LIỆU TỔNG QUAN NGHIỆP VỤ HỆ THỐNG (SYSTEM BUSINESS OVERVIEW)

Tài liệu này cung cấp bức tranh toàn cảnh về luồng nghiệp vụ (Business Logic) của toàn bộ hệ sinh thái sinh thái phần mềm, bao gồm Tổ hợp Quản trị Trung tâm (Admin Frontend) và Động cơ Xử lý Tác vụ Ngầm (Worker/API Backend). Hệ thống được thiết kế để tự động hóa quy trình giám sát tên miền, đo lường SEO và trích xuất bằng chứng đa phương tiện.

I. BẢNG MA TRẬN PHÂN HỆ NGHIỆP VỤ (BUSINESS MODULES MATRIX)

Dưới đây là bảng tổng hợp các phân hệ nghiệp vụ, thành phần chịu trách nhiệm và kết quả đầu ra của từng quy trình.

Phân hệ Nghiệp vụ (Business Module)	Thành phần Xử lý (System Component)	Quy trình Nghiệp vụ Cốt lõi (Core Business Flow)	Kết quả Đầu ra (Output / Artifact)
1. Định danh & Phân quyền	Admin Frontend (Vue 3 / Pinia)	Quản lý phiên làm việc, phân cấp quyền hạn (RBAC), duy trì phiên đăng nhập không gián đoạn (Silent Token Refresh Queueing).	Hồ sơ định danh an toàn, giới hạn hạn mức (Quota) truy cập.
2. Quản lý Mục tiêu & Mạng lưới	Admin Frontend (Vue 3)	Lập danh sách Tên miền (Whitelist/Blocklist), thiết lập Từ khóa SEO cần theo dõi, cấu hình mạng lưới Proxy/Provider phân giải IP.	Danh sách Target hợp lệ sẵn sàng đẩy xuống hệ thống quét.
3. Cổng Điều phối Tác vụ	API Gateway (ElysiaJS / Bun)	Tiếp nhận lệnh quét (Đơn lẻ/Hàng loạt), kiểm soát tải (Concurrency limit), định tuyến yêu cầu xuống Hàng đợi (Queue).	Bản ghi Task (Pending) lưu trữ trong MongoDB.
4. Động cơ Trích xuất Dữ liệu	Worker Threads (Puppeteer / Node.js)	Nhận Task, giả lập thiết bị & mạng, truy cập ẩn danh (Stealth), quét DOM HTML tìm từ khóa, ghi nhận luồng XHR ngầm.	Dữ liệu Text (Keyword matching, Network logs).
5. Kết xuất Đa phương tiện	Media Engine (FFmpeg / Puppeteer)	Quay video màn hình tiến trình duyệt web, chụp ảnh Snapshot dựa trên cờ cho phép (isAcceptRecord).	File Media (.mp4, .png, .jpg) lưu trữ Local.
6. Phân phối & Lưu trữ Đám mây	Post-Processing (Node.js / Axios)	Đẩy file Media lên Cloud (S3), đóng gói payload kết quả, gọi Webhook trả về CMS gốc.	Cloud URL, Trạng thái Task (Completed/Failed).
7. Giám sát & Khôi phục sự cố	Background Jobs & Telegram Bot	Đếm Task tồn đọng, tự động Reset Task bị treo quá 6 phút, gửi cảnh báo ngoại lệ (Exception) tới kỹ thuật viên.	Log vận hành, Thông báo Telegram, Hệ thống tự phục hồi.
8. Đo lường & Thống kê SEO	Admin Frontend (Chart.js)	Nhận dữ liệu Webhook, cập nhật thứ hạng (Ranking) lịch sử, phân tích biến động Growth Hack, trực quan hóa qua biểu đồ.	Báo cáo Dashboard, Cảnh báo xu hướng SEO.

II. CHI TIẾT NGHIỆP VỤ THEO TỪNG PHÂN HỆ (DETAILED BUSINESS LOGIC)

MODULE 1: QUẢN TRỊ TRUNG TÂM & BẢO MẬT (CENTRAL ADMIN & SECURITY)

Kiểm soát truy cập (Access Control): Nghiệp vụ yêu cầu phân tách rõ ràng quyền xem, sửa, quản trị (view, edit, admin, superadmin) và phân quyền chức năng sâu (Capture, CheckDomain, Upload). Điều này đảm bảo an toàn dữ liệu nội bộ.

Trải nghiệm xác thực liền mạch (Seamless Authentication): Để giải quyết vấn đề phiên làm việc hết hạn giữa chừng làm mất dữ liệu người dùng đang nhập liệu, nghiệp vụ áp dụng cơ chế "Silent Refresh Queueing". Mọi Request API bị treo tạm thời trong bộ nhớ khi Token hết hạn, và tự động được giải phóng ngay sau khi hệ thống ngầm xin cấp lại Token thành công.

MODULE 2: CHIẾN LƯỢC MỤC TIÊU & SEO (TARGET STRATEGY & SEO)

Giám sát Tên miền & Từ khóa (Domain & Keyword Monitoring): Quản trị viên xây dựng chiến dịch bằng cách khai báo Tên miền và Từ khóa. Nghiệp vụ hỗ trợ phân tách nhánh (Branch) và nhóm (Group) để phục vụ báo cáo.

Quy tắc Quét tự động (Auto-Scan Rules): Hệ thống đánh giá cờ is_run_daily và is_active để quyết định đưa các mục tiêu vào lịch trình Cronjob, tự động tạo hàng loạt Task đẩy sang API Gateway.

Phân tích Growth Hack: Dựa vào dữ liệu lịch sử xếp hạng (RankingHistory), nghiệp vụ định nghĩa các thuật toán nhận diện sự tăng trưởng bất thường (Growth Hack) để bôi màu cảnh báo, giúp đánh giá rủi ro thuật toán của Google/Bing.

MODULE 3: ĐIỀU PHỐI TÁC VỤ & KIỂM SOÁT TẢI (TASK ORCHESTRATION & THROTTLING)

Quản trị Luồng (Queue Management): API Gateway tiếp nhận hàng nghìn yêu cầu thông qua endpoint /api/task/list. Để tránh làm sập hệ thống Worker, các yêu cầu này không chạy ngay mà bị ép vào trạng thái 0 (Pending).

Cân bằng tải nội bộ (Internal Load Balancing): Nghiệp vụ Bootstrap liên tục đếm số lượng Worker đang bận (isBusy). Chỉ khi có Slot trống, Task mới được chuyển sang trạng thái 1 (Running) và cấp phát (postMessage) xuống Thread xử lý.

Giao tiếp Dịch vụ (Service Discovery & Webhook): Mọi tác vụ đều mang theo một hookUrl. Khi tác vụ hoàn tất hoặc thất bại, nghiệp vụ bắt buộc hệ thống phải đóng gói thông tin (Execution Duration, Cloud Paths, Proxies used) và gọi ngược lại URL này để báo cáo, thiết lập cơ chế liên lạc hai chiều không đồng bộ (Asynchronous 2-way communication).

MODULE 4: ĐỘNG CƠ TỰ ĐỘNG HÓA & TRÍCH XUẤT (AUTOMATION & EXTRACTION ENGINE)

Giả lập Hành vi (Behavioral Simulation): Để thu thập dữ liệu chính xác, Worker áp dụng nghiệp vụ Anti-Detect. Nó sử dụng danh sách Proxy phân giải để đổi IP liên tục, kết hợp thư viện Stealth để vượt qua tường lửa (Cloudflare/WAF) của mục tiêu.

Kịch bản Động (Dynamic Scripting): Dựa trên biến type, Worker thực thi các kịch bản cuộn trang, tìm kiếm từ khóa trong DOM, và kiểm tra tính hợp lệ của giao diện trên các thiết bị khác nhau (device: mobile | desktop).

Thu thập Bằng chứng (Evidence Collection): Đây là nghiệp vụ cốt lõi có giá trị pháp lý/báo cáo cao nhất. Nếu cờ isAcceptRecord kích hoạt, hệ thống sẽ ánh xạ màn hình ảo (Xvfb) và dùng FFmpeg kết xuất tiến trình duyệt web thành Video (.mp4), đồng thời chụp Snapshot (.png) để làm bằng chứng xác thực tình trạng website tại thời điểm quét.

MODULE 5: ĐỘ TIN CẬY & TỰ PHỤC HỒI (RELIABILITY & FAULT TOLERANCE)

Phục hồi Thảm họa cấp Task (Task-level Disaster Recovery): Nghiệp vụ xử lý các tình huống treo tiến trình (zombie process) do rớt mạng mạng hoặc tràn bộ nhớ. Hệ thống quét định kỳ các Task trạng thái 1 có vòng đời vượt quá 6 phút, tự động hạ cấp về trạng thái 0 để chạy lại từ đầu.

Cảnh báo Thời gian thực (Real-time Alerting): Mọi sự kiện sập nguồn, proxy kiệt quệ hoặc lỗi FFmpeg được phân loại mức độ nghiêm trọng. Các lỗi Critical sẽ trigger API Telegram để thông báo trực tiếp tới thiết bị di động của kỹ sư vận hành (DevOps/Admin).

III. SƠ ĐỒ LUỒNG DỮ LIỆU TỔNG QUÁT (DATA FLOW ARCHITECTURE)

[ 1. ADMIN FRONTEND ]
        |
        |-- (Gửi lệnh khởi tạo quét định kỳ hoặc thủ công qua Axios)
        v
[ 2. API GATEWAY (ElysiaJS) ]
        |
        |-- (Validate DTO, Lưu Task vào MongoDB: Status = 0)
        v
[ 3. QUEUE MANAGER (Polling) ]
        |
        |-- (Cấp phát Task cho Worker Thread rảnh: Status = 1)
        v
[ 4. WORKER THREADS (Puppeteer + FFmpeg) ]
        |
        |-- (Sử dụng Proxy, vượt WAF, truy cập Domain)
        |-- (Tìm kiếm Keywords, Chụp ảnh màn hình, Quay Video màn hình)
        |-- (Upload File Media lên Cloud S3)
        v
[ 5. POST-PROCESSING & WEBHOOK ]
        |
        |-- (Cập nhật MongoDB: Status = 2 hoặc 3)
        |-- (Gọi POST Request chứa dữ liệu trả về hookUrl của Admin)
        v
[ 6. ADMIN FRONTEND ]
        |
        |-- (Nhận Webhook, Cập nhật HistoryDomain, RankingHistory)
        |-- (Hiển thị Báo cáo, Biểu đồ thống kê trên UI)

SYSTEM BUSINESS OVERVIEW

TÀI LIỆU TỔNG QUAN NGHIỆP VỤ HỆ THỐNG (SYSTEM BUSINESS OVERVIEW)#

I. BẢNG MA TRẬN PHÂN HỆ NGHIỆP VỤ (BUSINESS MODULES MATRIX)#

II. CHI TIẾT NGHIỆP VỤ THEO TỪNG PHÂN HỆ (DETAILED BUSINESS LOGIC)#

MODULE 1: QUẢN TRỊ TRUNG TÂM & BẢO MẬT (CENTRAL ADMIN & SECURITY)#

MODULE 2: CHIẾN LƯỢC MỤC TIÊU & SEO (TARGET STRATEGY & SEO)#

MODULE 3: ĐIỀU PHỐI TÁC VỤ & KIỂM SOÁT TẢI (TASK ORCHESTRATION & THROTTLING)#

MODULE 4: ĐỘNG CƠ TỰ ĐỘNG HÓA & TRÍCH XUẤT (AUTOMATION & EXTRACTION ENGINE)#

MODULE 5: ĐỘ TIN CẬY & TỰ PHỤC HỒI (RELIABILITY & FAULT TOLERANCE)#

III. SƠ ĐỒ LUỒNG DỮ LIỆU TỔNG QUÁT (DATA FLOW ARCHITECTURE)#