Database Schema — Complete Reference

Field	Kiểu	Required	Default	Mô tả
`_id`	ObjectID	✅	auto	ID Proxy
`ip`	string	✅	—	IP nội bộ Proxy
`port`	int	✅	—	Port Proxy
`username`	string	✅	—	Username xác thực
`password`	string	✅	—	Password xác thực
`ip_public`	string	✅	—	IP Public thực tế
`rotate_url`	string	✅	—	URL API xoay IP (`zingproxy`, `enode`...)
`rotate_time`	int		0	Chu kỳ xoay (giây)
`next_rotate`	datetime		—	Thời điểm xoay tiếp theo
`last_used_at`	datetime		—	Lần sử dụng cuối
`in_use`	int		0	Task đang dùng đồng thời
`used_count`	int		0	Tổng số lần dùng
`domain_used`	array[TaskUseProxy]		[]	Log domain đã truy cập qua Proxy
`domain_blocks`	array[string]		[]	Domain bị block với Proxy này
`is_active`	bool		true	Proxy đang hoạt động
`is_rotating`	bool		false	Đang trong quá trình xoay IP
`is_captcha`	bool		false	Gặp Captcha lần cuối
`is_error`	bool		false	Đang gặp lỗi
`is_success`	bool		false	Lần cuối thành công
`error_count`	int		0	Số lỗi liên tiếp
`disable_auto_rotate`	bool		false	Tắt tự động xoay
`auth_token`	string?		null	JWT Token nếu dùng Auth provider
`area`	string		`"global"`	Khu vực IP: `global` hoặc `vn`
`region`	string		`""`	Vùng địa lý chi tiết
`package_name`	string?		null	Tên gói Proxy đã mua
`proxy_package_id`	ObjectID		—	FK → `proxy_packages._id`
`proxy_price`	float64?		null	Giá Proxy
`expired_at`	datetime?		null	Ngày hết hạn gói
`rotate_server`	string?		null	Server xoay IP
`created_by`	int		0	User ID người tạo
`updated_by`	int		0	User ID người cập nhật
`created_at`	datetime		auto	Ngày tạo
`updated_at`	datetime		auto	Ngày cập nhật

Sub-document: TaskUseProxy (bên trong domain_used)

Field	Kiểu	Mô tả
`task_id`	string	ID Task đã dùng Proxy
`domain`	string	Domain đã truy cập
`organic_engine`	int?	Engine tìm kiếm (0=GoogleVN, 1=Google, 2=CocCoc)

📦 Collection: `tasks` (API)

Task điều phối từ hệ thống Admin gửi xuống Workers.

Field	Kiểu	Required	Mô tả
`_id`	ObjectID	✅	MongoDB ID
`project_id`	int	✅	FK → MySQL `projects.id`
`proxy_url`	string	✅	Webhook lấy Proxy
`webhook_url`	string	✅	Webhook nhận kết quả
`result_status`	int		`0`=Unknown, `1`=Success, `-1`=Error, `-2`=NotFound, `-3`=Captcha
`result_status_tmp`	int		Trạng thái tạm thời
`result_error`	string		Thông báo lỗi
`traffic_type`	object[TrafficType]	✅	Cấu hình luồng traffic
`traffic_device`	int	✅	`0`=Desktop, `1`=Mobile
`device_os`	int		OS thiết bị
`status`	int		`0`=Pending, `1`=Processing, `2`=Completed
`page_view`	array[PageView]		Thời gian đọc trang
`geolocation`	object[GeoLocation]		Tọa độ GPS
`campaign_id`	int		ID chiến dịch
`project_detail_id`	int		ID project detail
`execution_time`	int		Thời gian thực thi (ms)
`mark`	string?		Nhãn đánh dấu
`profile_id`	string?		Profile Fingerprint ID
`server_id`	int?		ID Worker Server
`created_at`	datetime		Ngày tạo
`updated_at`	datetime		Ngày cập nhật

📦 Collection: `profiles`

Kho lưu trữ thông tin nhân vật (Persona Fingerprint) dùng để gửi report, click traffic.

