tools_v2/
├── src/                    ← Toàn bộ mã nguồn TypeScript
├── scripts/                ← Utility scripts chạy độc lập
├── storage/                ← Dữ liệu runtime (log, screenshots, sessions)
├── tmp/                    ← Thư mục tạm (Chrome user profiles)
├── working-proxies/        ← Danh sách free proxies
├── dist/                   ← Build output (không commit)
├── .docker/                ← Dockerfiles
├── .env                    ← Biến môi trường (không commit)
├── .env.example            ← Template biến môi trường
├── .env.backup             ← Backup cấu hình
├── .gitlab-ci.yml          ← CI/CD pipeline
├── docker-compose.yml      ← Khởi động MongoDB local
├── package.json            ← Dependencies và scripts
├── tsconfig.json           ← TypeScript configuration
├── swagger.json            ← Exported Swagger spec
└── README.md

src/
├── index.ts                ← Entry point duy nhất
├── api/                    ← REST endpoints và cron jobs
│   ├── index.ts            ← Tổng hợp routes dưới /api
│   ├── task-group/         ← Traffic task management
│   ├── report-tasks/       ← Security report management
│   ├── proxy/              ← Proxy pool management
│   ├── search/             ← Keyword ranking search
│   ├── task/               ← Legacy task module
│   ├── screenshot/         ← Screenshot API
│   ├── monitor/            ← Server monitoring
│   └── test/               ← Development test endpoints
├── services/               ← Business logic layer
│   ├── ai/                 ← OpenAI integration
│   ├── api/                ← Go API communication
│   ├── behavior/           ← Human behavior simulation
│   ├── browser/            ← Browser session management
│   ├── captcha/            ← CAPTCHA solving
│   ├── check-proxy/        ← Proxy health check
│   ├── domain/             ← Domain lookup
│   ├── email/              ← SMTP email
│   ├── evidence/           ← Evidence collection
│   ├── free-proxy/         ← Free proxy sources
│   ├── google-accounts/    ← Google account management
│   ├── profiles/           ← Browser profile management
│   ├── proxy/              ← Proxy rotation
│   ├── report-tasks/       ← Report platform services
│   ├── screenshot/         ← Screenshot capture & upload
│   ├── search/             ← Search callback
│   ├── webhook/            ← Webhook utilities
│   └── zing-proxy/         ← ZingProxy API
├── config/                 ← Application configuration
│   ├── database/           ← MongoDB connection
│   ├── anticaptcha.config.ts
│   ├── email.config.ts
│   ├── security-vendor-emails.config.ts
│   └── vietnamese-cyber-law.ts
├── types/                  ← TypeScript type definitions
│   ├── global/             ← Global type declarations
│   ├── platforms/          ← Per-platform prompt types
│   └── browser-session.types.ts
└── utils/                  ← Shared utilities
    ├── browser_manager/    ← Chrome automation core
    ├── logger/             ← Logging system
    ├── createElysia.ts     ← Elysia factory
    ├── env.ts              ← Environment config
    ├── error.middleware.ts ← Error handling
    ├── ip-validation.middleware.ts
    ├── logger.ts           ← Logger export
    ├── index.ts            ← Utils barrel export
    ├── oauth2-token-refresh.ts
    ├── report-type.utils.ts
    ├── server-identifier.ts
    ├── smtp-config.utils.ts
    ├── country-form-mapper.ts
    └── email-name-extractor.ts

src/api/task-group/
├── task-group.controller.ts
├── task-group.cron.ts
├── task-group.service.ts
├── task-group.model.ts
├── task-group.dto.ts
├── api-examples/
│   ├── index.ts
│   └── create-multiple.json
├── cron/
│   ├── resource-allocator.ts
│   ├── link-tracker.ts
│   ├── cleanup-service.ts
│   ├── domain/
│   ├── memory/
│   │   └── memory-manager.ts
│   ├── process/
│   │   └── process-orchestrator.ts
│   ├── proxy/
│   ├── report/
│   ├── screenshot/
│   ├── session/
│   └── utils/
└── task-action/
    ├── task-action-executor.ts
    ├── captcha/
    ├── flows/
    │   ├── ads-flow/
    │   ├── coccoc-flow/
    │   ├── home-traffic-flow/
    │   └── kill-flow/
    └── search/

src/api/report-tasks/
├── report-task.controller.ts
├── report-task.cron.ts
├── report-task.model.ts
└── cron/
    ├── report-task-request.service.ts
    ├── memory-manager.ts
    ├── callback/
    │   └── callback-sender.ts
    ├── local/
    │   └── local-report-cascade.service.ts
    ├── platform/
    │   └── platform-executor.ts
    ├── proxy/
    │   └── proxy-manager.ts
    ├── session/
    │   └── session-creator.ts
    └── task-executor/
        └── task-executor.ts

