api/
├── bootstrap/                  # Khởi động ứng dụng
│   ├── routes.go               # Đăng ký tất cả routes HTTP
│   ├── background_services.go  # Khởi động background jobs
│   ├── cron/                   # Cron job setup
│   │   ├── cron.go             # Đăng ký tất cả cron schedules
│   │   ├── health_check_cron.go
│   │   └── clean_log_schedule.go
│   ├── injection/
│   │   └── injection.go        # Dependency Injection container (go.uber/dig)
│   └── socket/
│       └── socket.go           # WebSocket setup (nếu có)
│
├── internal/                   # Business logic theo module (36 modules)
│   ├── [module_name]/
│   │   ├── [module_name].go    # Model struct + constants + enums
│   │   ├── dto/                # Data Transfer Objects (request/response shapes)
│   │   ├── handler/            # HTTP Handler (controller layer)
│   │   │   └── handler.go      # Route registration + handler struct
│   │   ├── service/            # Business logic layer
│   │   │   └── service.go      # Service struct + interface
│   │   ├── repository/         # Database access layer
│   │   │   └── repository.go   # Queries MongoDB/MySQL
│   │   └── cron/               # Module-specific cron jobs (nếu có)
│   └── ...
│
├── pkg/                        # Shared libraries & utilities
│   ├── env.go                  # Environment variable loading
│   ├── api/                    # HTTP client utilities
│   ├── apperror/               # Custom error types & codes
│   ├── cache/                  # Redis cache wrapper
│   ├── database/               # DB connection setup
│   ├── enum/                   # Shared enum definitions
│   ├── excel/                  # Excel export utilities
│   ├── helper/                 # Generic helper functions
│   ├── jwt/                    # JWT generation & validation
│   ├── logger/                 # Logging utilities
│   ├── messages/               # Response message constants
│   ├── middleware/             # HTTP middlewares (auth, admin, jwt)
│   ├── scheduler/              # Cron scheduler wrapper
│   ├── telegram/               # Telegram bot client
│   ├── time/                   # Time utilities & formatting
│   ├── types/                  # Shared type definitions
│   └── validate/               # Request validation helpers
│
├── deploy/
│   └── development/
│       └── Dockerfile          # Docker build config
├── docker-compose.yaml         # Full stack Docker setup
├── Makefile                    # Dev commands (build, run, migrate, seed)
├── go.mod                      # Go module dependencies
├── go.sum                      # Dependency lockfile
└── main.go                     # Application entry point

internal/proxy/
├── proxy.go                 # Struct Proxy, ProxyResponse, helper methods
├── dto/
│   ├── create_proxy.go      # CreateProxyRequest struct
│   ├── update_proxy.go      # UpdateProxyRequest struct
│   └── get_list.go          # ListProxyQuery (filters, pagination)
├── handler/
│   ├── handler.go           # ProxyRouter() + Handler struct init
│   ├── create.go            # POST /proxy
│   ├── get_list.go          # GET /proxy
│   ├── get_by_id.go         # GET /proxy/:id
│   ├── update.go            # PUT /proxy/:id
│   ├── delete.go            # DELETE /proxy/:id
│   ├── import.go            # POST /proxy/import
│   ├── export.go            # GET /proxy/export
│   └── bulk_delete.go       # POST /proxy/bulk-delete
├── service/
│   ├── service.go           # Service struct + all business logic
│   ├── import_service.go    # Logic import từ providers
│   └── update_service.go    # Logic cập nhật proxy
├── repository/
│   └── repository.go        # MongoDB CRUD operations
├── cron/
│   └── cron.go              # Proxy rotation cron logic
├── config/                  # Provider-specific configs
└── common/                  # Shared helpers within module

pkg/
├── env.go                   # Khai báo struct Env, load từ os.Getenv
├── middleware/
│   ├── auth.go              # AuthMiddleware: validate JWT + Redis session
│   ├── jwt.go               # JWTMiddleware: parse Bearer token
│   └── admin.go             # AdminMiddleware: kiểm tra role=Admin
├── apperror/
│   ├── errors.go            # AppError struct với Code + Message
│   └── codes.go             # HTTP error codes (400, 401, 403, 404, 500)
├── database/
│   ├── mongodb.go           # MongoDB connection pool setup
│   └── mysql.go             # GORM MySQL connection setup
├── cache/
│   └── redis.go             # Redis client wrapper (get/set/del)
├── jwt/
│   └── jwt.go               # GenerateToken, ParseToken, ValidateClaims
├── telegram/
│   └── telegram.go          # SendMessage, SendErrorAlert
├── excel/
│   └── excel.go             # Apache POI-like Excel generator
└── helper/
    ├── pagination.go        # ParsePage, ParseLimit, CalcOffset
    └── response.go          # Success/Error response formatters

