> ## 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-01: Quản lý danh mục Master Data toàn hệ thống

> Quản trị viên thiết lập và quản lý các danh mục chuẩn của hệ thống (Giống loài, Dịch vụ, Sản phẩm...) để đảm bảo tính nhất quán dữ liệu.

## 1. Mục tiêu (Objective)

Là một Admin có quyền "Master Data Management", tôi muốn quản lý (Thêm/Sửa/Xóa/Ẩn) các danh mục chuẩn của hệ thống để các Actor khác (Merchant, Clinic, Pet Owner) có thể sử dụng dữ liệu một cách đồng nhất.

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

> **US-ADM-01.1: Quản lý danh mục Giống loài (Breeds)**
>
> Admin có thể Thêm/Sửa/Xóa/Ẩn danh mục giống loài.
> Mỗi bản ghi bao gồm các trường thông tin:
>
> * Loại thú (Chó/Mèo)
> * Tên giống
> * Mô tả

> **US-ADM-01.2: Quản lý danh mục Bệnh lý (Diseases) \[Delay]**
>
> Admin thiết lập danh mục bệnh lý chuẩn Vet. Dữ liệu này sẽ dùng để map với dữ liệu đẩy về từ Clinic (3rd party).

> **US-ADM-01.3: Quản lý danh mục Bảo hiểm (Insurance) \[Delay]**
>
> Admin cấu hình được danh sách gói bảo hiểm từ đối tác (Nam Á, MIC).
> Bao gồm các trường: Tên gói, Đối tác, Quy tắc kích hoạt, và API Mapping key.

> **US-ADM-01.4: Quản lý Danh mục Dịch vụ (Merchant Services)**
>
> Admin định nghĩa các loại hình dịch vụ mẫu (Spa, Grooming, Lưu trú...) để Merchant chọn khi tạo Combo hoặc dịch vụ lẻ tại cửa hàng của họ.

> **US-ADM-01.6: Quản lý Danh mục Sản phẩm (Product Categories)**
>
> Admin quản lý cây danh mục đa cấp (Category - SubCategory) cho sản phẩm.
> Ví dụ: Thức ăn -> Thức ăn hạt; Phụ kiện -> Vòng cổ.

## 3. Quy tắc nghiệp vụ (Business Rules)

**1. US-ADM-01.7: Tính hợp nhất và ràng buộc**

Không được xóa các danh mục đang có dữ liệu liên kết (Ví dụ: Không thể xóa một "Giống loài" đang có Pet sử dụng trên hệ thống).
Trong trường hợp này, chỉ được phép chuyển trạng thái sang "Ngừng hoạt động" (Deactivate) để ẩn khỏi các màn hình chọn mới.

**2. US-ADM-01.8: Tìm kiếm và Lọc**

Admin có thể tìm kiếm các danh mục theo từ khóa và lọc theo trạng thái (Active / Inactive).

**3. US-ADM-01.9: Phân quyền truy cập**

Chỉ tài khoản Admin có quyền `Master Data Management` mới có thể thực hiện thay đổi dữ liệu trong tính năng này.


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