Bắt đầu và Thanh công cụ bộ lọc

• Khoảng thời gian: Phím tắt Hôm nay, 7 ngày, 30 ngày hoặc nút Chọn ngày để tùy chỉnh khoảng ngày xem. Hệ thống luôn tự động đặt về "Hôm nay" mỗi khi tải lại trang để ưu tiên hiển thị số liệu mới nhất trong ngày.
• Lọc theo kênh: Lọc số liệu riêng cho kênh shopkhangbaby, mekhangsua hoặc Tất cả kênh.
• Lọc theo nhân sự: Chọn để lọc riêng số liệu của 1 bạn Host hoặc Operator.
• Tự thu gọn trên điện thoại: Thanh công cụ lọc tự động ẩn khi cuộn xuống và hiện lại khi cuộn lên để tối ưu không gian màn hình.

Tab 1: Tổng quan GMV, Target & Cơ cấu doanh thu

• Vòng tròn Tiến độ Target GMV: Hiển thị tỷ lệ % hoàn thành mục tiêu GMV trong kỳ lọc. Bấm trực tiếp vào widget để xem và cài đặt Target chi tiết theo từng Host.
• 4 Thẻ chỉ số tổng hợp:
  • GMV phát sinh (LIVE + Affiliate): Tổng doanh số ghi nhận từ phiên live và giỏ hàng Creator.
  • GMV đã đối soát: Doanh số các đơn hàng người mua đã nhận thành công (DELIVERED) sau khi trừ hoàn hủy.
  • Còn thiếu / Chờ đối soát: Doanh số các đơn hàng đang trên đường giao hàng (SHIPPING) hoặc chờ xác minh.
  • Tổng hoa hồng KPI: Quỹ thưởng dự kiến được tính tự động theo tỷ lệ chuẩn.
• Cơ cấu kênh doanh thu: Phân bổ tỷ trọng giữa shopkhangbaby, mekhangsua, GMV Affiliate và đặc biệt là Đơn Shop tự ra & Doanh số Shop (0% KPI).

Tab 2: Đối soát phiên LIVE & Phân công ca

• Dữ liệu tự động 24/24: Mỗi phiên LIVE hiển thị mã phiên, kênh phát, khung giờ, thời lượng, GMV LIVE Seller, GMV Affiliate và số tiền đã đối soát.
• Quy tắc đối soát 100%: Toàn bộ đơn hàng được tự động đối soát khi người mua nhận hàng thành công (DELIVERED). Hệ thống không cho can thiệp thủ công số tiền đối soát để bảo đảm tính minh bạch tuyệt đối.
• Chống trùng giờ: Khi 2 kênh nội bộ cùng phát trực tiếp chồng giờ nhau, đơn Affiliate xuất hiện ở cả 2 kênh chỉ được tính 1 lần (tự động chiết khấu 35% phần trùng lặp).
• Chuyển chế độ phân bổ: Với các phiên đặc biệt, Admin có thể chuyển loại phiên thành Ngày Campaign, Mega Live, Live thường (Nhiều nhân sự) hoặc Doanh số Shop.

Tab 3: Đơn Shop tự ra & Tab 4: Đối soát cấp đơn

• Đơn Shop tự ra ngoài Live (Tab 3): Tập hợp các đơn hàng tự nhiên từ trang chủ shop, tìm kiếm sản phẩm hoặc KOC gắn link sản phẩm không qua livestream. Toàn bộ doanh số này được tính về cho Shop (0% KPI).
• Đối soát cấp đơn (Tab 4): Danh sách chi tiết từng đơn hàng từ TikTok Seller API kèm mã phiên LIVE tương ứng, sản phẩm, SKU, tiền hàng và trạng thái đơn hàng.
• Nguyên tắc gắn đơn: Đơn chỉ gắn vào phiên LIVE khi TikTok trả về đúng mã Live Session ID; các đơn ngoài LIVE được tách riêng độc lập.

Tab 5: Đơn hoàn 15 ngày (TikTok)

• Quy định 15 ngày: Theo dõi các yêu cầu trả hàng / hoàn tiền phát sinh trong vòng 15 ngày sau khi người mua nhận hàng.
• Khấu trừ tự động: Khi đơn hoàn được xác nhận, hệ thống tự động khấu trừ vào GMV đối soát của phiên LIVE tương ứng để hoa hồng nhân sự chỉ tính trên doanh số thực giữ lại của shop.
• Bảo vệ nhân sự: Các yêu cầu hoàn trả vượt quá thời hạn 15 ngày hoặc không thuộc trách nhiệm ca LIVE sẽ không bị trừ vào KPI.

Tab 6: KPI nhân sự & Bảng hoa hồng