/api
├── [PUBLIC - No Auth]
│   ├── POST /api/user/login
│   ├── POST /api/user/register
│   ├── GET  /api/reset-create-task
│   ├── POST /api/task/request            ← Tools V2 kéo task
│   ├── POST /api/report/request-task     ← Tools V2 kéo report task
│   ├── GET  /api/campaign/reports
│   ├── GET  /api/campaigns/reports
│   ├── GET  /api/servers/reports
│   ├── GET  /api/dashboard/*
│   ├── GET  /api/reports/*
│   ├── GET  /api/evidence/*
│   ├── GET  /api/files/*
│   └── GET  /api/system-settings
│
└── [PROTECTED - JWT Required]
    ├── /api/user/*
    ├── /api/campaign/*
    ├── /api/server/*
    ├── /api/project/*
    ├── /api/project-detail/*
    ├── /api/proxy/*
    ├── /api/backup-proxy/*
    ├── /api/proxy-ip-log/*
    ├── /api/proxy-providers/*
    ├── /api/proxy-packages/*
    ├── /api/profiles/*
    ├── /api/keywords/*
    ├── /api/keyword-analytics/*
    ├── /api/keyword-result/*
    ├── /api/keyword-schedule/*
    ├── /api/setup-fire/*
    ├── /api/task-log/*
    ├── /api/activity-log/*
    ├── /api/server-hourly-report/*
    ├── /api/locations/*
    └── /api/files/*

/webhook [PUBLIC - No Auth - For Workers]
├── POST /webhook/task/update-status      ← Nhận kết quả traffic
├── POST /webhook/task/create-multiple    ← Nhận Task batch
├── POST /webhook/proxy/get-proxy         ← Trả proxy cho workers
├── GET  /webhook/proxy/get-proxy-can-rotate
├── POST /webhook/proxy-rotation-result/:id
├── POST /webhook/proxy/get-backup-proxy
├── GET  /webhook/profile/get-profiles
├── GET  /webhook/profile/get-random-profile
├── GET  /webhook/profile/available
├── POST /webhook/profile/session
├── POST /webhook/profile/session/create
├── POST /webhook/profile/mark-used
├── GET  /webhook/profile/tags
├── POST /webhook/search/clicked-domains
├── GET  /webhook/search/clicked-domains
├── POST /webhook/search/reported-domains
├── POST /webhook/search/thirdparty-callback
├── GET  /webhook/logs
├── DELETE /webhook/logs/clear-content
├── GET  /webhook/check-ip
├── /webhook/report/*                     ← Report task callbacks
├── /webhook/coccoc-token/*               ← CocCoc token operations
└── /webhook/keyword-result/*             ← SERP result callbacks

admin/
├── src/
│   ├── main.ts                  # Entry point: mount app, init plugins
│   ├── App.vue                  # Root component, router-view
│   │
│   ├── views/                   # Page-level components (màn hình)
│   │   ├── HomeView.vue         # Trang chủ (redirect)
│   │   ├── auth/                # Đăng nhập
│   │   │   └── LoginView.vue
│   │   ├── auth-factor/         # Xác thực 2FA TOTP
│   │   ├── dashboard/           # Dashboard thống kê traffic
│   │   ├── dashboard1/          # Dashboard alternative view
│   │   ├── campain/             # Quản lý Campaigns
│   │   ├── task/                # Quản lý Tasks
│   │   ├── auto-search/         # Từ khóa & SERP tracking
│   │   ├── report-daily/        # Báo cáo hàng ngày
│   │   ├── report-dashboard/    # Dashboard báo cáo report tasks
│   │   ├── server-management/   # Quản lý Worker Servers
│   │   ├── profile-management/  # Quản lý Google Profiles
│   │   ├── user-management/     # Quản lý tài khoản Admin
│   │   ├── location/            # Quản lý Geolocation
│   │   └── errors/              # 404, 403 pages
│   │
│   ├── components/              # UI components tái sử dụng
│   │   ├── BulkActions.vue      # Nút hành động hàng loạt
│   │   ├── block/               # Block-level components
│   │   ├── common/              # Shared components (Table, Modal, Form...)
│   │   ├── header/              # Header navigation
│   │   ├── helper/              # Utility display components
│   │   ├── icon/                # Custom icon components
│   │   ├── pagination/          # Pagination component
│   │   └── progress/            # Progress bar components
│   │
│   ├── stores/                  # Pinia state management
│   │   └── [feature].store.ts   # Store per feature
│   │
│   ├── services/                # API client layer (Axios wrappers)
│   │   └── [feature].service.ts # Service per API module
│   │
│   ├── composables/             # Vue 3 Composition API hooks
│   │   └── use[Feature].ts      # useAuth, usePagination, etc.
│   │
│   ├── router/                  # Vue Router config
│   │   └── index.ts             # Route definitions + guards
│   │
│   ├── layouts/                 # Layout wrappers
│   │   ├── DefaultLayout.vue    # Sidebar + Header layout
│   │   └── AuthLayout.vue       # Login page layout
│   │
│   ├── plugins/                 # Vue plugin setup
│   │   └── naive-ui.ts          # Naive UI theme config
│   │
│   ├── types/                   # TypeScript type definitions
│   │   └── [feature].types.ts
│   │
│   ├── utils/                   # Helper utilities
│   │   └── [util].ts
│   │
│   ├── config/                  # App configuration
│   ├── configs/                 # Feature flags & env configs
│   └── data/                    # Static data / mock data
│
├── public/                      # Static assets (favicon, etc.)
├── index.html                   # HTML entry point
├── vite.config.ts               # Vite build config
├── tsconfig.json                # TypeScript config
├── package.json                 # Dependencies & scripts
├── .env.development             # Dev API URL config
└── .env.production              # Prod API URL config

View Component
    │
    ├── composable (useFeature.ts)
    │       │
    │       ├── store (Pinia)          ← Global state cache
    │       │
    │       └── service (Axios)        ← Direct API call
    │               │
    │               └── API (Go) :33001
    │
    └── Naive UI Components (NDataTable, NModal, NForm...)

tools_v2/
├── src/
│   ├── index.ts                 # Entry point: Elysia app + all cron setup
│   │
│   ├── api/                     # HTTP API layer (controllers)
│   │   ├── index.ts             # Route group /api aggregator
│   │   ├── task/                # Task CRUD endpoints
│   │   │   ├── task.controller.ts
│   │   │   ├── task.dto.ts      # Elysia `t` schema validation
│   │   │   ├── task.model.ts    # Mongoose schema
│   │   │   └── task.service.ts  # Business logic
│   │   ├── task-group/          # TaskGroup endpoints + main cron
│   │   │   ├── task-group.controller.ts
│   │   │   ├── task-group.cron.ts    # CORE: orchestrates all traffic
│   │   │   ├── task-group.model.ts
│   │   │   ├── task-group.service.ts
│   │   │   ├── task-group.dto.ts
│   │   │   ├── cron/            # Sub-crons
│   │   │   │   └── cleanup-service.ts
│   │   │   └── task-action/     # Task execution logic
│   │   ├── proxy/               # Proxy endpoints + cron
│   │   │   ├── proxy.controller.ts
│   │   │   ├── proxy.cron.ts    # Proxy rotation + webhook
│   │   │   ├── proxy.model.ts
│   │   │   └── proxy.dto.ts
│   │   ├── search/              # SERP search endpoints + cron
│   │   │   ├── search.controller.ts
│   │   │   ├── search.cron.ts
│   │   │   ├── search.model.ts
│   │   │   ├── search.dto.ts
│   │   │   └── cron/
│   │   │       └── webhook-search.cron.ts
│   │   ├── report-tasks/        # Report task endpoints + cron
│   │   │   ├── report-task.controller.ts   # 29KB - full CRUD + batch ops
│   │   │   ├── report-task.cron.ts         # 18KB - execution engine
│   │   │   ├── report-task.model.ts        # 17KB - full Mongoose schema
│   │   │   ├── controller/
│   │   │   │   └── schemas.ts   # Elysia request/response schemas
│   │   │   └── cron/
│   │   │       └── report-task-request.service.ts
│   │   ├── monitor/             # System health monitor endpoint
│   │   ├── screenshot/          # Screenshot API endpoint
│   │   ├── captcha/             # CAPTCHA handling API
│   │   └── test/                # Test proxy/profile endpoints
│   │
│   ├── services/                # Pure business logic (no HTTP)
│   │   ├── ads/                 # Click quảng cáo (Ads flow)
│   │   │   ├── AdsFlowExecutor.ts    # Orchestrates ads click flow
│   │   │   ├── AdsPageInteractor.ts  # DOM interactions on ads page
│   │   │   └── AdsFinder.ts          # Tìm quảng cáo trên SERP
│   │   ├── ai/                  # OpenAI GPT integration
│   │   │   └── openai.service.ts     # GPT content generation for reports
│   │   ├── api/                 # HTTP client to call API (Go)
│   │   │   └── api.service.ts        # Axios client cho callbacks
│   │   ├── behavior/            # Human-like browser behavior
│   │   │   └── human-behavior.ts     # Scroll, hover, random delays
│   │   ├── browser/             # Browser session management
│   │   │   └── browser.service.ts    # Puppeteer launch + config
│   │   ├── captcha/             # CAPTCHA detection & solving
│   │   │   └── captcha.service.ts
│   │   ├── check-proxy/         # Proxy health check
│   │   │   └── check-proxy.service.ts
│   │   ├── domain/              # Domain utilities
│   │   │   └── domain.service.ts     # Extract domain, normalize
│   │   ├── email/               # Email sending
│   │   │   └── email.service.ts      # SMTP/Gmail send
│   │   ├── evidence/            # Evidence collection
│   │   │   └── evidence.service.ts   # Collect proof of actions
│   │   ├── free-proxy/          # Free proxy fetcher
│   │   │   └── free-proxy.service.ts # GitHub proxy list scraper
│   │   ├── google-accounts/     # Google authentication
│   │   │   └── google-account.service.ts
│   │   ├── profiles/            # Profile management
│   │   │   └── profile.service.ts    # Cooldown, assignment, tracking
│   │   ├── proxy/               # Proxy rotation logic
│   │   │   └── proxy.service.ts      # Rotate, assign, health update
│   │   ├── report-tasks/        # Report task execution
│   │   │   ├── browser-report.service.ts  # Browser-based reporting
│   │   │   └── email-report.service.ts    # Email-based reporting
│   │   ├── screenshot/          # Screenshot capture
│   │   │   └── screenshot.service.ts # Puppeteer screenshot + upload
│   │   ├── search/              # SERP scraping
│   │   │   └── search.service.ts     # Parse Google/CocCoc results
│   │   ├── storage/             # DigitalOcean Spaces
│   │   │   └── storage.service.ts    # Upload/delete/get URL
│   │   ├── webhook/             # Outgoing webhook calls
│   │   │   └── webhook.service.ts    # POST results to API
│   │   └── zing-proxy/          # ZingProxy API integration
│   │       └── zing-proxy.service.ts # Fetch proxy list from ZingProxy
│   │
│   ├── utils/                   # Shared utilities
│   │   ├── env.ts               # Central config (loadEnv function)
│   │   ├── logger.ts            # Logger factory
│   │   ├── createElysia.ts      # Elysia instance factory
│   │   ├── error.middleware.ts  # Global error handler
│   │   ├── ip-validation.middleware.ts  # IP allowlist middleware
│   │   ├── browser_manager/     # Puppeteer pool manager
│   │   │   └── browser-manager.ts    # Session pool, concurrency control
│   │   ├── logger/              # Logger implementation
│   │   │   └── logger.service.ts     # File + console logging
│   │   ├── email-name-extractor.ts   # Extract name from email
│   │   ├── country-form-mapper.ts    # Country → form field mapping
│   │   ├── report-type.utils.ts      # Report platform config (21KB)
│   │   ├── smtp-config.utils.ts      # SMTP setup helpers
│   │   ├── oauth2-token-refresh.ts   # Google OAuth2 refresh flow
│   │   └── server-identifier.ts      # Server ID detection
│   │
│   ├── config/
│   │   └── database/
│   │       └── mongodb.config.ts     # Mongoose connection setup
│   │
│   ├── scripts/                 # Utility scripts
│   ├── types/                   # TypeScript type definitions
│   └── index.ts                 # App entry
│
├── docs/                        # Documentation (đây là folder này!)
├── tmp/                         # Temporary scripts
├── storage/                     # Runtime storage
│   └── log/                     # Log files
├── .env                         # Environment variables (manual create)
├── package.json                 # Bun dependencies
├── tsconfig.json                # TypeScript strictmode config
└── bunfig.toml                  # Bun runtime config

[module]/
├── [module].controller.ts  # HTTP endpoints (Elysia routes)
├── [module].model.ts       # Mongoose schema definition
├── [module].dto.ts         # Request/response type schemas (Elysia `t`)
├── [module].service.ts     # Data access + business logic
└── [module].cron.ts        # Background job runner

// Success
{
  "success": true,
  "message": "Thành công",
  "data": { ... },
  "meta": { "total": 100, "page": 1, "limit": 20 }
}

// Error
{
  "success": false,
  "message": "Không tìm thấy",
  "code": 404,
  "error": "resource_not_found"
}