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

# Tổng quan

> Hệ thống Booking ILU PET kết nối Chủ nuôi với Merchant, tự động gán nhân sự phù hợp và quản lý slot thời gian thực để tránh đặt trùng.

Hệ thống Đặt lịch của **ILU PET** kết nối Chủ nuôi (Pet Owners) với các Cơ sở dịch vụ (Merchants). Hệ thống được thiết kế để giải quyết bài toán điều phối nhân sự và tài nguyên, tối ưu hóa năng suất nhân sự và minh bạch hóa trải nghiệm chăm sóc thú cưng. Thay vì quản lý lịch hẹn thủ công, Tomotek số hóa toàn bộ quy trình từ khâu tìm kiếm, giữ chỗ cho đến khi hoàn tất dịch vụ và thanh toán — hướng tới mục tiêu cốt lõi: **"Đúng người - Đúng việc - Đúng thời điểm"**.

## Tổng quan nghiệp vụ

Hệ thống Booking vận hành dựa trên nguyên tắc kết hợp giữa **Tài nguyên có sẵn** (nhân viên, phòng trống, thời gian) và **Nhu cầu khách hàng**. Bạn không cần xử lý thủ công từng bước — hệ thống tự động hóa toàn bộ quy trình để bạn tập trung vào việc phục vụ thú cưng.

## Những giá trị kỹ thuật nổi bật

Hệ thống sở hữu những đặc tính kỹ thuật chuyên sâu giúp phân biệt với các ứng dụng đặt lịch thông thường:

> **Smart Slot**
>
> Tự động tính toán các khung giờ khả dụng dựa trên giờ mở cửa và các lịch
> hẹn hiện có, tránh tình trạng đặt trùng chỗ (Double-booking).

> **Auto-assign**
>
> Hệ thống tự động tìm kiếm và chỉ định nhân viên phù hợp dựa trên kỹ năng
> (Skills) tương ứng với dịch vụ và loài thú cưng (Chó/Mèo).

> **Soft Lock (5–10 phút)**
>
> Khi bạn đang thao tác đặt lịch, hệ thống tạm giữ chỗ trong 5–10 phút để
> đảm bảo tài nguyên không bị người khác chiếm dụng trước khi bạn hoàn
> tất.

> **Color Coding**
>
> Toàn bộ trạng thái vận hành được chuẩn hóa bằng mã màu, giúp Merchant
> nắm bắt tình hình cửa hàng chỉ trong vài giây.

## Phân loại hai dịch vụ chính

Hệ thống phân tách rõ ràng hai luồng nghiệp vụ để xử lý các thuật toán khác nhau, phù hợp với từng loại nhu cầu chăm sóc thú cưng.

**Đặt theo Giờ (Time-based)**

Áp dụng cho các dịch vụ ngắn hạn, kết thúc trong ngày như: Grooming (Tắm sấy, cắt tỉa), Spa, Khám bệnh định kỳ.

**Cấu trúc đặt lịch:**

Chọn \[Số lượng thú] → \[Chọn ngày] → \[Chọn khung giờ trống]

**Logic tài nguyên:**

Phụ thuộc trực tiếp vào khung giờ làm việc và kỹ năng của nhân viên (Staff Availability).

> [!NOTE]
>
> Đây là loại dịch vụ phổ biến nhất. Hệ thống Smart Slot sẽ chỉ hiển thị các khung giờ thực sự còn trống và có nhân viên đủ kỹ năng phục vụ.

**Lưu trú (Lodging & Boarding)**

Áp dụng cho mô hình Khách sạn thú cưng hoặc trông giữ dài ngày.

**Cấu trúc đặt lịch:**

Chọn \[Ngày nhận thú] và \[Ngày trả thú] (Date-range)

**Logic tài nguyên:**

Tập trung vào việc kiểm soát sức chứa lồng hoặc phòng trống (Room/Cage Availability) thay vì quản lý theo khung giờ của từng nhân viên.

> [!NOTE]
>
> Với dịch vụ Lưu trú, hệ thống theo dõi số lượng lồng/phòng còn trống theo từng ngày trong khoảng thời gian bạn chọn.

## Quy trình vận hành chuẩn

Mỗi lịch hẹn trải qua 5 bước dưới đây, từ lúc khách hàng tìm kiếm đến khi dịch vụ hoàn tất và lưu vào hồ sơ thú cưng.

**1. Tìm kiếm & Khám phá**

Pet Owner lọc dịch vụ theo vị trí, đánh giá và bảng giá của các Merchant
để tìm cơ sở phù hợp.

**2. Thiết lập lịch hẹn**

Khách hàng cung cấp thông tin thú cưng và chọn thời điểm phù hợp. Hệ
thống thực hiện **Soft Lock** tài nguyên trong 5–10 phút để bảo lưu chỗ
trong khi bạn hoàn tất các bước còn lại.

**3. Xác nhận đơn**

Merchant tiếp nhận thông báo, kiểm tra và chuyển trạng thái sang **Đã
xác nhận**. Lúc này nhân viên phù hợp nhất sẽ được tự động gán vào lịch
(Auto-assign).

**4. Thực hiện dịch vụ**

Theo dõi tiến độ qua các trạng thái **Check-in** và **Đang thực hiện**.
Merchant và khách hàng đều có thể theo dõi trạng thái theo thời gian
thực.

**5. Hoàn tất & Lưu trữ**

Sau khi hoàn thành, hệ thống tự động sinh hóa đơn (Bill). Toàn bộ hành
trình chăm sóc được lưu vào hồ sơ số của thú cưng để phục vụ việc tái
đặt lịch (Re-order) sau này.

## Hệ thống trạng thái và mã màu chuẩn hóa

Để tối ưu hóa việc quản lý, hệ thống quy định các trạng thái tương ứng với màu sắc cụ thể. Bạn có thể nắm bắt toàn bộ tình trạng đơn hàng chỉ bằng một cái nhìn.

| Màu sắc | Trạng thái | Ý nghĩa |
| - | - | - |
| Vàng | **Pending** — Chờ xác nhận | Đơn mới từ khách hàng cần Merchant xử lý |
| Hồng | **Confirmed** — Đã xác nhận | Lịch hẹn đã hợp lệ và được gán tài nguyên |
| Xanh dương | **Processing** — Đang thực hiện | Thú cưng đã có mặt và đang sử dụng dịch vụ |
| Xanh lá | **Done** — Hoàn thành | Dịch vụ kết thúc thành công |
| Đỏ | **Cancelled** — Đã hủy | Đơn bị hủy bởi khách hàng hoặc Merchant |
| Xám đậm | **No-show** — Vắng mặt | Khách không đến đúng giờ hẹn |

> [!NOTE]
>
> Tài liệu này là cơ sở để bạn hiểu rõ luồng đi của dữ liệu trong toàn bộ
> module Booking của Tomotek. Các trang tiếp theo sẽ đi sâu vào từng tính năng
> cụ thể.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.