> ## 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 lịch hẹn và định danh thú cưng

> Quy trình đặt lịch và định danh thú cưng từ đầu đến cuối: chủ nuôi tạo mã QR hẹn, nhân viên xác minh hồ sơ, nhân viên cấy chip và hoàn tất.

Quy trình đặt lịch hẹn và định danh thú cưng áp dụng cho ba vai trò phối hợp: chủ nuôi chuẩn bị mã QR và thông tin trên App, nhân viên xác minh danh tính tại quầy tiếp tân, và nhân viên thực hiện cấy chip cùng hoàn thiện hồ sơ định danh cho từng thú cưng.

## Tổng quan 2 luồng nghiệp vụ

Quy trình gồm hai luồng chạy song song và tiếp nối nhau:

* **Luồng 1 — Chủ nuôi chuẩn bị trên App:** Tìm clinic, tạo mã QR cuộc hẹn, và định danh bản thân (tùy chọn).
* **Luồng 2 — Clinic thực hiện:** Nhân viên xác minh hồ sơ và chuyển hàng đợi; nhân viên tạo hồ sơ thú cưng, cấy chip, chụp ảnh và hoàn tất.

***

**Luồng 1: Chủ nuôi**

Luồng này diễn ra trên App của chủ nuôi trước và trong khi đến clinic.

**1. Tìm hiểu về chip định danh và chọn clinic**

Chủ nuôi mở App và vào mục **"Phòng khám hỗ trợ"** để tìm clinic phù hợp.

1. Xem danh sách clinic trên bản đồ hoặc dạng danh sách
2. Lọc theo khoảng cách, đánh giá, dịch vụ và giờ làm việc
3. Xem chi tiết clinic: địa chỉ, số điện thoại, hình ảnh, đánh giá
4. Nhấn **"Chọn clinic này"** để tiếp tục

**2. Tạo cuộc hẹn định danh (mã QR)**

Chủ nuôi tạo mã QR duy nhất để clinic nhận diện cuộc hẹn.

1. Chọn clinic muốn đến
2. Nhấn **"Tạo cuộc hẹn"** — hệ thống sinh mã QR dựa trên: thông tin chủ nuôi đã đăng nhập, clinic đã chọn và thời điểm nhấn tạo
3. Lưu mã QR bằng cách chụp màn hình hoặc chia sẻ

> [!NOTE]
>
> Hệ thống **không yêu cầu Chủ nuôi phải chọn thú cưng trước** khi tạo cuộc hẹn. Chủ nuôi chỉ cần mang tất cả thú cưng cần định danh đến clinic, hệ thống cho phép nhân viên tạo hồ sơ trực tiếp tại chỗ nếu chưa có.

**Trạng thái cuộc hẹn:**

| Trạng thái | Ý nghĩa |
| - | - |
| `Chờ đến` | Mới tạo, chưa đến clinic |
| `Đã đến clinic` | Nhân viên đã xác nhận check-in |
| `Trong hàng đợi` | Hồ sơ chủ nuôi đã kiểm tra, chờ nhân viên |
| `Đang thực hiện` | Nhân viên đang thực hiện định danh |
| `Đã hoàn tất` | Tất cả thú cưng đã định danh thành công |
| `Đã hủy` | Cuộc hẹn bị hủy |
| `Đã hết hạn` | Quá 4 ngày không check-in |

> [!WARNING]
>
> * Mã QR chỉ có giá trị trong **4 ngày** kể từ ngày tạo và chỉ dùng được tại **clinic đã chọn**.
> * Một chủ nuôi chỉ có tối đa **01 appointment hoạt động** tại một thời điểm. Hệ thống không cho phép tạo appointment mới khi đang có appointment ở trạng thái `Chờ đến`, `Đã đến clinic`, `Trong hàng đợi` hoặc `Đang thực hiện`. Chỉ được phép tạo mới khi appointment hiện tại đã ở trạng thái `Đã hoàn tất`, `Đã hủy` hoặc `Hết hạn`.

**3. Định danh bản thân (tùy chọn)**

Chủ nuôi có thể cung cấp thông tin CCCD trên App trước để tiết kiệm thời gian tại quầy nhân viên.

1. Vào mục **"Định danh cá nhân"** trong App
2. Nhập thông tin: họ tên, số CCCD, ngày cấp, nơi cấp, số điện thoại
3. Upload ảnh CCCD mặt trước và mặt sau
4. Hệ thống dùng OCR để đọc thông tin tự động
5. Nếu thành công, trạng thái chuyển sang **"Đã khai báo tạm"** (thông tin này cần được Clinic xác minh bằng mắt thường)

> [!NOTE]
>
> Đây là bước **tùy chọn**. Nếu Chủ nuôi chưa thực hiện trên App, nhân viên sẽ hỗ trợ xác minh và nhập thông tin trực tiếp tại clinic.

**Luồng 2: Clinic**

Luồng này diễn ra tại clinic, do nhân viên thực hiện.

### Phần A: Nhân viên kiểm tra hồ sơ

**1. Check-in tại quầy nhân viên**

Chủ nuôi đến clinic và xuất trình mã QR hoặc đọc mã số appointment.

1. Chủ nuôi xuất trình mã QR hoặc đọc mã số định danh
2. Nhân viên quét mã hoặc tra cứu mã số trên hệ thống
3. Hệ thống hiển thị thông tin appointment và chủ nuôi

**2. Xác minh danh tính chủ nuôi**

Nhân viên đối chiếu thông tin trên hệ thống với CCCD thực tế theo từng trường hợp:

**Trường hợp 1 — Chủ nuôi đã cung cấp thông tin trên App:**