Field	Kiểu	Required	Mô tả
`_id`	ObjectID	✅	MongoDB ID
`profile_id`	string	✅	Profile Business ID (e.g. UUID)
`server_id`	string		ID Server đang giữ Profile
`proxy_id`	string		Proxy ID gán cho Profile
`used_for`	string		Mục đích: `report`, `traffic`
`name`	string	✅	Tên đầy đủ của Persona
`email`	string	✅	Email tài khoản Google
`password`	string	✅	Mật khẩu email
`app_password`	string?		App Password Gmail (SMTP)
`refresh_token`	string?		OAuth2 Refresh Token
`client_id`	string?		OAuth2 Client ID
`recovery_email`	string		Email khôi phục
`is_active`	bool		Có đang hoạt động không
`failed_login_attempts`	int		Số lần đăng nhập lỗi
`last_failed_login_at`	datetime?		Lần đăng nhập lỗi cuối
`last_used_at`	datetime?		Lần sử dụng cuối
`cooldown_end`	datetime?		Kết thúc thời gian nghỉ ngơi
`cooldown_until`	datetime?		Cooldown đến khi nào
`cooldown`	int		Thời gian cooldown (phút)
`server_region`	string		Vùng server
`proxy_region`	string		Vùng proxy
`profile_name`	string		Tên hiển thị Profile
`phone`	string		Số điện thoại
`country`	string		Quốc gia
`timezone`	string		Múi giờ
`device_type`	string		Loại thiết bị
`browser_type`	string		Loại trình duyệt
`operating_system`	string		OS
`screen_resolution`	string		Độ phân giải màn hình
`user_agent`	string		User-Agent HTTP Header
`ip_address`	string		IP đang gán
`location`	string		Địa chỉ dạng text
`latitude`	float64		Vĩ độ GPS
`longitude`	float64		Kinh độ GPS
`total_clicks`	int		Tổng số lần click
`total_searches`	int		Tổng số lần tìm kiếm
`last_activity`	datetime?		Hoạt động cuối
`profile_age`	int		Tuổi Profile (ngày)
`is_verified`	bool		Đã xác minh chưa
`is_blocked`	bool		Bị block chưa
`block_reason`	string?		Lý do bị block
`notes`	string?		Ghi chú
`deleted_at`	datetime?		Soft delete
`created_at`	datetime		Ngày tạo
`updated_at`	datetime		Ngày cập nhật

📦 Collection: `profile_sessions`

Phiên đăng nhập của Profile vào Google.

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`profile_id`	ObjectID	FK → `profiles._id`
`session_id`	string	Session định danh
`user_agent`	string	User-Agent của phiên
`ip_address`	string	IP đang dùng
`status`	string	Trạng thái phiên
`is_active`	bool	Đang hoạt động
`is_valid`	bool	Session còn hợp lệ
`created_at`	datetime	Ngày tạo
`expires_at`	datetime	Ngày hết hạn
`last_activity`	datetime	Hoạt động cuối

📦 Collection: `keywords`

Từ khóa tìm kiếm được quản lý cho tính năng theo dõi thứ hạng SERP.

Field	Kiểu	Required	Mô tả
`_id`	ObjectID	✅	ID
`keyword`	string	✅	Chuỗi từ khóa
`status`	int		`0`=Disable, `1`=Enable
`sort`	int		Độ ưu tiên sắp xếp
`device`	array[int]		Thiết bị cần quét: `[0]`=Desktop, `[1]`=Mobile
`device_os`	map[string][]int		Map OS theo device
`engine`	array[int]		Engine quét: `0`=GoogleVN, `1`=Google, `2`=CocCoc
`result_num`	int		Số kết quả SERP cần cào
`is_running`	bool		Đang chạy Cron
`created_by`	int		User ID tạo
`created_at`	datetime		Ngày tạo
`updated_at`	datetime		Ngày cập nhật

📦 Collection: `keyword_results`

Lưu kết quả SERP cào được theo từng lần chạy.

Field	Kiểu	Required	Mô tả
`_id`	ObjectID	✅	ID
`keyword`	string	✅	Từ khóa
`keyword_id`	string		FK string → `keywords`
`keyword_schedule_id`	ObjectID		FK → `keyword_schedules._id`
`device`	int		`0`=Desktop, `1`=Mobile
`device_os`	int		OS
`engine`	int		`0`=GoogleVN, `1`=Google, `2`=CocCoc
`result_num`	int		Số kết quả đã cào
`geolocation`	object		Tọa độ GPS
`is_scan_domain`	bool		Có quét domain không
`search_data`	object[SearchData]		Dữ liệu kết quả
`created_at`	datetime		Ngày tạo
`updated_at`	datetime		Ngày cập nhật

Sub-document: SearchData

Field	Kiểu	Mô tả
`ads`	array[SearchResult]	Kết quả Quảng cáo
`search`	array[SearchResult]	Kết quả tự nhiên

Sub-document: SearchResult

Field	Kiểu	Mô tả
`url`	string	URL kết quả
`rank`	int	Thứ hạng (1 = đầu tiên)
`type`	string	`company` hoặc `competitors`
`action_status`	string	`unknow`, `kill`, `killed`
`confirm_status`	bool	Đã xác nhận chưa
`label`	string	Nhãn
`created_at`	datetime	Ngày tạo entry này

📦 Collection: `keyword_schedules`

Lịch quét SERP tự động theo từng từ khóa + Engine.

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`keyword_id`	string	FK → `keywords`
`engine`	int	Engine quét (0/1/2)
`scan_desktop`	int	Số lần quét Desktop đã thực hiện
`scan_mb`	int	Số lần quét Mobile đã thực hiện
`created_at`	datetime	Ngày tạo

📦 Collection: `task_logs`

Log tóm tắt mỗi lượt Traffic thực thi.

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`keyword`	string	Từ khóa đã dùng
`user_agent`	string	User-Agent Browser
`link`	string	URL đã truy cập
`date`	datetime	Thời điểm ghi log

📦 Collection: `proxy_packages`

