Tổng quan (Dashboard)

This content is not available in your language yet.

Tổng quan (/app/home) là trang đầu tiên bạn thấy sau khi đăng nhập. Nó trả lời 3 câu hỏi: AI chạy tốt không? Shop có khoẻ không? Việc gì cần làm ngay?

Dashboard có 3 chế độ hiển thị tự động dựa trên trạng thái tài khoản:

Setup mode — chưa setup xong hoặc chưa kết nối kênh nào.
Attention mode — có alert cần xử lý (token hết hạn, đơn chờ duyệt…).
Active mode — mọi thứ ổn, hiển thị KPI đầy đủ.

Khối onboarding (6 bước setup)

Nếu chưa hoàn tất setup, đầu trang có checklist 6 bước:

#	Key	Tiêu đề	Mô tả	Nút CTA	Link
1	`onboarding_guide`	Hướng dẫn sử dụng	Xem hướng dẫn tổng quan về các tính năng chính.	Bắt đầu hướng dẫn	Kích hoạt tour `#tour`
2	`agent_created`	Tạo AI Agents đầu tiên	Tạo trợ lý AI để bắt đầu hỗ trợ khách hàng.	Tạo AI Agent	`/app/ai-agent`
3	`channel_connected`	Kết nối kênh giao tiếp	Liên kết Facebook, Instagram, Zalo hoặc Telegram.	Kết nối kênh	`/app/channels`
4	`knowledge_added`	Huấn luyện AI Agents	Cung cấp kiến thức sản phẩm, dịch vụ và câu hỏi thường gặp.	Huấn luyện AI	`/app/ai-agent`
5	`brand_kit_setup`	Thiết lập thương hiệu	Điều chỉnh giọng điệu, cách xưng hô và phong cách phản hồi.	Thiết lập thương hiệu	`/app/brand-kit`
6	`onboarding_done`	Kích hoạt tự động trả lời	Kiểm tra câu trả lời trước khi cho AI hoạt động tự động.	Kích hoạt AI	`/app/ai-routing`

Mỗi bước có badge trạng thái:

Hoàn tất — đã xong.
Đang thực hiện — đang trong tiến trình.
Chưa bắt đầu — chưa làm.

Tiến trình tổng hiện dạng progress bar (X/6 hoàn tất, X%). Khi 6 bước ✅ → khối này thu gọn.

Khi có vấn đề cần xử lý, đầu trang hiện 1 banner ưu tiên cao nhất (theo thứ tự):

Ưu tiên	Điều kiện	Severity	Message
1	Token kênh hết hạn / sắp hết	`danger` / `warning`	Thông báo token expired/expiring
2	Đơn chờ duyệt + Follow-up tới hạn	`warning`	Thông báo số lượng cần xử lý
3	Chỉ đơn chờ duyệt	`info`	X đơn hàng chờ duyệt
4	Chỉ follow-up tới hạn	`info`	X follow-up tới hạn
5	Setup chưa xong (có kênh nhưng chưa complete)	`neutral`	Setup incomplete

KPI strip (4 card đầu)

Hàng 4 card màu lớn ở trên — nhìn nhanh nhất để biết AI chạy ra sao:

Card	Label	Số này nói gì	Thấp thì làm gì
🟣 AI đã trả lời	Tổng tin AI trả khách (30 ngày) + sparkline 14 ngày	AI đang gánh khối lượng	Bằng 0 → AI chưa bật / chưa kết nối kênh
🔵 Tỷ lệ AI xử lý	% tin do AI tự xử lý hết (`ai_handled_pct`)	AI tự lo bao nhiêu	<50% → AI hay chuyển người, review knowledge
🟢 Giờ nhân sự	Số giờ tiết kiệm nhờ AI (`human_hours_saved`)	Giá trị AI mang lại	—
🟠 Tự động hoàn toàn	Tỷ lệ hội thoại AI tự xử lý 100% (`fully_auto_rate`)	AI không cần người can thiệp	—

6-card grid (phần chính)

1. Hiệu suất tin nhắn

Bar chart số tin AI trả theo tuần (gộp 7 ngày/bar) hoặc ngày (7d view hiện từng ngày). Filter 30 ngày / 7 ngày. Tổng hiển thị tổng AI replies trong khoảng đã chọn.

2. Tỷ lệ AI xử lý

Donut chart AI vs Người. Label trung tâm hiển thị AI xử lý + phần trăm. Phần AI vs phần Human.

3. Liên kết mạng xã hội

Liệt kê kênh đã kết nối (FB Messenger, IG DM, Telegram, Zalo OA…). Số X kênh đang hoạt động (active_channels). Cảnh báo token sắp hết hạn + chi tiết từng kết nối expiring (tên, thời gian còn lại, link gia hạn). Nút Quản lý kênh → Kênh.

4. Chỉ số quan trọng

4 KPI lõi:

Tin nhắn (7 ngày) — messages_7d tổng tin 7 ngày.
Tổng khách hàng — subscribers_total tổng subscriber.
Khách mới (7 ngày) — subscribers_new_7d subscriber mới.
Đơn hàng (7 ngày) — orders_7d đơn tạo 7 ngày.

Dropdown Sắp xếp (Cao→Thấp / Thấp→Cao / Mặc định).

5. Việc cần làm

Task cards — xử lý ngay (chỉ hiện khi có data):

📦 Đơn hàng chờ duyệt — orders_pending → link /app/orders.
⏰ Follow-up tới hạn — followups_due → link /app/chat.
⚠️ Token sắp hết hạn — tokens_needing_action (gồm cả expired + expiring) → link /app/channels?status=expiring#autopost.

6. Giá trị AI (card vàng)

Số lớn giờ nhân sự tiết kiệm. Mô tả “Nhờ tự động trả lời X tin nhắn trong 30 ngày qua”. Nút Mở hộp thư → Hội thoại.

Nút hành động

Làm mới (icon refresh) — reload toàn bộ data.
Bình luận gần đây — section hiện comments gần nhất từ MXH (nếu có).

Routine hằng ngày (đề xuất)

Bước tiếp theo

Đơn hàng — xử lý đơn chờ duyệt.
Knowledge — duyệt Fact — cải thiện chất lượng AI.
Playbook — ngày 1 / tuần 1 — routine đầy đủ.