Admin Dashboard — Tổng Quan

Admin Dashboard là giao diện quản trị duy nhất của hệ thống Traffic Tools V2. Đây là ứng dụng web (SPA) xây dựng trên Vue 3, dùng để cấu hình chiến dịch, giám sát tiến độ và xem báo cáo.

Bản thân Dashboard không tự thực thi bất kỳ tác vụ traffic nào. Toàn bộ vai trò của nó là giao tiếp với Go API Backend qua HTTP, rồi hiển thị kết quả dưới dạng bảng dữ liệu, biểu đồ và form. Hỗ trợ hai ngôn ngữ: Tiếng Việt (mặc định) và Tiếng Anh.

Các nhóm chức năng chính

Xác thực — Đăng nhập với xác thực 2 lớp (2FA) qua Google Authenticator. Phục hồi phiên tự động khi F5 trang.

Thống kê & Báo cáo — Xem traffic theo giờ trong ngày, quản lý chiến dịch theo 3 loại (Click Ads, Negative SEO, Traffic Tự Nhiên), xuất báo cáo Excel.

Tìm kiếm tự động — Theo dõi SERP tự động, xem ai đang xuất hiện trên Google/CocCoc cho một từ khóa, nhấn "Xác nhận bắn" để tạo chiến dịch ngay.

Trung tâm báo cáo — Gửi báo cáo vi phạm đến 100+ nền tảng bảo mật, quản lý domain cần báo cáo, xem ảnh bằng chứng.

Quản lý hệ thống — Máy chủ worker, proxy chính, proxy dự phòng, gói proxy, nhà cung cấp proxy.

Quản lý tài khoản Google — Browser Profile (danh tính kỹ thuật số) mà Worker dùng khi thực thi task.

Quản lý người dùng — Tạo/sửa/xóa tài khoản, phân quyền Admin/User, xem nhật ký hoạt động.

Bussiness | Logic

Tài liệu nghiệp vụ giải thích từng tính năng của Admin Dashboard từ góc nhìn người vận hành — không có code, chỉ có cách hoạt động và cách dùng.

1. Thống kê hàng ngày — Trang mặc định sau đăng nhập. Cấu trúc dữ liệu theo giờ, biểu đồ đường, bảng nhóm theo từ khóa, tự động cập nhật mỗi 10 giây, xuất Excel. Dấu hiệu cần chú ý khi giờ nào đó traffic giảm đột ngột.

2. Thống kê hệ thống — Ba tab chiến dịch: Click Quảng Cáo (Campaign → Project), Negative SEO (Domain → Từ khóa), Traffic Tự Nhiên (Domain → Từ khóa). Bộ lọc ngày, thao tác hàng loạt, biểu đồ thứ hạng SEO theo thời gian, xuất Excel.

3. Tìm kiếm tự động — Cấu hình từ khóa (engine, thiết bị, số kết quả, độ ưu tiên), xem kết quả SERP, Confirm Fire để tạo chiến dịch ngay, Smart Import hàng loạt, tab Server Performance và Location.

4. Trung tâm Báo cáo — Bốn tab: Thống kê (biểu đồ theo tuần), Trang Báo Cáo (quản lý 100+ nền tảng, bật/tắt hàng loạt, cập nhật AI prompt), Quản lý miền (thêm domain, xem trạng thái, ảnh bằng chứng), Báo Cáo PC (xuất CSV).

5. Quản lý tài khoản — CRUD user, phân quyền Admin/User, thiết lập 2FA, luồng đăng nhập, nhật ký hoạt động nhóm theo user.

6. Quản lý Hệ thống — Quản lý server worker, proxy chính (import hàng loạt, xoay IP tự động), gói proxy, nhà cung cấp, backup proxy (health check mỗi 2 phút). Vòng đời của một proxy từ khi mua đến khi hết hạn.

7. Quản lý tài khoản Google — Browser Profile: thêm hàng loạt, đồng hồ đếm ngược cooldown theo thời gian thực, bộ lọc tự động, bulk update, xử lý đăng nhập thất bại, profile sessions.

Hướng dẫn sử dụng

Tài liệu hướng dẫn từng tính năng từ góc nhìn người dùng cuối.

Đăng Nhập & Xác Thực Hai Bước — Luồng đăng nhập đầy đủ: nhập email/mật khẩu, xác thực OTP 6 chữ số, thiết lập 2FA lần đầu bằng mã QR, phục hồi phiên tự động khi mở lại tab.

