Appearance
📚 GBS Crawler — Trung Tâm Tài Liệu
GBS Crawler là hệ thống tự động thu thập báo cáo từ các sàn Thương Mại Điện Tử (Shopee, TikTok Shop, Lazada) dành cho đội ngũ vận hành của GBS/Boxme. Hệ thống chạy hằng ngày, tải file báo cáo về máy tính và cảnh báo qua Telegram khi có sự cố.
🗺️ Bạn là ai? Hãy chọn tài liệu phù hợp
🟢 Vận Hành & Khách Hàng (Non-Tech)
Dành cho nhân viên vận hành, account, hoặc quản lý không yêu cầu kỹ năng lập trình.
| Tài liệu | Mô tả |
|---|---|
| 🚀 Khởi động & Cài đặt nhanh | Hướng dẫn mở dự án và ra lệnh cho AI cài đặt tự động từ A-Z. |
| 📖 Sổ tay vận hành hằng ngày | Cách lấy báo cáo, thêm/bớt khách hàng, xử lý khi báo cáo thiếu. |
| 📊 Danh sách Báo cáo & Dữ liệu hỗ trợ | Xem chi tiết những loại báo cáo/dữ liệu nào hệ thống có thể tải về. |
| ⚡ Thẻ tra cứu nhanh (Quick Ref) | Copy/paste ngay các câu lệnh thường dùng — không cần đọc dài dòng. |
| ⚙️ Cấu hình Khách hàng (CSV) | Hướng dẫn cách điền file danh sách khách hàng và job. |
🛠️ Kỹ thuật viên / DevOps
Dành cho người cần cài đặt, cấu hình chuyên sâu hoặc phát triển thêm tính năng.
| Tài liệu | Mô tả |
|---|---|
| 📖 Tham chiếu lệnh CLI (API) | Toàn bộ lệnh gbs login / crawl / status / schedule với đầy đủ flags. |
| 🏗️ Kiến trúc hệ thống | Sơ đồ các lớp, luồng xử lý lỗi, thiết kế Worker-Scheduler. |
| 📊 Phân tích mã nguồn | Công nghệ sử dụng, cấu trúc thư mục, luồng nghiệp vụ. |
🤖 AI Ops & Gỡ Lỗi
Dành cho việc dùng AI để tự động sửa lỗi và bảo trì hệ thống.
| Tài liệu | Mô tả |
|---|---|
| 🤖 Hướng dẫn kết hợp AI | Kịch bản copy lỗi từ Telegram đưa cho AI để tự động cập nhật selector. |
| 📚 Vibe Coding SOP | Quy tắc cho AI Agent (Claude/Cursor) khi thay đổi mã nguồn. |
❓ Câu hỏi thường gặp
Hệ thống chạy tự động vào lúc nào?
Mặc định, lịch tự động chạy vào 02:00 sáng hằng ngày. Bạn có thể thay đổi giờ trong code nếu cần.
Hệ thống hỗ trợ những sàn nào?
Hiện tại hỗ trợ: Shopee, TikTok Shop, Lazada. Để xem chi tiết danh sách từng báo cáo mà mỗi sàn hỗ trợ, vui lòng xem Danh sách Báo cáo & Dữ liệu hỗ trợ.
Dữ liệu được lưu ở đâu?
Tất cả file báo cáo (Excel, CSV, PDF) được lưu trong thư mục data/[Tên khách hàng]/ bên trong dự án.
Khi bị lỗi, ai sẽ biết?
Hệ thống tự động gửi cảnh báo đến nhóm Telegram kèm thông tin lỗi chi tiết. Người vận hành chỉ cần theo dõi nhóm Telegram để nhờ AI xử lý.
Tài liệu cập nhật lần cuối: Tháng 5/2026