Gói Proxy đã mua từ các nhà cung cấp (ZingProxy, Enode,...).

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`code`	string	Mã code gói
`name`	string	Tên gói
`price`	int	Giá (VNĐ hoặc USD)
`note`	string	Ghi chú
`proxy_provider_id`	ObjectID?	FK → `proxy_providers._id`
`proxy_provider`	embed{id, name}	Thông tin provider (denormalized)
`active`	bool	Gói đang kích hoạt
`created_at`	datetime	Ngày tạo
`updated_at`	datetime	Ngày cập nhật

📦 Collection: `proxy_providers`

Nhà cung cấp Proxy (ZingProxy, Enode, M2Proxy,...).

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`name`	string	Tên nhà cung cấp
`account`	string	Tài khoản đăng nhập
`domain`	string	Domain nhà cung cấp
`active`	bool	Đang sử dụng
`created_at`	datetime	Ngày tạo
`updated_at`	datetime	Ngày cập nhật

📦 Collection: `proxy_ip_logs`

Lịch sử IP Public của mỗi Proxy sau mỗi lần xoay.

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`proxy_id`	ObjectID?	FK → `proxies._id`
`ip`	string	IP Public sau khi xoay
`supplier`	string	Tên nhà cung cấp proxy
`region`	string?	Vùng địa lý
`total`	int	Số lần xoay ra IP này
`created_at`	datetime	Ngày tạo
`updated_at`	datetime	Ngày cập nhật

📦 Collection: `backup_proxies`

Kho Proxy dự phòng khi Proxy chính lỗi.

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`host`	string	IP Proxy
`port`	int	Port
`username`	string	Username
`password`	string	Password
`type`	string	`http`, `https`, `socks4`, `socks5`
`country`	string	Quốc gia
`region`	string	Vùng địa lý
`ip_public`	string	IP Public
`is_working`	bool	Có hoạt động không
`last_tested`	datetime	Lần kiểm tra cuối
`success_count`	int	Số lần thành công
`failure_count`	int	Số lần thất bại (≥3 → is_working=false)
`source`	string	Nguồn: GitHub repo URL, tên nhà cung cấp
`created_at`	datetime	Ngày tạo
`updated_at`	datetime	Ngày cập nhật

📦 Collection: `free_proxies`

Proxy miễn phí thu thập từ các nguồn công cộng (GitHub,...).

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`host`	string	IP Proxy
`port`	int	Port
`username`	string	Username (thường trống)
`password`	string	Password (thường trống)
`type`	string	`http`, `https`, `socks4`, `socks5`
`country`	string	Quốc gia
`region`	string	Vùng
`is_working`	bool	Đang hoạt động
`last_tested`	datetime	Lần test cuối
`success_count`	int	Số lần thành công
`failure_count`	int	Số lần thất bại (≥5 → is_working=false)
`source`	string	Nguồn GitHub URL
`created_at`	datetime	Ngày tạo
`updated_at`	datetime	Ngày cập nhật

📦 Collection: `coccoc_tokens`

Quản lý Token đăng nhập CocCoc cho tính năng click quảng cáo CocCoc Ads.

Field	Kiểu	Mô tả
`_id`	ObjectID	ID
`token`	object{cc_t, uid}	Token CocCoc (`cc_t` + `uid`)
`locked`	ObjectID?	TaskID đang giữ lock (null = rảnh)
`used`	int	Số lần dùng trong ngày (reset khi unlock)
`success_count`	int	Số lần thành công trong ngày
`error_count`	int	Số lần lỗi trong ngày
`used_total`	int	Tổng số lần dùng mọi thời điểm
`first_used_at`	datetime?	Lần đầu sử dụng
`last_used_at`	datetime?	Lần sử dụng cuối
`unlock_at`	datetime?	Thời điểm tự động unlock
`created_at`	datetime	Ngày tạo
`updated_at`	datetime	Ngày cập nhật

MongoDB — DB: `traffic-tool` (Tools V2 / ElysiaJS)

📦 Collection: `task_groups` (Tools V2)

Nhóm Task được đẩy xuống từ API Admin tới Worker. Worker sẽ kéo từng group về để chạy.

Field	Kiểu	Required	Default	Mô tả
`_id`	string (hex)	✅	auto	ID nhóm
`proxy_webhook`	string	✅	—	URL API lấy Proxy assignment
`status`	int		0	`0`=PENDING, `1`=PROCESSING, `2`=COMPLETED
`proxy`	object[Proxy]		null	Proxy đang dùng cho nhóm
`proxy_id`	string		null	Proxy ObjectId đã gán
`user_agent`	string		null	User-Agent Browser
`geolocation`	object{lat, lng}		null	Tọa độ GPS ghi đè
`tasks`	array[Task]	✅	—	Mảng Task con (embed)
`retries_total`	int		0	Số lần đặt lại về PENDING
`createdAt`	datetime		auto	Ngày tạo
`updatedAt`	datetime		auto	Ngày cập nhật

Sub-document: Proxy bên trong task_groups

Field	Kiểu	Mô tả
`host`	string	IP nội bộ Proxy
`port`	int	Port
`username`	string?	Username
`password`	string?	Password
`type`	string?	`http`, `https`, `socks4`, `socks5`

📦 Collection: `tasks` (Tools V2)

