Tổng Quan Vận Hành — Source tool-recordvideo#
Vai trò: Máy quay video — Ghi lại toàn bộ màn hình khi truy cập website
Công nghệ: Bun · Elysia · TypeScript · Selenium/Puppeteer · MongoDB · AWS S3
1. Source này làm gì?#
tool-recordvideo là máy quay chuyên dụng — nó mở trình duyệt, truy cập website, và ghi lại toàn bộ quy trình thành video. Mục đích là tạo ra bằng chứng trực quan không thể chối cãi về trạng thái của một website tại một thời điểm cụ thể.Nhận lệnh từ api (trung tâm điều phối) sau khi tool-check đã kiểm tra xong
Mở trình duyệt và truy cập website bằng thiết bị thật được mô phỏng (desktop hoặc mobile)
Quay video màn hình toàn bộ phiên truy cập
Chụp ảnh tại thời điểm quan trọng
Upload ảnh & video lên lưu trữ đám mây (AWS S3)
Báo kết quả về api khi hoàn thành
2. Vị trí trong hệ thống#
┌──────────────────┐
│ API trung tâm │
└─────┬───────────┘
│
┌──────────────┴──────────────┐
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────────┐
│ tool-check │ │ tool-recordvideo │
│ (kiểm tra │ │ (quay video & │
│ website) │ │ chụp ảnh) │
└────────┬────────┘ └──────────┬──────────┘
│ │
│ Báo kết quả check │ Báo kết quả video
│ qua Webhook │ qua Webhook
└──────────────┬──────────────┘
▼
┌──────────────────┐
│ API trung tâm │
│ Lưu vào DB, │
│ cập nhật trạng │
│ thái domain │
└──────────────────┘
Lưu ý: tool-check và tool-recordvideo hoạt động song song độc lập nhau. Cả hai cùng nhận lệnh từ api, không phụ thuộc vào nhau.
3. Vòng đời xử lý một task ghi video#
API trung tâm tạo "phiếu quay video" (task) trong MongoDB
│
▼
Dispatcher phát hiện task mới đang chờ
│
▼
Kiểm tra: CPU < 70%? Còn slot worker trống?
│
▼ Đủ điều kiện
Giao task cho Worker rảnh nhất
│
▼
Worker chuẩn bị:
→ Xác định thiết bị (desktop / mobile)
→ Khởi động phiên trình duyệt
→ Áp dụng cấu hình màn hình phù hợp
│
▼
Truy cập website cần quay
→ Thực hiện các tương tác trên trang (cuộn, click...)
→ Ghi lại toàn bộ thành file video
→ Chụp ảnh tại các thời điểm quan trọng
│
▼
Upload lên AWS S3 (lưu trữ đám mây):
├── Ảnh chụp (.png / .jpg)
└── Video quay (.mp4 / .webm)
│
▼ Tối đa thử lại 3 lần nếu upload thất bại
Gửi đường link ảnh & video về api qua Webhook
│
▼
Task hoàn thành → Worker sẵn sàng nhận task tiếp theo
4. Cấu trúc bên trong#
┌─────────────────────────────────────────────────────────────────┐
│ SOURCE: tool-recordvideo │
│ │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ BỘ ĐIỀU PHỐI (Dispatcher) │ │
│ │ - Liên tục poll MongoDB lấy task mới │ │
│ │ - Kiểm tra CPU / RAM trước khi giao việc │ │
│ │ - Phân phối theo thứ tự (ưu tiên task manual trước) │ │
│ └──────────────────────┬────────────────────────────────────┘ │
│ │ Phân công │
│ ┌──────────────┼──────────────┐ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Worker 1 │ │ Worker 2 │ │ Worker N │ │
│ │ Quay video│ │ Quay video│ │ Quay video│ │
│ │ + Upload │ │ + Upload │ │ + Upload │ │
│ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │
│ └──────────────┴──────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ BỘ GỬI KẾT QUẢ │ │
│ │ (Webhook Worker) │ │
│ │ Báo đường link │ │
│ │ ảnh/video về api │ │
│ └─────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
5. Điểm khác biệt với tool-check#
| Tiêu chí | tool-check | tool-recordvideo |
|---|
| Mục đích | Kiểm tra trạng thái, phân tích nội dung | Ghi bằng chứng video + ảnh |
| Đầu ra | Trạng thái (chặn/sống), loại domain | File ảnh + video lưu trên S3 |
| Thời gian mỗi task | Nhanh hơn (~1-2 phút) | Lâu hơn (phải quay đủ video) |
| Phân tích thêm | Kiểm tra từ khóa, phân loại domain | Không phân tích — chỉ ghi lại |
| Lưu trữ | Ảnh chụp trên S3 | Ảnh + Video đầy đủ trên S3 |
6. Hệ thống tự bảo vệ khi lỗi#
Lỗi trong quá trình quay:
│
▼
Tự động thử lại (tối đa 3 lần)
Chờ 5 giây giữa mỗi lần thử
│
▼ Nếu vẫn thất bại
Gửi cảnh báo Telegram ngay lập tức
Ghi log chi tiết
│
▼
Task được đánh dấu lỗi
API trung tâm có thể retry sau
Nếu upload ảnh hoặc video thất bại → task được đặt lại về trạng thái "cần thử lại"
File cục bộ được xóa sau khi upload thành công (để tiết kiệm dung lượng máy chủ)
7. Phân loại thiết bị kiểm tra#
Tool-recordvideo hỗ trợ quay trên nhiều loại thiết bị ảo:| Thiết bị | Ý nghĩa |
|---|
| Desktop | Giả lập màn hình máy tính lớn |
| Mobile | Giả lập điện thoại di động |
Thiết bị nào được dùng là do api chỉ định trong phiếu công việc — nhân viên có thể cấu hình từ giao diện admin.
8. Kết quả cuối cùng nhân viên thấy#
Sau khi tool-recordvideo hoàn thành, nhân viên sẽ thấy trên giao diện admin:Trang "Lịch sử kiểm tra" (History Domain Check)
│
├── 🖼️ Ảnh chụp màn hình [Click để xem / tải về]
│ → Đường link tới AWS S3
│
└── 🎬 Video ghi màn hình [Click để xem / tải về]
→ Đường link tới AWS S3
9. Tóm tắt nhanh#
tool-recordvideo giống như quay phim viên: được giao nhiệm vụ đến địa chỉ nào, mở trình duyệt lên, quay lại toàn bộ cảnh website đó, rồi gửi file về kho lưu trữ. Đây là bằng chứng thực tế nhất về tình trạng của một website tại một thời điểm bất kỳ.
Modified at 2026-03-31 05:47:31