• Tỷ lệ hoa hồng chuẩn: Host nhận 0,3% và Operator nhận 0,1% trên GMV đối soát thực nhận.
• Số giờ LIVE: Chỉ áp dụng tính tổng số giờ lên sóng cho Host; Operator không tính giờ LIVE.
• Bảng lương tổng hợp: Bấm vào từng nhân sự để xem chi tiết danh sách tất cả các ca live trong tháng, doanh số từng ca, hoa hồng tương ứng và tiến độ Target cá nhân.
• Xuất phiếu lương cá nhân: Mỗi nhân viên có thể tải phiếu KPI chi tiết của riêng mình dưới dạng file để đối chiếu minh bạch.

Tab 7: KPI thủ công & Phân bổ theo cặp (Host & Op)

• Phạm vi áp dụng: Dành cho các phiên lớn có nhiều nhân sự thay nhau live hoặc cần chia ca: Ngày Campaign, Mega Live, và Live thường (Nhiều nhân sự).
• Phân bổ theo cặp: Mỗi ca gồm 1 Host phụ trách (0,3% hoa hồng) đi cùng 1 bạn Vận hành (0,1% hoa hồng). Nếu Host tự vận hành ca thì phần hoa hồng Op là 0đ.
• Quy trình gửi duyệt (Host → Admin):
  • Host điền số doanh số ca live của mình và bấm "Gửi doanh số". Ca live sẽ ở trạng thái Chờ Admin duyệt (PENDING).
  • Admin kiểm tra và bấm "Lưu & Phê duyệt" (hoặc "⚡ Phê duyệt tất cả"). Khi đã duyệt, số tiền mới chính thức được ghi nhận vào bảng lương và Target!
• Nút thông minh "💡 Điền số còn lại": Khi đã có 1 người điền ca trước đó, hệ thống tự động tính số tiền còn lại của phiên và hiển thị nút bấm 1 chạm để điền ngay số vừa khớp, chống điền vượt quá trần GMV phiên.
• Lựa chọn "👑 Doanh số Shop": Khi phiên hoặc ca live chọn Doanh số Shop, hệ thống không trích hoa hồng Host (0%), không nhảy qua tab KPI thủ công mà tự động cộng dồn doanh số vào mục Đơn Shop tự ra ngoài Live.

Tab 8: Xuất file báo cáo (Excel / CSV)

• Báo cáo đối soát phiên LIVE: Xuất toàn bộ dữ liệu phiên live theo khoảng thời gian đã lọc, bao gồm GMV Seller, Affiliate, trạng thái đối soát và nhân sự phụ trách.
• Bảng lương thưởng KPI nhân sự: Báo cáo chi tiết thu nhập hoa hồng, số ca live, giờ live và thưởng của từng nhân viên trong tháng.
• Danh sách đơn hàng: Xuất dữ liệu đơn hàng sạch để kế toán đối chiếu với sao kê TikTok Shop Seller Center.

Tab 9: TikTok / API & Tự động đồng bộ

• Kết nối đa kênh: Quản lý ủy quyền OAuth riêng biệt cho Seller và 2 tài khoản Creator TikTok (shopkhangbaby và mekhangsua).
• Tự động làm mới phiên đang LIVE: Chạy ngầm 1 phút/lần để cập nhật doanh số phát sinh tức thì của phiên đang phát sóng.
• Tự đồng bộ mỗi ngày: Tự động chạy chuỗi quét toàn diện lúc 00:00 lấy dữ liệu 31 ngày gần nhất (LIVE → Đơn hàng → Hoàn trả → Doanh số Affiliate).
• Đồng bộ nhanh 2 ngày: Phím tắt lấy ngay dữ liệu đơn và phiên live của 2 ngày gần nhất khi cần kiểm tra đối soát tức thì.
• Bảo mật cấp cao: Toàn bộ Access Token & App Secret được mã hóa tại Cloudflare KV, không bao giờ lộ ra trình duyệt.

Tab 10: Lưu trữ & Tab 11: Quản lý tài khoản

• Giám sát lưu trữ (Tab 10): Đo lường hạn ngạch Firestore và Cloudflare KV. Cơ chế chống tràn tự động dọn dẹp các bản nháp và tệp kỹ thuật cũ quá hạn, bảo đảm an toàn 100% cho dữ liệu nghiệp vụ.
• Quản lý nhân sự (Tab 11): Duyệt tài khoản đăng nhập qua Google OAuth, phân quyền các vai trò: ADMIN, HOST, OPERATOR.
• Cài đặt Target GMV: Thiết lập mục tiêu doanh số tháng cho từng bạn Host để hệ thống tự động theo dõi tỷ lệ hoàn thành.
• Trạng thái Online thực tế: Theo dõi chính xác thời gian hoạt động cuối cùng của từng nhân viên độc lập, phục vụ chấm công và điều phối ca.