Thống Kê Hàng Ngày — Trang mặc định sau đăng nhập. Xem traffic theo từng giờ (0–23h), biểu đồ đường, bảng nhóm theo từ khóa, xuất Excel. Tự động cập nhật mỗi 10 giây.

Thống Kê Hệ Thống — Quản lý chiến dịch theo 3 tab: Click Quảng Cáo (tiêu hao ngân sách đối thủ), Negative SEO (tăng bounce rate đối thủ), Traffic Tự Nhiên (cải thiện SEO khách hàng). Xem tiến độ từng domain, biểu đồ thứ hạng SEO theo thời gian, bật/tắt hàng loạt.

Tìm Kiếm Tự Động — Theo dõi SERP tự động mỗi 30 phút, xem kết quả tìm kiếm theo từng từ khóa (URL, rank, loại ads/organic), nhấn "Xác nhận bắn" để tạo chiến dịch ngay. Smart Import để tạo hàng loạt chiến dịch từ danh sách domain.

Trung Tâm Báo Cáo — Quản lý 100+ nền tảng báo cáo bảo mật (bật/tắt từng nền tảng hoặc theo nhóm), thêm domain cần báo cáo, xem thống kê tỷ lệ thành công và ảnh bằng chứng sau mỗi lần gửi.

Quản Lý Tài Khoản — Tạo, sửa, xóa tài khoản nhân sự. Phân quyền Admin/User. Đổi mật khẩu. Xem nhật ký hoạt động không thể xóa.

Quản Lý Server — Thêm/xóa máy chủ worker, bật/tắt từng server, xem trạng thái online/offline theo thời gian thực.

Quản Lý Proxy — Quản lý pool IP proxy chính: thêm thủ công, import từ Excel, kéo tự động từ nhà cung cấp, lọc theo nhà cung cấp/gói/trạng thái/ngày hết hạn, xóa hàng loạt.

Quản Lý Gói Proxy — Theo dõi các gói proxy đã mua: tên gói, giá, nhà cung cấp, ngày hết hạn, trạng thái kích hoạt.

Quản Lý Nhà Cung Cấp Proxy — Thông tin các đối tác bán proxy (ZingProxy, Enode, M2Proxy...), sắp xếp thứ tự ưu tiên bằng drag-and-drop, xem thống kê dữ liệu sử dụng.

Quản Lý Backup Proxy — Proxy dự phòng kích hoạt khi proxy chính gặp sự cố. Health check tự động mỗi 2 phút, import từ Proxifly, xóa hàng loạt.

Quản Lý Tài Khoản Google — Quản lý Browser Profile: thêm hàng loạt (tối đa 100 mỗi lần), theo dõi trạng thái cooldown với đồng hồ đếm ngược thời gian thực, reset cooldown, cập nhật hàng loạt (activate/deactivate/delete), xem lịch sử task.

User Guide — Hướng dẫn sử dụng tổng hợp cho người dùng mới bắt đầu.

Architecture

Tài liệu kỹ thuật cho developer làm việc với Admin Dashboard.

System Architecture — Kiến trúc Vue 3 SPA: Router Guard (luồng xác thực, phục hồi phiên, kiểm soát quyền truy cập), Axios interceptor (tự động đính kèm token, xử lý lỗi 401), Pinia store (authStore, appStore), chiến lược lưu token (localStorage/sessionStorage).

Code Structure — Cây thư mục đầy đủ, pattern tổ chức view (IndexView + components + composables + stores), path aliases (@, @api), auto-import (Vue APIs, Pinia, Naive UI), build chunks (naiveUI, lodash, vue, app).

Environment & Configuration — Biến môi trường Vite (VITE_API_SERVER), cách override API server tại runtime qua window.configs mà không cần build lại, các file .env theo môi trường.

Logs and Monitoring — Cách đọc lỗi từ DevTools, các loại thông báo trong hệ thống (success/error/warning/info), xử lý lỗi API tập trung qua showMessageError.

Deployment

Local — Chạy Admin Dashboard trên máy local với npm run dev, kết nối đến Go API local tại http://localhost:33003.

Staging — Build và deploy lên staging server, cấu hình VITE_API_SERVER cho môi trường staging. Pipeline GitLab tự động khi push vào nhánh staging.

Production — Multi-stage Docker build: builder stage chạy Vite build, production stage chỉ chứa Nginx + file tĩnh (dưới 20MB). Rollback bằng cách đổi tag image trong docker-compose, hoàn thành trong ~5 giây.

Tổng quan

Admin Dashboard — Tổng Quan#

Các nhóm chức năng chính#

Bussiness | Logic#

Hướng dẫn sử dụng#