> ## 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.

# US-ADM-04: Admin quản lý danh sách Clinic, Merchant

> Quản trị viên theo dõi, tìm kiếm, xem chi tiết và điều phối trạng thái hoạt động của các đối tác Merchant/Clinic.

## 1. Điều kiện tiên quyết (Pre-conditions)

* Tài khoản thao tác phải có quyền **Quản trị viên cao cấp (Super Admin)**.
* Đã đăng nhập thành công vào Dashboard quản trị.

## 2. Tiêu chí chấp nhận (Acceptance Criteria)

> **US-ADM-04.1: Giao diện Danh sách Đối tác (Merchant List)**
>
> **Hệ thống tìm kiếm và bộ lọc:**
>
> * **Tìm kiếm từ khóa:** Tên cửa hàng, Số điện thoại, Tên chủ cửa hàng (User hiển thị theo vai trò Owner).
> * **Bộ lọc Trạng thái:** Tất cả, Đang hoạt động, Tạm ngưng, Bị khóa.
>
> **Bảng dữ liệu (Data Table) hiển thị các trường:**
>
> 1. Tên Merchant/Clinic (Tên thương hiệu hiển thị trên App)
> 2. Chủ cửa hàng (Tên tài khoản Owner quản lý)
> 3. Ngày tạo (Ngày Merchant đăng ký vào hệ thống)
> 4. Trạng thái (Badge màu sắc thể hiện tình trạng hoạt động)
> 5. **Hành động (Actions):**
>    * **Nút Loyalty (Icon People):** Mở Big Dialog xem danh sách khách hàng thân thiết.
>    * **Nút Chi tiết (Icon Eye):** Điều hướng sang trang Chi tiết cửa hàng.

> **US-ADM-04.2: Xem chi tiết thông tin Đối tác (Merchant Detail)**
>
> Khi nhấn xem chi tiết, hệ thống điều hướng đến trang riêng biệt chứa các khối thông tin sau:
>
> * **Thông tin chung:** ID, Tên cửa hàng, Tên chủ sở hữu, Ngày tham gia, Mã giới thiệu.
> * **Hồ sơ pháp lý & Vị trí:** Số ĐKKD (GPKD), Địa chỉ chi tiết, Tọa độ GPS (Lat/Long).
> * **Kho hình ảnh:** Hiển thị các ảnh của Merchants.
>   * *Quyền Admin:* Có thể xem, sửa hoặc xóa (Xóa mềm - Soft Delete) các hình ảnh/giấy tờ này. Khi xóa cần hiển thị Popup xác nhận: `"Bạn có chắc chắn muốn gỡ bỏ hình ảnh/tài liệu này?"`.
> * **Thông tin tài chính:** Thông tin ngân hàng (Số tài khoản, Tên ngân hàng, Chi nhánh) để thực hiện đối soát.
> * **Dữ liệu Master Data của Merchant:**
>   * *Bảng Dịch vụ:* Hiển thị danh sách dịch vụ hiện có (Tên, Giá, Thời gian, Trạng thái).
>   * *Bảng Sản phẩm:* Hiển thị các sản phẩm đang bày bán (Tên, Giá, Tồn kho).

> **US-ADM-04.4: Quản lý khách hàng thân thiết (Loyalty Customers)**
>
> Khi nhấn vào **Icon People** tại danh sách, hệ thống hiển thị một trang/dialog bao gồm:
>
> * **Bộ công cụ:** Ô tìm kiếm khách hàng và nút `Export Excel` để xuất danh sách hiện tại.
> * **Bảng danh sách khách hàng:**
>   1. ID Khách hàng (nếu có)
>   2. Tên khách hàng
>   3. Email (nếu có)
>   4. Số điện thoại (nếu có)
>   5. Tổng số đơn hàng đã hoàn thành (Booking Count) tại Merchant này (nếu có).

## 3. Điều phối trạng thái hoạt động (US-ADM-04.5)

Admin có quyền cập nhật trạng thái của Merchant thông qua danh sách hoặc trang chi tiết:

1. **Đang hoạt động (Active):** Merchant hiển thị đầy đủ trên App Pet Owner và có thể nhận đơn hàng/booking bình thường.
2. **Bị khóa (Blocked):**
   * **Logic hệ thống:** Toàn bộ thông tin cửa hàng, dịch vụ, sản phẩm và khung giờ đặt chỗ của Merchant này sẽ bị **ẩn (Invisible)** khỏi App Pet Owner ngay lập tức.
   * **Quyền truy cập:** Merchant (Owner/Staff) **không thể đăng nhập** vào Web Merchant/App Merchant khi cửa hàng ở trạng thái Blocked.

## 4. Workflow Diagram (Logic Quản lý & Cập nhật trạng thái)

```mermaid theme={null}
graph TD
    A[Super Admin Dashboard] --> B[Danh sách Merchant]
    
    B --> |Tìm kiếm & Lọc| B
    B --> |Nhấn Icon Chi tiết| C[Trang Chi tiết Merchant]
    B --> |Nhấn Icon Loyalty| D[Danh sách Khách hàng thân thiết]
    
    C --> E{Thay đổi trạng thái Merchant}
    E --> |Active| F[Hiển thị đầy đủ trên App]
    E --> |Blocked| G[Ẩn thông tin trên App & Khóa quyền đăng nhập của Merchant]
    
    C --> H[Xem/Xóa Kho hình ảnh & GPKD]
    C --> I[Xem Bảng Dịch vụ & Sản phẩm]
    C --> J[Xem Thông tin tài chính]
```


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