SYSTEM BUSINESS LOGIC: ADMIN CONTROL PANEL (MODULE 1)#
Phân hệ Admin Frontend đóng vai trò là Trung tâm điều hành (Control Panel), nơi quản trị viên và người dùng định cấu hình tham số, giám sát tiến trình và phân tích kết quả dữ liệu được thu thập từ các Worker.
1. Nghiệp vụ Quản lý Người dùng và Phân quyền (User Access Management)#
Kiểm soát truy cập: Hệ thống áp dụng cơ chế phân quyền dựa trên Role-Based Access Control (RBAC). Các vai trò bao gồm: view, edit, admin, superadmin.
Giới hạn tài nguyên (Quota): Mỗi tài khoản có một thuộc tính limit quy định giới hạn số lượng request hoặc số lượng domain tối đa được phép quét trong một chu kỳ, nhằm kiểm soát chi phí hạ tầng.
Phiên đăng nhập: Trạng thái xác thực (Authentication) được duy trì thông qua Token. Nghiệp vụ yêu cầu đảm bảo phiên làm việc không bị ngắt quãng, do đó áp dụng cơ chế "Silent Token Refresh" ở tầng Network.
2. Nghiệp vụ Giám sát Tên miền (Domain Monitoring Business)#
Phân loại rủi ro: Tên miền được quản lý theo trạng thái tĩnh (Live, Die, Pending) và trạng thái rủi ro thông qua cờ is_block (danh sách đen của nhà mạng) và is_whitelist (tên miền được ưu tiên/tin cậy).
Luồng kích hoạt quét (Triggering):Quét thủ công (Manual): Người dùng chủ động chọn tên miền và nhấn nút kiểm tra. Hệ thống gửi request tạo Task xuống Backend.
Quét tự động (Auto): Hệ thống cronjob kích hoạt quét định kỳ đối với các tên miền có cờ is_active = Y.
Lưu vết lịch sử: Mọi phiên kiểm tra đều tạo ra một bản ghi HistoryDomain, ghi nhận thời gian hoàn tất (checked_at), kết quả kết xuất (hình ảnh, video) và proxy được sử dụng.
3. Nghiệp vụ Đo lường SEO & Từ khóa (SEO & Ranking Business)#
Thu thập Search Volume: Hệ thống quản lý danh mục từ khóa (Keywords), tự động thu thập lượng tìm kiếm hàng tháng để đánh giá độ "hot" của từ khóa.
Giám sát Thứ hạng (Rank Tracking): Hệ thống tự động tìm kiếm từ khóa trên Google/Bing và xác định vị trí (Top 1-10) của tên miền sở hữu. Kết quả được lưu vào RankingHistory.
Phân tích Growth Hack: Dựa vào tốc độ thăng h ạng hoặc các tham số bất thường, hệ thống tự động gán cờ is_growth_hack để cảnh báo quản trị viên về việc tên miền có thể đang sử dụng các thủ thuật SEO mũ đen/mũ xám.
4. Nghiệp vụ Quản lý Mạng lưới Proxy (Proxy Network Business)#
Tỷ lệ thành công của Crawler phụ thuộc hoàn toàn vào mạng lưới IP.
Nghiệp vụ yêu cầu lưu trữ và theo dõi "sức khỏe" của Proxy (is_active). Nếu một Node bị Timeout hoặc trả về mã lỗi liên tục (ghi nhận qua mảng proxies trong History), quản trị viên có thể vô hiệu hóa Node đó trên Admin Panel để ngừng cấp phát cho Worker.
Modified at 2026-03-28 02:50:46
