1. Architecture
Social Tool Documentation
  • Tổng quan
  • Bussiness | Logic
    • Bussiness | Logic
  • Project
    • ADMIN
      • Tổng quan ADMIN
      • Architecture
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • Hướng dẫn sử dụng
        • Đăng nhập
        • FAQ
        • Mạng xã hội
          • Tài khoản mạng xã hội
          • Nội dung bài viết & bình luận
          • Quản lý liên kết
          • Thư viện hình ảnh
          • Thu thập dữ liệu
        • Hệ thống
          • Quản lý proxy
        • Chiến dịch
          • Tạo & quản lý chiến dịch
          • Đăng nhập tài khoản
          • Check Proxy
          • Join Group
    • API
      • Tổng quan API
      • Architecture
        • System architecture
        • Database schema
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • 🔑 Identity & Session
          • List users
          • Create user
          • Update info user
          • Update info user
          • List user departments
          • Delete user
          • List user's AI keys
          • Create AI key
          • Get user's active API key
          • Get supported services
          • Get supported AI models
          • Update AI key
          • Delete AI key
          • Get AI key by ID
          • List departments
          • Create department
          • Update department
          • Create department
          • Update department
          • Update department roles
          • Get department roles
          • Update department status
          • Delete department
          • List user sessions
          • Create user session
          • Delete user session
          • Get user sessions by user ID
          • Delete all user sessions
          • Update user session status
          • List user activity logs
          • Create user activity log
          • Get user activity logs
          • Delete user activity logs
          • User login
          • User registration
          • User logout
          • Logout from all devices
          • Refresh access token
          • Create api key
          • Reset password
          • Get current user
          • Get user roles
          • Create role
          • Update role
          • Update role
          • Update role
          • List user permission groups
          • Get user permission group by ID
          • Delete user permission group
          • Create user permission group
          • Update user permission group
          • Get all user permission groups with permissions
        • 🛰️ Proxy & Connectivity
          • List proxies
          • Create proxy
          • Create many proxies
          • Update proxy
          • Delete proxy
          • Get proxy by ID
          • Import proxies from CSV/Excel
          • Check expired proxies
          • Kiểm tra proxy (qua Campaign)
          • Xóa proxy
          • Cập nhật proxy
          • Proxy Group list
          • Create a Proxy Group
          • Get a Proxy Group by ID
          • Update a Proxy Group
          • Delete a Proxy Group
          • Delete a Proxy Group
          • List proxy providers
          • Create proxy provider
          • Update proxy provider
          • Delete proxy provider
          • Get proxy provider by ID
          • Import proxy packages from CSV
          • List proxy packages
          • Create proxy package
          • Update proxy package
          • Delete proxy package
          • Get proxy package by ID
          • Import proxy packages from CSV
        • 📱 Social Management
          • List socials
          • Create social
          • Update social
          • Delete social
          • Get social by ID
          • List social accounts
          • Create social account
          • Create social account
          • Get account tasks
          • Assign proxies to social account
          • Update social account
          • Delete social account
          • Get social account by ID
          • Join social account
          • Cancel social accounts
          • Cancel social accounts
          • Import social accounts from file
          • Get account usage statistics
          • Push cookies manually for specific accounts (via Campaign)
          • Đổi tên nhiều tài khoản (qua Campaign)
          • Đổi mật khẩu nhiều tài khoản (qua Campaign)
          • Đổi ảnh đại diện (qua Campaign)
          • Social Account Group list
          • Create a Social Account Group
          • Get a Social Account Group by ID
          • Create a Social Account Group
          • Delete a Social Account Group
          • List social pages
          • Create social page
          • Update social page
          • Delete social page
          • Get social page by ID
          • Batch update social page status
          • Batch delete social pages
          • Import social pages from file
          • Search social pages
          • Batch delete social pages
          • Social Page Group list
          • Create a Social Page Group
          • Get a Social Page Group by ID
          • Update a Social Page Group
          • Delete a Social Page Group
          • List social actions
          • Create social action
          • Update social type
          • Delete social action
          • Get social type by ID
          • List social pages
          • Create social content
          • Update social content
          • Delete social content
          • Get social content by ID
          • Batch delete social content
          • Import social accounts from file
          • Create a new social content group
          • Get paginated list of social content groups
          • Get social content group by ID
          • Update social content group
          • Soft delete social content group
          • Batch delete social content groups
          • Delete social content group
          • Get groups by social platform ID
          • Social Image list
          • Create a Social Image
          • Get a Social Image by ID
          • Update a Social Image
          • Delete a Social Image
          • Social Collect Data list
          • Create a Social Collect Data
          • Get a Social Collect Data by ID
        • 📁 Campaign Management
          • List campaigns
          • Create campaign
          • Update campaign
          • Delete campaign
          • Get campaign by ID
          • Create campaign platform
          • List campaign platforms
          • Update campaign platform
          • Delete campaign platform
          • Get campaign platform by ID
          • Create campaign platform
          • Create campaign platform
          • Clone campaign platforms
          • Cancel multiple campaign platforms
          • List campaign joins
          • Create campaign platform
          • List campaign joins
          • Update campaign platform
          • Update campaign platform
          • Update campaign platform
          • Update campaign platform
          • List jobs
          • Update job
          • Delete job
          • Get job by ID
          • List campaign platform tasks
          • Create campaign platform task
          • Update campaign platform task
          • Delete campaign platform task
          • Get campaign platform job task by ID
          • List Report Categories
          • Create Report Categories
          • Create Report Categories
          • Create Report Categories
          • List Report Details
          • Create Report Details
          • Create Report Details
          • Create Report Details
    • TOOL
      • Tổng quan TOOL
      • Architecture
        • Database schema
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • 🎯 NATS — Task
          • [NATS RPC] Tạo batch Task mới
          • [NATS RPC] Lấy danh sách tất cả Tasks
          • [NATS RPC] Đếm số Task đang chờ xử lý
          • [NATS RPC] Xóa tất cả Tasks
        • 🍪 NATS — Cookie
          • [NATS RPC] Thêm batch Cookie (Auto Login)
          • [NATS RPC] Lấy danh sách tất cả Cookies
          • [NATS RPC] Xóa tất cả Cookies
        • 🌐 NATS — Proxy
          • [NATS RPC] Gửi batch Proxy để kiểm tra
        • 🔗 NATS — TaskJoin
          • [NATS RPC] Tạo lệnh tham gia Group
          • [NATS RPC] Kiểm tra trạng thái tham gia Group
        • 📤 NATS — Callbacks
          • [NATS PUB] Kết quả thực thi Task
          • [NATS PUB] Kết quả Crawl dữ liệu
          • [NATS PUB] Kết quả Auto Login
          • [NATS PUB] Kết quả kiểm tra Proxy
          • [NATS PUB] Kết quả tham gia Group
          • [NATS PUB] Kết quả kiểm tra trạng thái tham gia
        • 📊 HTTP — Logs & Info
          • Service Root — Thông tin Worker
          • Health Check
          • Đọc file log
          • Log hôm nay
          • Log theo ngày cụ thể
          • Danh sách ngày có log
          • Test kết nối ChatGPT
        • 📋 HTTP — Data Query
          • Danh sách Tasks (phân trang + lọc)
          • Xóa tất cả Tasks
          • Danh sách tất cả Cookies
          • Xóa tất cả Cookies
          • Xóa Cookie theo _id
          • Danh sách Proxies (lọc theo task_id)
          • Xóa tất cả Proxies
          • Proxy Checks đang chờ xử lý
          • Proxy Checks đã hoàn thành
          • Xóa Proxy theo _id
          • Danh sách Task Join (phân trang + lọc)
          • Tạo Task Join (HTTP mode)
          • Xóa tất cả Task Join
  • Schemas
    • AIInfo
    • CommentInfo
    • ReplyInfo
    • ShareInfo
    • CaptchaInfo
    • PageInfo
    • SocialAccountInfo
    • ProxyInfo
    • SocialInfo
    • ActionInfo
    • CreateTaskPayload
    • CreateCookiePayload
    • CreateProxyPayload
    • CreateTaskJoinPayload
    • NatsAcceptedResponse
    • NatsRejectedResponse
    • NatsErrorResponse
    • TaskCompletedPayload
    • CookieUpdatePayload
    • ProxyCheckResultPayload
    • TaskJoinResultPayload
    • TaskJoinCheckResultPayload
    • PagingInfo
    • AppError
  1. Architecture