* Nhân viên đối chiếu thông tin trên hệ thống với CCCD thực tế
* Nếu khớp: xác nhận và tiếp tục
* Nếu không khớp: nhân viên cập nhật thông tin

**Trường hợp 2 — Chủ nuôi chưa cung cấp thông tin trên App:**

* Nhân viên yêu cầu chủ nuôi xuất trình CCCD
* Nhân viên nhập thông tin mới vào hệ thống
* Chủ nuôi xác nhận thông tin đã nhập

> [!WARNING]
>
> **Không** tạo hồ sơ thú cưng ở bước này. Việc tạo hồ sơ thú cưng sẽ được thực hiện trong giai đoạn định danh tiếp theo.

**3. Chuyển sang hàng đợi**

Khi hồ sơ chủ nuôi đã hợp lệ:

1. Nhân viên kiểm tra lại thông tin chủ nuôi lần cuối
2. Nhấn **"Chuyển sang hàng đợi"**
3. Appointment chuyển từ `Chờ đến` sang `Trong hàng đợi`
4. Hệ thống gửi thông báo đến nhân viên về appointment mới

> [!NOTE]
>
> * Chỉ nhân viên mới có quyền chuyển appointment sang "Trong hàng đợi".
> * Nhân viên có thể cập nhật thông tin chủ nuôi tại clinic bằng cách yêu cầu xuất trình CCCD.
> * Chủ nuôi không thể tự chuyển appointment sang "Trong hàng đợi".

***

### Phần B: Nhân viên thực hiện định danh

**1. Xem danh sách hàng đợi**

Nhân viên kiểm tra danh sách appointment đang ở trạng thái `Trong hàng đợi`. Mỗi mục hiển thị: mã appointment, tên chủ nuôi và số điện thoại.

**2. Nhấn Định danh để bắt đầu**

Nhân viên chọn appointment trong danh sách hàng đợi và nhấn **"Định danh"**:

* Hệ thống **chuyển trạng thái** appointment
* Appointment chuyển sang trạng thái `Đang thực hiện`

**3. Tạo hoặc Chỉnh sửa hồ sơ thú cưng**

Nhân viên rà soát lại thông tin thú cưng trước khi tiến hành:

1. Nhân viên kiểm tra xem thú cưng đã có hồ sơ trong hệ thống chưa.
2. Nếu chưa có, tiến hành tạo mới. Nếu đã có nhưng sai/thiếu thông tin, tiến hành **chỉnh sửa**:
   * **Tên thú cưng** (có thể điền tạm)
   * **Loài** (Species): Chó, Mèo, v.v.
   * **Giống** (Breed): Chọn hoặc để "Không rõ"
   * **Ảnh đại diện** (tùy chọn, có thể chụp sau)
   * **Ghi chú** (nếu có)
3. Có thể tạo nhiều hồ sơ thú cưng cho cùng một chủ nuôi trong cùng appointment.
4. Thú cưng chưa hoàn tất cấy chip có trạng thái **"Chưa định danh"**.

**4. Định danh từng thú cưng**

Thực hiện lần lượt cho mỗi thú cưng:

1. **Chọn thú cưng** từ danh sách "Chưa định danh"
2. **Quét mã chip sắp cấy** (bằng máy quét Barcode/RFID)
3. **Kiểm tra trùng lặp mã chip** — nếu trùng: cảnh báo và yêu cầu đổi chip khác; nếu hợp lệ: tiến hành **cấy chip** vào thú cưng
4. **Chụp 4 ảnh định danh:** trực diện, góc trái, góc phải, đặc điểm nhận dạng
5. **Xác nhận đã định danh** (Cập nhật ngày, giờ, nhân sự thực hiện)
6. **Nhấn "Hoàn tất định danh thú cưng này"**
7. Thú cưng chuyển từ `Chưa định danh` sang `Đã định danh`
8. Hệ thống quay lại danh sách để chọn thú tiếp theo

**5. Hoàn tất appointment**

Khi tất cả thú cưng được chọn trong appointment đã định danh xong, hoặc khi Clinic chủ động bấm **Kết thúc cuộc hẹn**:

* Appointment chuyển sang trạng thái `Đã hoàn tất` (không bắt buộc phải định danh 100% số thú cưng khách mang tới nếu khách đổi ý).
* Hệ thống gửi thông báo cho chủ nuôi
* Dữ liệu của những thú cưng đã định danh thành công sẽ được đồng bộ lên hệ thống và về App của chủ nuôi.

> [!WARNING]
>
> * Nhân viên có quyền tạo hồ sơ thú cưng mới.
> * Mỗi thú cưng phải có đủ 4 ảnh định danh mới được phép hoàn tất.
> * Mã chip phải là duy nhất trên toàn hệ thống.
> * Sau khi hoàn tất một thú cưng, hệ thống tự động quay lại danh sách để chọn thú tiếp theo.

***

## Trạng thái appointment

| Trạng thái | Mô tả | Vai trò chuyển |
| - | - | - |
| `Chờ đến` | Appointment mới tạo, chưa đến clinic | Chủ nuôi tạo trên App |
| `Đã đến clinic` | Nhân viên đã xác nhận check-in | Nhân viên quét QR |
| `Trong hàng đợi` | Hồ sơ chủ nuôi đã kiểm tra, chờ nhân viên | Nhân viên nhấn "Chuyển sang hàng đợi" |
| `Đang thực hiện` | Nhân viên đang thực hiện định danh | Nhân viên nhấn "Định danh" |
| `Đã hoàn tất` | Tất cả thú cưng đã định danh | Hệ thống tự động |
| `Đã hủy` | Appointment bị hủy | Chủ nuôi trên App |
| `Đã hết hạn` | Quá 4 ngày không check-in | Hệ thống tự động |


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