> ## Documentation Index
> Fetch the complete documentation index at: https://huongdan.luklak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dữ liệu Workflow cho báo cáo

> Cách truy vấn trạng thái hiện tại và lịch sử chuyển trạng thái bằng UQL để đo hiệu quả quy trình.

## Workflow là nguồn dữ liệu

Mỗi lần Đầu việc chuyển trạng thái, Luklak ghi lại sự kiện đó. Dữ liệu lịch sử này cho phép bạn phân tích tốc độ xử lý, điểm tắc nghẽn, và tỷ lệ chuyển đổi giữa các giai đoạn.

## Truy vấn trạng thái hiện tại

Dùng UQL trong bộ lọc hoặc Dashboard để xem ảnh chụp nhanh tình trạng vận hành:

* **Theo Trạng thái cụ thể:** `status = "CHỜ_PHẢN_HỒI_KHÁCH"`
* **Theo Nhóm Trạng thái:** `status.category = "IDLE"` — tìm tất cả Đầu việc đang bị treo trên toàn hệ thống, bất kể tên trạng thái cụ thể là gì.

## Truy vấn lịch sử chuyển trạng thái

Đây là phần mạnh nhất. UQL cho phép truy vấn toàn bộ hành trình của Đầu việc:

| Toán tử                     | Mô tả                                        |
| :-------------------------- | :------------------------------------------- |
| `Was in "TRẠNG_THÁI"`       | Tìm Đầu việc đã từng ở trạng thái này        |
| `Was not in "TRẠNG_THÁI"`   | Tìm Đầu việc chưa bao giờ qua trạng thái này |
| `Changed from "A" to "B"`   | Tìm Đầu việc đã chuyển từ A sang B           |
| `Changed from "TRẠNG_THÁI"` | Tìm Đầu việc đã rời khỏi trạng thái này      |
| `Changed to "TRẠNG_THÁI"`   | Tìm Đầu việc đã đi vào trạng thái này        |

## Ví dụ thực tế: Đo tỷ lệ chuyển đổi Sales

Giả sử luồng bán hàng: `LEAD_MỚI` → `TƯ_VẤN` → `GỬI_BÁO_GIÁ` → `CHỐT_ĐƠN`.

**Câu hỏi:** "Bao nhiêu lead đã tư vấn chuyển thành công sang gửi báo giá?"

**Truy vấn UQL:**

```uql theme={null}
status changed from "TƯ_VẤN" to "GỬI_BÁO_GIÁ"
```

**Dashboard thực tế:**

1. Widget đếm tất cả Đầu việc `Was in "TƯ_VẤN"` → kết quả: **100**.
2. Widget đếm theo truy vấn trên → kết quả: **42**.
3. Tỷ lệ chuyển đổi giai đoạn này: **42%**.

***

## Đọc tiếp

* [Quản lý Trạng thái Toàn cục](/02-platform/platform-overview/universal-workflow/trang-thai-toan-cuc)
* [Quay lại Tổng quan Luồng tiến trình](/02-platform/platform-overview/universal-workflow/index)