⚡ Bảng Tra Cứu Lệnh Nhanh

In trang này ra hoặc bookmark để tra cứu khi cần. Mỗi lệnh chỉ cần copy → paste vào Terminal → Enter.

---

🔐 Đăng Nhập

# Đăng nhập Shopee cho khách hàng Vita Dairy
gbs login -c vita_dairy -m shopee

# Đăng nhập TikTok cho khách hàng Vita Dairy
gbs login -c vita_dairy -m tiktok

# Đăng nhập Lazada cho khách hàng Vita Dairy
gbs login -c vita_dairy -m lazada

📥 Chạy Tải Báo Cáo

# Chạy tất cả (mọi khách hàng, mọi sàn)
gbs crawl

# Chỉ chạy cho 1 khách hàng
gbs crawl -c vita_dairy

# Chỉ chạy 1 sàn của 1 khách hàng
gbs crawl -c vita_dairy -m shopee

# Chỉ chạy 1 loại báo cáo
gbs crawl -c vita_dairy -r income

# Xem trước mà không chạy thật
gbs crawl --dry-run

# Chạy hiện trình duyệt (để debug)
gbs crawl --no-headless

📊 Kiểm Tra Trạng Thái

# Xem tất cả profile và session
gbs status

# Xem chỉ 1 khách hàng
gbs status -c vita_dairy

⏰ Chạy Tự Động

# Bật chế độ tự động (mặc định: 2h sáng mỗi ngày)
gbs schedule

# Chạy tự động + hiện trình duyệt (debug)
gbs schedule --no-headless

👤 Quản Lý Khách Hàng

# Thêm khách hàng mới
uv run scripts/gbs_ops.py client add --name "Tên Khách Hàng"

# Xóa khách hàng
uv run scripts/gbs_ops.py client remove --name "Tên Khách Hàng"

# Tìm file báo cáo mới nhất
uv run scripts/gbs_ops.py report get --client "Tên Khách Hàng"

---

📁 Các Đường Dẫn Quan Trọng

Thư mục	Chức năng
data/[Tên KH]/	Nơi chứa file báo cáo Excel/CSV đã tải về
profiles/[Tên KH]/	Thông tin đăng nhập (Cookie) của từng khách hàng
config/customers.csv	Danh sách khách hàng và tài khoản
config/crawl_jobs.csv	Cấu hình loại báo cáo cần tải cho từng khách hàng
logs/	File log ghi lại quá trình chạy (dùng khi debug)

---

🚨 Xử Lý Sự Cố Nhanh

Lỗi	Lệnh cần chạy
Shopee văng đăng nhập	gbs login -c [customer_id] -m shopee
TikTok văng đăng nhập	gbs login -c [customer_id] -m tiktok
Lazada văng đăng nhập	gbs login -c [customer_id] -m lazada
Timeout khi crawl	Thử chạy lại gbs crawl -c [customer_id]
Muốn xem lỗi trực quan	gbs crawl --no-headless -c [customer_id]

💡 Thay [customer_id] bằng ID khách hàng (VD: vita_dairy, hara_test, dutch_lady)