Chi tiết từng lượt chạy Traffic của Worker. Có thể embedded trong task_groups.tasks hoặc truy vấn độc lập.

Field	Kiểu	Required	Default	Mô tả
`_id`	string (hex)	✅	auto	DB ID
`id`	string	✅	—	Business ID từ Admin (e.g. `task-aituvi-1234`)
`project_id`	int	✅	—	FK → MySQL `projects.id`
`proxy_url`	string	✅	—	Webhook lấy Proxy
`webhook_url`	string	✅	—	Webhook trả kết quả
`call_webhook_count`	int		0	Số lần đã gọi webhook
`page_view`	array[PageView]	✅	—	Khoảng thời gian đọc trang
`traffic_type`	object[TrafficType]	✅	—	Config luồng traffic
`traffic_device`	int	✅	—	`0`=Desktop, `1`=Mobile
`device_os`	int?		null	OS thiết bị
`result_status`	int		0	`0`=Unknown, `1`=Success, `-1`=Error, `-2`=NotFound, `-3`=Captcha
`result_error`	string		null	Thông báo lỗi từ Worker
`ip_public`	string		null	IP thực tế khi chạy
`rank`	int		null	Thứ hạng tìm thấy trên Google
`execution_time`	int		0	Thời gian thực thi (ms)
`user_agent`	string		null	User-Agent đã dùng
`geolocation`	object{lat, lng}		null	Tọa độ GPS
`ads_relations`	array[AdsRelation]		[]	Config click quảng cáo chéo
`resolved_projects`	array[ResolvedProject]		null	Project đã giải quyết
`screenshot_url`	string		null	URL ảnh chụp màn hình
`screenshot_key`	string		null	Storage key ảnh chụp
`profile_id`	string		null	Profile Fingerprint ID
`retry_count`	int		0	Số lần retry
`createdAt`	datetime		auto	—
`updatedAt`	datetime		auto	—

Sub-document: TrafficType

Field	Kiểu	Required	Mô tả
`method`	int	✅	`0`=DIRECT, `1`=ORGANIC
`organic_engine`	int?		`0`=Google.vn, `1`=Google, `2`=CocCoc
`search_keyword`	string?		Từ khóa tìm kiếm
`only_ads`	bool	✅	Chỉ click quảng cáo
`is_kill`	bool	✅	Click Fraud / giết ngân sách
`links`	array[string]	✅	Danh sách URL đích
`ads_relations`	array[AdsRelation]?		Config click chéo quảng cáo

Sub-document: PageView

Field	Kiểu	Mô tả
`time_min`	int	Thời gian tối thiểu đọc trang (giây)
`time_max`	int	Thời gian tối đa đọc trang (giây)

Sub-document: AdsRelation

Field	Kiểu	Mô tả
`project_id`	int	ID Project partner
`project_detail_id`	int	ID Project Detail
`link`	string	URL quảng cáo partner

Sub-document: ResolvedProject

Field	Kiểu	Mô tả
`is_parent`	bool	Là project cha
`project_id`	int	ID Project
`project_detail_id`	int	ID Project Detail
`link`	string	URL

📦 Collection: `proxies` (Tools V2)

Proxy pool cục bộ của Worker server, khác với proxies của API.

Field	Kiểu	Required	Default	Mô tả
`_id`	string	✅	auto	ID
`ip`	string	✅	—	IP Proxy
`port`	int	✅	—	Port
`username`	string		—	Username xác thực
`password`	string		—	Password xác thực
`ip_public`	string	✅	—	IP Public
`webhook_url`	string	✅	—	URL thông báo kết quả
`rotate_url`	string	✅	—	URL xoay Proxy
`auth_token`	string?		null	JWT Token provider
`status`	int		0	`0`=PENDING, `1`=PROCESSING, `2`=COMPLETED
`in_use`	int		0	Số Task đang dùng
`is_active`	bool		true	Đang hoạt động
`is_error`	bool		false	Đang lỗi
`is_success`	bool		false	Lần cuối thành công
`is_captcha`	bool		false	Gặp Captcha
`error_count`	int		0	Số lỗi liên tiếp
`used_count`	int		0	Tổng số lần dùng
`call_webhook_count`	int		0	Số lần gọi webhook
`retry_count`	int		0	Số lần retry
`disable_auto_rotate`	bool		false	Tắt tự động xoay
`last_used_at`	datetime?		null	Lần dùng cuối
`expired_at`	datetime?		null	Ngày hết hạn
`area`	string		`""`	Khu vực
`region`	string		`""`	Vùng địa lý
`package_name`	string		`""`	Tên gói
`proxy_price`	float		0	Giá Proxy
`domain_used`	array		null	Domain đã dùng
`domain_blocks`	array[string]		[]	Domain bị block
`status_code`	int?		—	HTTP status code
`response`	string?		—	HTTP Response
`created_at`	datetime		auto	Ngày tạo
`updated_at`	datetime		auto	Ngày cập nhật

📦 Collection: `search`

Task cào kết quả SERP tự động (SEO Tool).