System architecture

Tài liệu Kiến trúc Hệ thống#

Tài liệu kỹ thuật – Phiên bản 1.0
Mô tả kiến trúc tổng quan, công nghệ và luồng dữ liệu của Social Tool

1. Tổng quan#

Social Tool là ứng dụng quản trị (Admin Dashboard) phục vụ việc vận hành các chiến dịch tự động hóa trên nhiều nền tảng mạng xã hội (Facebook, Google, Instagram...). Hệ thống Frontend được xây dựng theo kiến trúc hướng module, tối ưu cho việc quản lý dữ liệu quy mô lớn và cập nhật trạng thái theo thời gian thực.

2. Technology Stack#

Hạng mụcCông nghệMục đích
FrameworkVue 3 (Composition API)Xây dựng giao diện phản ứng (reactive UI)
Ngôn ngữTypeScriptĐảm bảo an toàn kiểu dữ liệu, giảm lỗi runtime
Global StatePiniaQuản lý trạng thái toàn cục (user, config, modal)
Server StateTanStack Vue QueryCaching, polling, đồng bộ dữ liệu với server
UI LibraryNaive UI + Tailwind CSSComponent system & tùy biến giao diện
HTTP ClientAxiosGiao tiếp API với cấu hình interceptor tập trung
Ngày thángdate-fns, momentXử lý và định dạng thời gian
Build ToolViteBuild nhanh, HMR trong quá trình phát triển
Package ManagerBunCài đặt dependencies và chạy script