src/api/proxy/
├── proxy.controller.ts
├── proxy.cron.ts
├── proxy.service.ts
├── proxy.model.ts
├── proxy.dto.ts
└── cron/
    └── index.ts

src/api/search/
├── search.controller.ts
├── search.cron.ts
├── search.service.ts
├── search.model.ts
├── search.dto.ts
├── cron/
│   ├── search-executor.ts
│   └── webhook-search.cron.ts
└── flows/
    ├── index.ts
    ├── search-flow-executor.ts
    ├── search-navigator.ts
    ├── search-paginator.ts
    ├── search-results-extractor.ts
    └── search-searcher.ts

services/ai/
├── chatgpt.service.ts              ← Singleton, gọi OpenAI API
├── platform-prompt.service.ts      ← Lấy prompt từ API hoặc fallback
├── platform-prompt-factory.service.ts ← Factory tạo generators
├── indexer.service.ts              ← Index platform services
├── api/
│   └── openai-client.ts            ← OpenAI SDK wrapper
├── cost/
│   └── cost-calculator.ts          ← Tính chi phí per call
├── generic/
│   └── generic-report-generator.ts ← Fallback generator
├── parsers/
│   └── response-parser.ts          ← Parse và validate AI response
├── platform-prompt/
│   ├── json-fixer.ts               ← Sửa malformed JSON
│   ├── fallback-generators/        ← Hardcoded fallback prompts
│   ├── prompt-builders/            ← Build prompts per platform
│   └── report-generators/          ← Generate report content
├── platform-prompt-factory/
│   ├── method-forwarder.ts         ← Forward calls to generators
│   └── generators/                 ← Per-platform generators
├── platforms/
│   ├── platform-methods-handler.ts ← Handle platform-specific methods
│   └── platform-report-generator.ts ← Generate reports
├── prompts/
│   └── report-prompt-builder.ts    ← Build report prompts
├── unified-prompt/
│   ├── builders/                   ← Unified prompt builders
│   ├── generators/                 ← Unified generators
│   ├── mappers/                    ← Map platform data
│   ├── storage/                    ← Cache prompt configs
│   ├── templates/                  ← Prompt templates
│   ├── transformers/               ← Transform AI responses
│   └── utils/                      ← Utilities
└── utils/
    ├── json-fixer.ts               ← JSON repair utility
    └── openai-debug-formatter.ts   ← Debug output formatter

services/browser/
├── enhanced-browser-session.service.ts
└── enhanced-session/
    ├── incognito-session-handler.ts
    ├── profile-session-handler.ts
    ├── human-behavior-integration.ts
    ├── session-cleanup.ts
    ├── session-data-capture.ts
    ├── session-statistics.ts
    └── types.ts

services/captcha/
├── browser-captcha.service.ts       ← Service chính
├── anti-captcha.service.ts          ← Anti-Captcha API v1
├── anticaptcha.service.ts           ← Anti-Captcha API v2
├── anticaptcha-plugin.service.ts    ← Plugin-based approach
├── audio-captcha.service.ts         ← Audio CAPTCHA solving
├── captcha-rate-limiter.service.ts  ← Rate limiting
├── fingerprint-consistency.service.ts ← Fingerprint consistency
├── google-sorry-bypass.service.ts   ← Google "Sorry" bypass
├── google-trust-builder.service.ts  ← Build Google trust
├── detection/
│   ├── captcha-detector.ts          ← Detect CAPTCHA presence
│   ├── confidence-detector.ts       ← Calculate confidence score
│   └── type-detector.ts             ← Identify CAPTCHA type
├── solvers/
│   └── captcha-solver.ts            ← Orchestrate solving
├── recaptcha/
│   └── recaptcha.service.ts         ← reCAPTCHA specific
├── injection/
│   ├── token-injector.ts            ← Inject token into form
│   └── form-type-detector.ts        ← Detect form type
└── stealth/
    └── stealth-applier.ts           ← Apply stealth before solving

services/profiles/
├── profile-manager.service.ts
├── profile.service.ts
├── session-capture.service.ts
├── smart-session-restore.service.ts
└── profile-manager/
    ├── browser-session-creator.ts
    ├── profile-selector.ts
    ├── session-cleanup.ts
    ├── session-manager.ts
    ├── session-restorer.ts
    ├── session-validator.ts
    └── types.ts

