> For the complete documentation index, see [llms.txt](https://vms.docs.delfi.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vms.docs.delfi.vn/van-hanh/dashboard.md).

# DASHBOARD

### MÔ TẢ GIAO DIỆN

Trang Dashboard đóng vai trò là trung tâm chỉ huy, cung cấp cái nhìn toàn cảnh về tình hình ra vào của khách tại doanh nghiệp theo thời gian thực. Giao diện được thiết kế trực quan, chia thành các khu vực chính từ trên xuống dưới như sau:

<figure><img src="https://2970055027-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSANK9PQM3hubqCtDDUu%2Fuploads%2Fpkbna4ftgWk7DiaAaK8v%2Fimage.png?alt=media&amp;token=b7ec4ad4-96f3-4316-9314-b8e365c4224b" alt=""><figcaption></figcaption></figure>

**Khu vực 1: Bộ lọc và Thẻ chỉ số tổng quan (Top KPIs)**

* Bộ lọc (Góc phải): Cho phép lọc dữ liệu theo Khu vực cụ thể và khoảng thời gian (Tháng).
* 4 Thẻ chỉ số chính (Màu sắc phân biệt rõ ràng):
  * Tổng khách đăng ký (Xanh dương): Tổng số lượng khách đã có thông tin ghi nhận vào hệ thống.
  * Đã check-in (Xanh lá): Số lượng khách thực tế đã quét mã vào cửa.
  * Đang trong khu vực (Vàng): Số khách hiện đang ở bên trong tòa nhà/sự kiện (đã check-in nhưng chưa check-out).
  * Đã check-out (Đỏ): Số khách đã hoàn tất việc rời khỏi khu vực.
* 4 Thẻ chỉ số phụ: Cung cấp dữ liệu nhanh trong ngày gồm: *Chưa đến, Check-in hôm nay, Khu vực hoạt động* (số khu vực đang có khách/tổng số khu vực), và *Giờ cao điểm hôm nay*.

**Khu vực 2: Biểu đồ lưu lượng và Mật độ**

* Lưu lượng ra/vào 12 giờ gần nhất: Biểu đồ đường (Line chart) thể hiện biến động số lượng khách check-in (đường màu xanh) và check-out (đường màu đỏ) theo từng mốc thời gian trong 12 giờ qua.
* Mật độ 60 phút gần nhất: Bảng xếp hạng nhanh các điểm kiểm soát có lượt ra vào nhiều nhất và ít nhất trong vòng 1 giờ qua.

<figure><img src="https://2970055027-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSANK9PQM3hubqCtDDUu%2Fuploads%2FtowBqjl8Cp7xHh9RZMeh%2Fimage.png?alt=media&amp;token=d4de4203-4dfc-4480-8712-8b0914b037dc" alt=""><figcaption></figcaption></figure>

**Khu vực 3: Biểu đồ phân tích và Dữ liệu Real-time (Phía dưới)**

* Nguồn đăng ký khách: Biểu đồ thanh ngang thống kê các kênh khách hàng được ghi nhận (VD: Admin tạo, Landing Page, ApiService...).
* Tình trạng khách: Biểu đồ hình khuyên (Donut chart) hiển thị tỷ lệ trực quan giữa khách Đang có mặt, Đã rời đi và Chưa đến.
* Khách vừa ghi nhận: Bảng dữ liệu cập nhật theo thời gian thực (Real-time), liệt kê danh sách những khách hàng mới nhất vừa có tương tác (đăng ký hoặc quét QR) kèm trạng thái hiện tại.

**Khu vực 4: Thống kê chi tiết theo khu vực**

* Hiển thị các thẻ thông tin riêng biệt cho từng cổng/trạm kiểm soát (VD: Khu vực cổng ra, Khu vực cổng vào). Mỗi thẻ tóm tắt đầy đủ 4 chỉ số (Tổng khách, Check-in, Đang có mặt, Check-out) và thanh tiến trình (Progress bar) của điểm đó trong ngày.

***

### HƯỚNG DẪN SỬ DỤNG - CÁC BƯỚC THỰC HIỆN

Trang Dashboard chủ yếu được dùng để giám sát và phân tích. Bạn có thể sử dụng giao diện này qua các thao tác sau:

**Thao tác 1:** Lọc dữ liệu theo nhu cầu

* Để xem báo cáo tổng thể toàn công ty, giữ nguyên mặc định tại ô Khu vực là *Tất cả khu vực*.
* Để xem tình hình riêng của một chi nhánh/cửa cụ thể, nhấp vào menu thả xuống ở góc trên cùng bên phải và chọn tên khu vực mong muốn. Tương tự, chọn tháng cần xem báo cáo ở ô thời gian kế bên.

**Thao tác 2:** Giám sát an ninh và lưu lượng

* Sử dụng biểu đồ Lưu lượng ra/vào 12 giờ gần nhất để dự đoán các khung giờ đông khách, từ đó có kế hoạch điều phối thêm nhân sự bảo vệ hoặc lễ tân hỗ trợ.
* Theo dõi bảng Khách vừa ghi nhận để rà soát chéo nhanh chóng trong trường hợp có khách báo lỗi thẻ hoặc máy quét không nhận diện được lúc qua cổng.

**Thao tác 3:** Đánh giá hiệu suất theo cổng

* Cuộn xuống khu vực Thống kê theo khu vực để xem hiệu suất hoạt động của từng trạm kiểm soát riêng biệt, giúp phát hiện sớm nếu có một cổng bị quá tải hoặc máy quét ở một cổng ngừng ghi nhận dữ liệu.

***

### LƯU Ý CHUNG KHI SỬ DỤNG

Chỉ số "Đang trong khu vực" (Thẻ màu vàng): Đây là con số quan trọng nhất đối với bộ phận an ninh. Vào cuối ngày làm việc hoặc cuối sự kiện, chỉ số này lý tưởng nhất phải trả về mức 0 (nghĩa là toàn bộ khách đã check-out). Nếu chỉ số này lớn hơn 0 vào cuối ngày, an ninh cần đi tuần tra hoặc kiểm tra lại lịch sử xem có khách nào quên quét mã lúc ra về hay không.

Tốc độ cập nhật (Real-time): Dữ liệu trên Dashboard được làm mới liên tục. Tuy nhiên, nếu mạng internet tại trạm kiểm soát bị chập chờn, dữ liệu đẩy lên màn hình này có thể bị trễ vài giây đến vài phút.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://vms.docs.delfi.vn/van-hanh/dashboard.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