Field	Kiểu	Required	Default	Mô tả
`_id`	string	✅	auto	ID
`keyword`	string	✅	—	Từ khóa tìm kiếm
`engine`	int	✅	—	`0`=Google.vn, `1`=Google, `2`=CocCoc
`device`	int	✅	—	`0`=Desktop, `1`=Mobile
`device_os`	int?		null	OS
`result_num`	int	✅	—	Số kết quả SERP cào
`web_hook_url`	string	✅	—	Webhook nhận kết quả SERP
`web_hook_sent`	int		0	Đã gửi Webhook (0=chưa, 1=đã gửi)
`proxy_url`	string	✅	—	Webhook lấy Proxy
`status`	int		0	`0`=PENDING, `1`=RUNNING, `2`=COMPLETED
`search_data`	object[SearchData]		null	Kết quả SERP
`proxy`	object		null	Proxy đã dùng
`geolocation`	object{lat, lng}		null	Tọa độ GPS
`createdAt`	datetime		auto	—
`updatedAt`	datetime		auto	—

Sub-document: SearchData

Field	Kiểu	Mô tả
`ads`	array[{url, rank}]	Quảng cáo tìm thấy
`search`	array[{url, rank}]	Kết quả tự nhiên

📦 Collection: `report_tasks`

Mỗi document là 1 yêu cầu báo cáo domain lên 1 tổ chức bảo mật cụ thể.

Field	Kiểu	Required	Default	Mô tả
`_id`	string	✅	auto	ID
`domain`	string	✅	—	Domain cần báo cáo
`keyword`	string	✅	—	Từ khóa liên quan
`platform`	string	✅	—	Tên tổ chức nhận báo cáo
`report_type`	string	✅	—	`BROWSER_BASED` hoặc `EMAIL_BASED`
`platform_url`	string		null	URL form báo cáo
`status`	string	✅	`PENDING`	`PENDING`, `IN_PROGRESS`, `COMPLETED`, `FAILED`, `CANCELLED`
`priority`	int		1	Ưu tiên (1-10, cao = chạy trước)
`report_domain_id`	string		null	Liên kết domain trong API
`domain_type`	string		`normal`	`normal` hoặc `google_ads`
`profile_country`	string		`Vietnam`	Quốc gia của Profile
`proxy_url`	string?		null	Webhook lấy Proxy
`profile_url`	string?		null	Webhook lấy Profile
`assigned_account_id`	string?		null	Google Account ID đã gán
`assigned_proxy_id`	string?		null	Proxy ObjectId đã gán
`assigned_profile_id`	string?		null	Profile ID đã gán
`report_date`	string	✅	—	Ngày báo cáo `YYYY-MM-DD`
`unique_key`	string	✅ unique	—	Khoá duy nhất chống trùng
`scheduled_for`	datetime	✅	—	Thời điểm lên lịch chạy
`retry_count`	int		0	Số lần retry hiện tại
`max_retries`	int		3	Giới hạn retry
`started_at`	datetime?		null	Thời điểm bắt đầu
`completed_at`	datetime?		null	Thời điểm hoàn thành
`execution_time`	int?		null	Thời gian thực thi (ms)
`result`	object[ReportTaskResult]		null	Kết quả chi tiết
`error`	string?		null	Thông báo lỗi
`proxy_snapshot`	object[ProxySnapshot]		null	Proxy snapshot lúc tạo
`use_proxy_snapshot`	bool		true	Dùng snapshot thay live proxy
`fallback_proxy_id`	string?		null	Proxy dự phòng
`callback_sent`	bool		false	Đã gọi callback về API chưa
`callback_sent_at`	datetime?		null	Thời điểm gọi callback
`callback_response`	string?		null	Response API callback
`callback_retry_count`	int		0	Số lần retry callback
`webhook_url`	string?		null	Webhook nhận kết quả
`api_task_id`	string?		null	Task ID gốc từ API
`platform_type`	string?		null	`browser`, `email`
`server`	string?		null	Server đang thực thi
`gpt_raw_prompt`	string?		null	Raw GPT prompt (debug)
`image_urls`	array[string]		[]	Hình ảnh bằng chứng
`video_urls`	array[string]		[]	Video bằng chứng
`createdAt`	datetime		auto	—
`updatedAt`	datetime		auto	—

Sub-document: ReportTaskResult

Field	Kiểu	Mô tả
`success`	bool	Thành công hay không
`message`	string	Thông điệp kết quả
`reportId`	string?	ID báo cáo từ platform
`platform`	string	Tên platform
`reportType`	string	`BROWSER_BASED` / `EMAIL_BASED`
`submittedAt`	datetime	Thời điểm submit
`url`	string	URL đã submit
`error`	string?	Lỗi nếu có
`responseTime`	int?	Thời gian phản hồi (ms)
`executionTime`	int?	Thời gian thực thi (ms)
`screenshotUrl`	string?	URL ảnh chụp màn hình
`screenshotKey`	string?	Storage key
`emailRecipients`	array[string]?	Danh sách email đã gửi
`emailSuccessCount`	int?	Số email gửi thành công
`emailFailureCount`	int?	Số email gửi thất bại
`emailResults`	array[{recipient, success, messageId?, error?}]?	Chi tiết từng email
`aiMetadata`	object[AIGenerationMetadata]?	Metadata GPT
`profileEmail`	string?	Email Profile đã dùng

