> ## 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-10: Quản lý Pet Owner (User Management)

> Admin hệ thống xem danh sách người dùng cuối (Pet Owner), hỗ trợ khóa tài khoản hoặc xử lý các sự cố bảo mật.

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

* Admin đã đăng nhập thành công vào trang quản trị CRM ILU PET.
* Người dùng (Pet Owner) đã tải app và đăng ký tài khoản thành công (`US-OWN-02`).

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

> **Danh sách Pet Owner (User Table)**
>
> * Hệ thống hiển thị bảng danh sách toàn bộ Pet Owner trên hệ thống.
> * **Cột dữ liệu hiển thị:**
>   * **ID & Avatar** (`media_id`)
>   * **Họ Tên** (`name`)
>   * **Thông tin liên hệ:** Số điện thoại (`phone`) & Email (`email`)
>   * **Định danh eKYC:** Trạng thái KYC (`is_verified_kyc`)
>   * **Số lượng Pet:** Đếm tổng số Pet thuộc sở hữu.
>   * **Ngày đăng ký:** (`created_at`)
>   * **Trạng thái:** Hoạt động (`active`) / Tạm khóa (`inactive`) / Bị cấm (`banned`)
> * **Tìm kiếm/Lọc:** Cho phép tìm theo Tên, SĐT hoặc Email. Lọc theo Trạng thái tài khoản hoặc Trạng thái eKYC.

> **Xem chi tiết User (User Detail)**
>
> Khi click vào một User, hiển thị màn hình chi tiết gồm 3 nhóm thông tin chính:
>
> **1. Thông tin cá nhân & Bảo mật:**
>
> * Ảnh đại diện, Tên, Số điện thoại, Email.
> * **Trạng thái xác thực:** Bảo mật 2 lớp (`twoFactorEnabled`), Định danh điện tử (`is_verified_kyc`).
> * **Thông tin định danh:** Số CCCD (`cccd`), Nơi cấp, Ngày sinh (`date_of_birth`), Địa chỉ (`address`). Kèm theo hình ảnh CCCD (Ảnh mặt trước và Ảnh mặt sau).
> * **Trạng thái tài khoản:** Trạng thái hiện tại (`status`), Nếu bị khóa (`banned` = true) thì hiển thị kèm Lý do khóa (`banReason`) và Thời hạn khóa (`banExpires`).
> * Ngày tạo tài khoản (`created_at`) & Lần cập nhật cuối (`updated_at`).
>
> **2. Thông tin Thú cưng (Pet Portfolio):**
>
> * **Danh sách Pet:** Các thú cưng thuộc sở hữu (`pets.user_id`).
> * **Nhật ký sức khỏe (Health Logs):** Các hồ sơ sức khỏe, tiêm phòng mà người dùng đã tạo cho Pet (`pet_health_logs.created_by`).
>
> **3. Lịch sử Giao dịch & Dịch vụ:**
>
> * **Lịch sử Đặt lịch:** Danh sách các booking dịch vụ đã thực hiện (`merchant_bookings.pet_owner_id`).
> * **Lịch sử Mua hàng (Order):** Các đơn hàng sản phẩm đã mua trên nền tảng.
> * **Tổng chi tiêu (Total Spend):** Thống kê tổng số tiền đã tiêu qua hệ thống.

## 3. Tác vụ Quản trị (Admin Actions)

**1. Khóa/Mở khóa tài khoản (Ban/Unban)**

* Cung cấp nút gạt trạng thái để Khóa (Ban) các tài khoản có dấu hiệu spam, lừa đảo hoặc vi phạm tiêu chuẩn cộng đồng.
* Bắt buộc Admin phải nhập **Lý do khóa** (Plain-text) để lưu log.
* Tài khoản bị khóa sẽ không thể đăng nhập vào App ILU PET.

**2. Reset Mật khẩu (Password Reset)**

* Nếu User quên mật khẩu và gặp lỗi hệ thống không thể tự lấy lại, Admin có nút `Reset Mật khẩu`.
* Thao tác này sẽ sinh ra một mật khẩu ngẫu nhiên hoặc link đổi mật khẩu gửi thẳng về Email/SĐT của User.


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