utils/browser_manager/
├── index.ts                    ← BrowserManager singleton export
├── browserSession.ts           ← BrowserSession class
├── advanced-stealth.ts         ← Advanced stealth techniques
├── captcha-detector.ts         ← CAPTCHA detection
├── crossSiteBehavior.ts        ← Cross-site navigation
├── device.ts                   ← Device type definitions
├── dom-stability.ts            ← Wait for DOM stability
├── geolocation.ts              ← Geolocation utilities
├── geolocation-handler.ts      ← Handle geolocation requests
├── ghost-cursor-wrapper.ts     ← ghost-cursor library wrapper
├── google-consent-detector.ts  ← Google consent popup detection
├── keywords.ts                 ← Keyword utilities
├── mobile-pre-search.ts        ← Mobile pre-search behavior
├── navigation-retry.ts         ← Retry navigation on failure
├── safe-executor.ts            ← Safe execution wrapper
├── turnstile-detector.ts       ← Cloudflare Turnstile detection
├── types.ts                    ← Type definitions
├── config/
│   ├── browser-flags.ts        ← Chrome launch flags builder
│   ├── browser-launcher.ts     ← Chrome launcher
│   └── resource-manager.ts     ← Resource optimization
├── keywords/
│   ├── download-app-keywords.ts
│   ├── general-keywords.ts
│   └── categories/
├── logger/
│   └── session-logger.ts       ← Log browser session events
├── page/
│   ├── click-handler.ts        ← Click operations
│   ├── navigation-handler.ts   ← Navigation operations
│   ├── page-controller.ts      ← Page lifecycle
│   └── search-handler.ts       ← Search operations
├── session/
│   └── session-manager.ts      ← Active session tracking
└── stealth/
    ├── stealth-applier.ts       ← Apply all stealth
    ├── navigator-stealth.ts     ← navigator patches
    ├── webrtc-stealth.ts        ← WebRTC disable
    ├── webgl-audio-stealth.ts   ← WebGL/Audio spoof
    ├── timezone-stealth.ts      ← Timezone spoof
    ├── permissions-stealth.ts   ← Permissions override
    ├── device-stealth.ts        ← Device properties
    ├── connection-stealth.ts    ← Network connection
    ├── fetch-stealth.ts         ← Fetch API patch
    ├── mouse-event-stealth.ts   ← Mouse events
    ├── service-worker-stealth.ts ← Service worker
    ├── light-stealth.ts         ← Lightweight stealth
    ├── stealth-config/          ← Stealth configurations
    └── stealth-injections/      ← JavaScript injections

utils/logger/
├── index.ts              ← Export logger singleton
├── core-logger.ts        ← Output streams
├── error-categorizer.ts  ← Error classification
├── formatter.ts          ← Message formatting
├── structured-logger.ts  ← Structured logging
└── types.ts              ← Log types

types/global/
├── bun.d.ts                    ← Bun-specific type declarations
├── global.d.ts                 ← Global type augmentations
└── puppeteer-extra-plugins.d.ts ← Type declarations cho puppeteer-extra plugins

types/platforms/
├── base-prompt.types.ts         ← Base interface cho tất cả prompts
├── google-safe-browsing-prompt.types.ts
├── microsoft-smartscreen-prompt.types.ts
├── cloudflare-prompt.types.ts
├── spamhaus-prompt.types.ts
├── netcraft-prompt.types.ts
├── ... (30+ platform types)
├── google/
│   ├── abuse-prompt.types.ts
│   ├── phishing-prompt.types.ts
│   └── security-prompt.types.ts
├── kaspersky/
│   ├── virus-prompt.types.ts
│   ├── spam-prompt.types.ts
│   └── samples-prompt.types.ts
└── ... (nhiều platform folders)

scripts/
├── test-email-accounts.ts          ← Test SMTP connections
├── test-domain-lookup.ts           ← Test DNS lookup
├── test-fallback-proxy.ts          ← Test free proxy sources
├── test-fallback-proxy-production.ts ← Test production proxies
├── test-prompt-email.ts            ← Test AI email generation
├── test-prompt-retrieval.ts        ← Test prompt API
├── test-email-with-custom-prompt.ts ← Test custom prompts
├── test-fallback-trigger.ts        ← Test fallback mechanisms
├── remove-all-collections-batch.ts ← Clear MongoDB
├── list-all-sites.ts               ← List all platforms
├── get-full-prompt.ts              ← Get platform prompt
├── check-task-ai-content.ts        ← Check AI content quality
├── cleanup-old-pending-tasks.js    ← Cleanup old tasks
└── cleanup-old-pending-tasks-batch.js