MySQL — DB: `tool_traffic_api` (API Golang)

🗃️ Table: `users`

Column	Kiểu SQL	Required	Default	Mô tả
`id`	int AUTO_INCREMENT PK	✅	—	User ID
`name`	varchar(255) NOT NULL	✅	—	Họ tên đầy đủ
`email`	varchar(255) UNIQUE NOT NULL	✅	—	Email đăng nhập
`password`	varchar(255) NOT NULL	✅	—	Hash bcrypt
`first_name`	varchar(255)		—	Tên
`last_name`	varchar(255)		—	Họ
`secret_key`	varchar(255)		—	Secret key TOTP cho 2FA
`two_factor`	tinyint(1)		`0`	Bật 2FA
`role`	int		`1`	`0`=Admin, `1`=User
`last_active_at`	datetime		auto	Hoạt động cuối
`device_token`	varchar(255)		—	Token thiết bị đang đăng nhập
`is_logged_in`	tinyint(1)		`0`	Trạng thái đăng nhập hiện tại
`created_at`	datetime		auto	—
`updated_at`	datetime		auto	—
`deleted_at`	datetime		null	Soft delete GORM

🗃️ Table: `campaigns`

Column	Kiểu SQL	Required	Mô tả
`id`	int AUTO_INCREMENT PK	✅	ID
`name`	varchar(255) NOT NULL	✅	Tên chiến dịch
`description`	varchar(255)		Mô tả
`user_id`	int FK→users.id	✅	Chủ chiến dịch
`configs`	json		Config: `{ active, max, percent }`
`created_at`	datetime		—
`updated_at`	datetime		—

JSON column configs:

{ "active": true, "max": 100, "percent": 80 }

🗃️ Table: `projects`

Bảng trung tâm nhất của MySQL, lưu mỗi Domain target cần boost traffic.

Column	Kiểu SQL	Required	Default	Mô tả
`id`	int AUTO_INCREMENT PK	✅	—	ID
`name`	varchar(255) NOT NULL	✅	—	Tên dự án
`campaign_id`	int FK→campaigns.id	✅	—	Thuộc chiến dịch nào
`user_id`	int FK→users.id	✅	—	Chủ sở hữu
`status`	int CHECK IN(0,1)	✅	`1`	`0`=Inactive, `1`=Active
`total_process`	int	✅	`1`	Số lượt chạy mỗi ngày
`traffic_type`	int	✅	`1`	`0`=Direct, `1`=Organic
`traffic_device`	int	✅	`1`	`0`=Desktop, `1`=Mobile
`traffic_device_os`	int	✅	`0`	OS thiết bị
`organic_engine`	int?		null	`0`=Google.vn, `1`=Google, `2`=CocCoc
`search_keyword`	varchar(255)?		null	Từ khóa tìm kiếm
`keyword_id`	varchar(255)		—	ID từ khóa quản lý
`sort`	int		`1`	Thứ tự ưu tiên chạy
`links`	json	✅	—	Mảng URL đích
`only_ads`	tinyint(1)	✅	`0`	Chỉ click Quảng Cáo
`is_kill`	tinyint(1)	✅	`0`	Click Fraud
`attribute`	json	✅	—	`time_frame[]` + `time_on_page[]`
`state`	int CHECK IN(0,1,2)		`1`	`0`=Unknown, `1`=Kill, `2`=Dead
`state_time`	datetime?		null	Thời điểm chuyển state
`dead_time`	json		—	Khung giờ dừng chạy
`geolocation`	json		—	`{ lat, lng }`
`is_traffic_fixed`	tinyint(1)		`0`	Traffic cố định
`testable`	int		`0`	Chế độ test
`created_at`	datetime		auto	—
`updated_at`	datetime		auto	—

Cấu trúc JSON attribute:

{
  "time_frame": [{ "time_start": "08:00", "time_end": "12:00", "process": 10 }],
  "time_on_page": [{ "time_min": 30, "time_max": 120 }]
}

🗃️ Table: `project_details`

Thống kê lượt chạy traffic thực tế từng giờ của mỗi Project.

Column	Kiểu SQL	Required	Default	Mô tả
`id`	int AUTO_INCREMENT PK	✅	—	ID
`project_id`	int FK→projects.id	✅	—	Thuộc Project
`total_process`	int		`0`	Tổng số lượt gửi
`total_success`	int		`0`	Số lượt thành công
`total_fail`	int		`0`	Số lượt thất bại
`hour`	int	✅	`0`	Giờ (0–23)
`date`	varchar(10) NOT NULL	✅	—	Ngày (`YYYY-MM-DD`)
`rank`	int?		null	Thứ hạng Google trong giờ này
`total_tmp`	int?		null	Số lượt tạm (trung gian)

🗃️ Table: `project_settings`

Cấu hình mapping giữa Project — Proxy — Server.

