Dashboard Builder

Quick Reference

• Who: Owner / Admin (tạo/sửa/xoá), Member (xem shared)
• Where: Menu trái → Dashboards (/dashboard)
• Time: ~5-10 phút tạo dashboard đầy đủ
• Prerequisites: Đã đăng nhập với role Owner/Admin

Prerequisites

• [ ] Đã đăng nhập với role Owner hoặc Admin (để tạo/sửa)
• [ ] Member chỉ xem dashboard được chia sẻ

Step-by-Step Guide

Step 1: Xem danh sách Dashboard

1. Click Dashboards trên sidebar
2. Hệ thống hiện danh sách tất cả dashboards bạn có quyền xem
3. Mỗi card hiện: tên, mô tả, badge "Shared" nếu chia sẻ

Step 2: Tạo Dashboard mới

1. Click nút Tạo Dashboard

2. Điền thông tin:

   Field	Required	Mô tả	Ví dụ
   Tên	Yes	Tên dashboard	"Tổng quan kinh doanh"
   Mô tả	No	Mô tả ngắn	"Dashboard hàng ngày cho team"
   Chia sẻ	No	Bật sharing	Toggle on/off

3. Click Tạo → chuyển tới trang dashboard mới

TIP

Tạo dashboard trước, sau đó thêm widgets từ AI Chat (Pin to Dashboard) hoặc từ Insight Catalog.

Step 3: Thêm Widget

Có 2 cách thêm widget:

Cách 1: Từ AI Chat

1. Vào /chat → hỏi câu hỏi
2. Trên kết quả, click Pin to Dashboard
3. Chọn dashboard → widget được tạo dạng snapshot

Cách 2: Từ Dashboard

1. Trong dashboard, click Thêm Widget

2. Chọn insight source

3. Cấu hình widget:

   Field	Options	Mô tả
   Tiêu đề	Text	Tên widget
   Loại	chart / table / kpi	Dạng hiển thị
   Kích thước	small / medium / large / full	Chiều rộng
   Nguồn dữ liệu	live_insight / snapshot	Live = refresh API, Snapshot = dữ liệu cố định

Step 4: Quản lý Widgets

Hành động	Cách làm
Di chuyển	Kéo thả widget trong grid
Thay đổi kích thước	Edit widget → đổi display_size
Refresh dữ liệu	Click icon refresh trên widget
Đổi chart type	Edit widget → override chart_type
Xoá	Click menu → Delete widget

Step 5: Sử dụng Filter Presets

1. Trên thanh filter bar, click preset có sẵn (VD: "Daily", "Weekly", "Monthly")
2. Hoặc tạo preset mới:
   • Click Thêm Preset
   • Đặt tên + chọn bộ filter (granularity, date range, country...)
   • Lưu → preset áp dụng cho TẤT CẢ widgets

INFO

Global Filter Presets cho phép switch nhanh giữa các góc nhìn khác nhau mà không cần chỉnh từng widget.

Step 6: Chia sẻ Dashboard

1. Click menu ⋯ → Share
2. Nhập email người nhận
3. Toggle Chia sẻ công khai nếu muốn tất cả member xem
4. Click Lưu

Ma trận quyền khi chia sẻ:

Action	Owner/Admin	Member (shared)	Member (not shared)
Xem	Full	Full	Không
Sửa	Full	Không	Không
Xoá	Full	Không	Không
Share	Full	Không	Không

Source: (src/app/core/services/permission.service.ts:10-42)

Step 7: Lập lịch Gửi Báo cáo

1. Click menu ⋯ → Schedule

2. Cấu hình:

   Field	Options	Mô tả
   Lịch gửi	daily / weekly / monthly	Tần suất
   Giờ gửi	HH:mm	Giờ gửi (UTC)
   Ngày trong tuần	0-6 (CN-T7)	Chỉ khi weekly
   Ngày trong tháng	1-31	Chỉ khi monthly
   Kênh nhận	Chọn channels	Telegram, Email, Lark

3. Click Lưu → báo cáo tự động gửi theo lịch

Expected Results

• Dashboard load trong 1-2 giây
• Widgets hiện đúng chart type và data
• Filter presets apply ngay lập tức
• Báo cáo tự động gửi đúng lịch qua kênh đã chọn

Troubleshooting

Không tạo được dashboard

Cause: Role Member không có quyền tạo.

Solution: Yêu cầu Owner/Admin cấp quyền Admin, hoặc nhờ họ tạo và share.

Widget không hiện dữ liệu

Cause: Data source là live_insight nhưng insight execute lỗi, hoặc snapshot data trống.

Solution:

1. Click refresh trên widget
2. Kiểm tra insight source còn hoạt động
3. Thử edit widget → đổi data source

Scheduled report không gửi

Cause: Channel chưa verified hoặc schedule config sai.

Solution:

1. Vào Settings → kiểm tra channel is_verified = true
2. Test channel → gửi message test
3. Kiểm tra delivery logs cho lỗi cụ thể

Related

• AI Chat — Pin kết quả AI vào dashboard
• Insight Catalog — Nguồn dữ liệu cho widgets
• Cài đặt — Cấu hình channels cho scheduled reports
• Thông báo — Quản lý subscriptions
• API: CRUD /api/v1/dashboards/ — Xem API