src/scripts/
├── create-report-tasks.ts      ← Tạo report tasks hàng loạt
├── create-apple-report.ts      ← Tạo Apple-specific report
├── generate-gmail-report.ts    ← Tạo Gmail report
└── generate-netcraft-report.ts ← Tạo Netcraft report

storage/
├── log/                        ← Log files
│   ├── app/
│   │   └── YYYY-MM-DD/
│   │       ├── error.log
│   │       └── combined.log
│   ├── browser_manager/
│   │   └── YYYY-MM-DD/
│   │       ├── crash.log
│   │       └── web_error.log
│   ├── task/
│   │   └── YYYY-MM-DD/
│   │       └── combined.log
│   ├── report/
│   │   └── YYYY-MM-DD/
│   │       └── combined.log
│   ├── proxy/
│   │   └── YYYY-MM-DD/
│   │       └── combined.log
│   └── [service-name]/
│       └── YYYY-MM-DD/
│           └── combined.log
├── google-sessions/            ← Google account session data
│   └── profiles/
│       └── [profile-id]/
│           ├── cookies.json
│           ├── localStorage.json
│           └── sessionStorage.json
└── screenshots/                ← Local screenshot fallback
    └── [task-id]/
        ├── before-click.png
        └── after-click.png

tmp/
└── user-data/                  ← Chrome user profiles (tạm thời)
    └── [session-id]/           ← Mỗi session có folder riêng
        ├── Default/
        │   ├── Cookies
        │   ├── Local Storage/
        │   └── ...
        └── ...

working-proxies/
├── http-proxy-list.json        ← HTTP proxies
├── socks4-proxy-list.json      ← SOCKS4 proxies
└── socks5-proxy-list.json      ← SOCKS5 proxies

{
  "compilerOptions": {
    "target": "ES2021",
    "module": "ES2022",
    "moduleResolution": "node",
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "strict": true,
    "esModuleInterop": true,
    "resolveJsonModule": true,
    "skipLibCheck": true,
    "paths": {
      "@/*": ["./src/*"],
      "@api/*": ["./src/api/*"],
      "@config/*": ["./src/config/*"],
      "@utils/*": ["./src/utils/*"],
      "@services/*": ["./src/services/*"],
      "@typesDef/*": ["./src/types/*"]
    },
    "types": ["bun-types", "jest"]
  }
}

{
  "scripts": {
    "dev": "bun run --inspect=localhost:4000/debugger --watch src/index.ts",
    "build": "bun --target bun build ./src/index.ts --outdir ./dist",
    "compile": "bun build --compile --minify --sourcemap --target=bun ./src/index.ts --outfile=./dist/main",
    "format": "prettier --write src/",
    "lint": "oxlint --fix -D correctness --ignore-path .gitignore",
    "typecheck": "tsc --noEmit --pretty --strictNullChecks --strict",
    "prepare": "husky",
    "script:netcraft": "bun run src/scripts/generate-netcraft-report.ts",
    "script:gmail": "bun run src/scripts/generate-gmail-report.ts",
    "create:report-tasks": "bun run src/scripts/create-report-tasks.ts",
    "remove:all-collections": "bun run scripts/remove-all-collections-batch.ts"
  }
}

{
  "dependencies": {
    "elysia": "^1.2.25",
    "@elysiajs/cron": "^1.2.0",
    "@elysiajs/swagger": "^1.2.2",
    "puppeteer": "^23.11.1",
    "puppeteer-extra": "^3.3.6",
    "puppeteer-extra-plugin-stealth": "^2.11.2",
    "rebrowser-puppeteer-core": "^23.10.3",
    "ghost-cursor": "^1.4.0",
    "mongoose": "^8.12.1",
    "@typegoose/typegoose": "^12.13.0",
    "openai": "^4.67.0",
    "nodemailer": "^7.0.9",
    "axios": "^1.8.3",
    "async-mutex": "^0.5.0",
    "https-proxy-agent": "^7.0.6",
    "socks-proxy-agent": "^8.0.5",
    "tree-kill": "^1.2.2",
    "zod": "^3.23.8",
    "uuid": "^11.1.0",
    "chalk": "^5.4.1"
  },
  "devDependencies": {
    "bun-types": "latest",
    "oxlint": "^0.16.0",
    "prettier": "^3.5.3",
    "husky": "^9.1.7",
    "lint-staged": "^16.1.0",
    "playwright": "^1.56.1",
    "typescript": "^5.8.2"
  },
  "engines": {
    "bun": ">=1.2.5"
  }
}