Column	Kiểu SQL	Required	Mô tả
`id`	int AUTO_INCREMENT PK	✅	ID
`project_id`	int	✅	FK → projects.id
`proxy_id`	int	✅	Proxy phân công
`server_id`	int	✅	Worker Server phân công
`created_at`	datetime		—
`updated_at`	datetime		—
`deleted_at`	datetime		Soft delete

🗃️ Table: `servers`

Đăng ký các Worker Server vào hệ thống quản lý.

Column	Kiểu SQL	Required	Default	Mô tả
`id`	int AUTO_INCREMENT PK	✅	—	ID
`name`	varchar(255) NOT NULL	✅	—	Tên Worker Server
`ip`	varchar(255) NOT NULL	✅	—	IP Server (dùng để gọi webhook)
`is_active`	tinyint(1)		`0`	Đang online
`limit_process`	int		0	Giới hạn Task chạy đồng thời
`current_process`	int		0	Số Task đang chạy hiện tại
`created_at`	datetime		auto	—
`updated_at`	datetime		auto	—
`deleted_at`	datetime		null	Soft delete

🗃️ Table: `server_hourly_reports`

Thống kê kết quả Traffic từng giờ theo Server.

Column	Kiểu SQL	Required	Default	Mô tả
`id`	int AUTO_INCREMENT PK	✅	—	ID
`server_id`	int? FK→servers.id		null	Server (null = tổng hợp)
`report_date`	date NOT NULL	✅	—	Ngày báo cáo
`hour_start`	tinyint NOT NULL	✅	—	Giờ (0–23)
`process`	int		0	Tổng lượt xử lý
`success`	int		0	Thành công
`fail`	int		0	Thất bại
`waiting`	int		0	Đang chờ
`captcha`	int		0	Gặp CAPTCHA
`error`	int		0	Lỗi kỹ thuật
`notfound`	int		0	Không tìm thấy URL
`unknown`	int		0	Kết quả chưa xác định
`r_success`	int		0	Thành công (Report task)
`r_fail`	int		0	Thất bại (Report task)
`r_captcha`	int		0	CAPTCHA (Report task)
`r_error`	int		0	Lỗi (Report task)
`r_notfound`	int		0	Không tìm thấy (Report task)
`r_unknown`	int		0	Chưa xác định (Report task)
`total_task`	int		0	Tổng task trong giờ
`created_at`	datetime		auto	—
`updated_at`	datetime		auto	—

🗃️ Table: `activity_logs`

Audit log mọi thao tác CRUD của user trong hệ thống.

Column	Kiểu SQL	Required	Mô tả
`id`	int AUTO_INCREMENT PK	✅	ID
`user_id`	int? FK→users.id		Người thực hiện
`action`	varchar(255) NOT NULL	✅	Loại thao tác (tạo/sửa/xóa)
`parameter`	json?		Tham số đầu vào
`model_name`	varchar(255) NOT NULL	✅	Tên entity bị tác động
`model_id`	int NOT NULL	✅	ID của entity bị tác động
`old_value`	json?		Giá trị trước khi thay đổi
`new_value`	json?		Giá trị sau khi thay đổi
`ip_address`	varchar(255)		IP của user
`user_agent`	varchar(255)		Browser User-Agent
`created_at`	datetime		—
`updated_at`	datetime		—

🗃️ Table: `system_settings`

Key-Value store cho cài đặt hệ thống động.

Column	Kiểu SQL	Required	Mô tả
`id`	int AUTO_INCREMENT PK	✅	ID
`key`	varchar(255) UNIQUE NOT NULL	✅	Tên cài đặt
`value`	text NOT NULL	✅	Giá trị
`created_at`	datetime		—
`updated_at`	datetime		—
`deleted_at`	datetime		Soft delete

Keys được định nghĩa sẵn:

Key	Mô tả
`telegram_notification_enabled`	Bật/tắt thông báo Telegram

🗃️ Table: `setup_fires`

Cấu hình chiến dịch "fire" — bắn traffic vào chiến dịch Google Ads hoặc CocCoc Ads cụ thể.

Column	Kiểu SQL	Required	Mô tả
`id`	int AUTO_INCREMENT PK	✅	ID
`campaign_gg_id`	int	✅	ID chiến dịch Google Ads
`campaign_cc_id`	int	✅	ID chiến dịch CocCoc Ads
`created_at`	datetime		—
`updated_at`	datetime		—

Sơ đồ quan hệ

MySQL (tool_traffic_api)                    MongoDB (tool-traffic-api)
══════════════════════                     ══════════════════════════
users ◄──── campaigns ◄──── projects       proxies ◄── proxy_packages
              │                │                         └── proxy_providers
              │                │            profiles ◄── profile_sessions
              │                ├──► project_details
              │                └──► project_settings──►servers     keyword_results
              │                                           ↑             │
              └──────────────── server_hourly_reports     │        keyword_schedules
users ◄── activity_logs                              task_logs    keywords
system_settings (key-value)                          tasks (API)
setup_fires                                          coccoc_tokens
                                                     proxy_ip_logs
                                                     backup_proxies
                                                     free_proxies

MongoDB (traffic-tool — Tools V2)
══════════════════════════════
task_groups ──► tasks[] (embed)
proxies (pool riêng)
search
report_tasks