3. Luồng dữ liệu (Data Flow)#

Hệ thống tuân theo mô hình Unidirectional Data Flow (luồng dữ liệu một chiều) nhằm đảm bảo tính dễ đoán và dễ bảo trì.

Vai trò từng tầng#

View (Giao diện)
Các Component và Page chịu trách nhiệm hiển thị dữ liệu và tiếp nhận tương tác của người dùng. View không gọi API trực tiếp mà tương tác thông qua Composables hoặc Store.
Composables — TanStack Vue Query
Chứa toàn bộ logic đồng bộ dữ liệu với server. Tự động xử lý các trạng thái loading, error, caching, và refetching mà không cần viết thủ công.
Services (API Layer)
Lớp trung gian giao tiếp trực tiếp với Backend API qua giao thức HTTP (Axios). Mọi request/response đều đi qua interceptor tập trung để xử lý authentication và error handling.
Store — Pinia
Lưu trữ các trạng thái mang tính toàn cục như: thông tin người dùng hiện tại, cấu hình hệ thống, trạng thái modal. Phục vụ cho các trường hợp cần chia sẻ state giữa nhiều component không có quan hệ cha–con trực tiếp.

4. Các thực thể nghiệp vụ chính#

Thực thểMô tả
Social AccountsTài khoản mạng xã hội: quản lý login, proxy, trạng thái hoạt động
CampaignsChiến dịch: tập hợp các nhóm hành động được lên lịch thực thi
Campaign PlatformsHành động cụ thể (Like, Comment, Share, Collect...) được gán tài khoản thực thi
Proxy / ServerHạ tầng mạng đảm bảo vận hành tài khoản an toàn, tránh checkpoint

5. Đặc điểm kiến trúc nổi bật#

5.1. Kiến trúc hướng Module#

Mỗi tính năng (Feature) được đóng gói trong một thư mục riêng biệt, bao gồm components, composables, services và types tương ứng. Cấu trúc này giúp dễ dàng mở rộng và bảo trì độc lập từng phần của hệ thống.

5.2. Polling System — Cập nhật thời gian thực#

Tích hợp cơ chế tự động làm mới (Polling) thông qua TanStack Vue Query cho các tác vụ đang ở trạng thái processing. Giao diện cập nhật kết quả liên tục mà không yêu cầu người dùng tải lại trang.

5.3. Vue 3 Reactivity#

Khai thác tối đa hệ thống reactivity của Vue 3 thông qua ref, computed, và watch. Giao diện luôn phản ánh đúng trạng thái dữ liệu hiện tại mà không cần thao tác DOM thủ công.

5.4. Type-Safe toàn diện#

Toàn bộ dữ liệu trao đổi giữa các tầng (API response, store state, component props) đều được định nghĩa bằng TypeScript Interface. Cách tiếp cận này giúp phát hiện lỗi ngay tại thời điểm biên dịch thay vì runtime.
Tài liệu được cập nhật lần cuối: 2026. Mọi thắc mắc vui lòng liên hệ đội ngũ kỹ thuật.
Modified at 2026-03-30 09:34:01
Previous
Tổng quan ADMIN
Next
Code structure
Built with