Cross-DB Links:
projects.id ←→ tasks.project_id (Tools V2)
projects.id ←→ task_groups.tasks[].project_id

Enum & Hằng số

Enum	Giá trị	Mô tả
Traffic Method	`0` = Direct, `1` = Organic	Cách tiếp cận domain
Traffic Engine	`0` = Google.vn, `1` = Google, `2` = CocCoc	Công cụ tìm kiếm
Traffic Device	`0` = Desktop, `1` = Mobile	Loại thiết bị
Desktop OS	`0` = Windows, `1` = MacOS	OS Desktop
Mobile OS	`0` = Android, `1` = iPhone	OS Mobile
Task Status	`0` = Pending, `1` = Processing, `2` = Completed	Trạng thái Task
Task Result	`0` = Unknown, `1` = Success, `-1` = Error, `-2` = NotFound, `-3` = Captcha	Kết quả Task
Report Status	`PENDING`, `IN_PROGRESS`, `COMPLETED`, `FAILED`, `CANCELLED`	Trạng thái Report Task
Report Type	`BROWSER_BASED`, `EMAIL_BASED`	Cách thức báo cáo
User Role	`0` = Admin, `1` = User	Phân quyền
Project State	`0` = Unknown, `1` = Kill, `2` = Dead	Tình trạng Project
Proxy Area	`global`, `vn`	Khu vực Proxy
Domain Type	`company`, `competitors`	Loại domain trong SERP
Action Status	`unknow`, `kill`, `killed`	Trạng thái SERP action
Search Status	`0` = PENDING, `1` = RUNNING, `2` = COMPLETED	Trạng thái Search Task

Database Schema

Database Schema — Complete Reference#

Mục lục#

MongoDB (DB: tool-traffic-api — dùng bởi API Golang)#

MongoDB (DB: traffic-tool — dùng bởi Tools V2)#

MySQL (DB: tool_traffic_api — dùng bởi API Golang)#

Sơ đồ quan hệ#

Enum & Hằng số#

MongoDB — DB: tool-traffic-api (API Golang)#

📦 Collection: proxies (API)#

📦 Collection: tasks (API)#

📦 Collection: profiles#

📦 Collection: profile_sessions#

📦 Collection: keywords#

📦 Collection: keyword_results#

📦 Collection: keyword_schedules#

📦 Collection: task_logs#

📦 Collection: proxy_packages#

📦 Collection: proxy_providers#

📦 Collection: proxy_ip_logs#

📦 Collection: backup_proxies#

📦 Collection: free_proxies#

📦 Collection: coccoc_tokens#

MongoDB — DB: traffic-tool (Tools V2 / ElysiaJS)#

📦 Collection: task_groups (Tools V2)#

📦 Collection: tasks (Tools V2)#

📦 Collection: proxies (Tools V2)#

📦 Collection: search#

📦 Collection: report_tasks#

MySQL — DB: tool_traffic_api (API Golang)#

🗃️ Table: users#

🗃️ Table: campaigns#

🗃️ Table: projects#

🗃️ Table: project_details#

🗃️ Table: project_settings#

🗃️ Table: servers#

🗃️ Table: server_hourly_reports#

🗃️ Table: activity_logs#

🗃️ Table: system_settings#

🗃️ Table: setup_fires#

Sơ đồ quan hệ#

Enum & Hằng số#

Database Schema — Complete Reference

Mục lục

MongoDB (DB: `tool-traffic-api` — dùng bởi API Golang)

MongoDB (DB: `traffic-tool` — dùng bởi Tools V2)

MySQL (DB: `tool_traffic_api` — dùng bởi API Golang)

Sơ đồ quan hệ

Enum & Hằng số

MongoDB — DB: `tool-traffic-api` (API Golang)

📦 Collection: `proxies` (API)

📦 Collection: `tasks` (API)

📦 Collection: `profiles`

📦 Collection: `profile_sessions`

📦 Collection: `keywords`

📦 Collection: `keyword_results`

📦 Collection: `keyword_schedules`

📦 Collection: `task_logs`

📦 Collection: `proxy_packages`

📦 Collection: `proxy_providers`

📦 Collection: `proxy_ip_logs`

📦 Collection: `backup_proxies`

📦 Collection: `free_proxies`

📦 Collection: `coccoc_tokens`

MongoDB — DB: `traffic-tool` (Tools V2 / ElysiaJS)

📦 Collection: `task_groups` (Tools V2)

📦 Collection: `tasks` (Tools V2)

📦 Collection: `proxies` (Tools V2)

📦 Collection: `search`

📦 Collection: `report_tasks`

MySQL — DB: `tool_traffic_api` (API Golang)

🗃️ Table: `users`

🗃️ Table: `campaigns`

🗃️ Table: `projects`

🗃️ Table: `project_details`

🗃️ Table: `project_settings`

🗃️ Table: `servers`

🗃️ Table: `server_hourly_reports`

🗃️ Table: `activity_logs`

🗃️ Table: `system_settings`

🗃️ Table: `setup_fires`

Sơ đồ quan hệ

Enum & Hằng số