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

**Auth** là nền tảng bảo mật của hệ sinh thái ILUPET. Phân hệ này chịu trách nhiệm quản lý danh tính người dùng, xác thực quyền truy cập và đảm bảo luồng đăng ký đa vai trò (**Multi-role**) diễn ra mượt mà mà không gây xung đột dữ liệu.

## Mục tiêu nghiệp vụ

* **Đăng ký đa năng:** Cho phép một địa chỉ Email có thể đăng ký đồng thời vai trò Pet Owner và Merchant/Clinic
* **Quy trình phê duyệt nghiêm ngặt:** Đảm bảo các đối tác (Merchant/Clinic) được Admin kiểm duyệt thông tin trước khi chính thức hoạt động.
* **Bảo mật giao dịch:** Thiết lập nền tảng tin cậy cho các tác vụ thanh toán và quản lý hồ sơ sức khỏe sau này.

## Luồng nghiệp vụ (Business Logic)

Hệ thống cung cấp hai luồng đăng ký tài khoản chính dành cho đối tác (Merchant/Clinic):

1. **Đăng ký qua Mã giới thiệu (Referral Code):**
   * Đối tác nhận được mã giới thiệu gồm 4 ký tự từ hệ thống hoặc người giới thiệu.
   * Đối tác nhập Email và Mã giới thiệu tại màn hình đăng ký.
   * Hệ thống gửi link xác thực qua Email. Đối tác bấm vào link để thiết lập mật khẩu và tự hoàn tất quá trình tạo tài khoản.

2. **Admin Đăng ký hộ (Admin Invite):**
   * Quản trị viên (Admin) chủ động tạo tài khoản cho đối tác trực tiếp trên trang quản trị.
   * Sau khi khởi tạo thành công, hệ thống tự động gửi một URL mời tham gia về Email của đối tác.
   * Đối tác bấm vào URL này sẽ được điều hướng thẳng đến trang thiết lập mật khẩu (nhập mật khẩu và xác nhận mật khẩu mới) để kích hoạt tài khoản.

## Quy tắc chung (Common Rules)

* **Định dạng mật khẩu:** Tối thiểu 8 ký tự
* **Thời gian phiên (Session):** Access Token có thời hạn ngắn (ví dụ: 1 giờ) và Refresh Token có thời hạn dài (ví dụ: 7 ngày) để đảm bảo trải nghiệm người dùng.
* **Bảo mật:** Toàn bộ mật khẩu phải được mã hóa một chiều (Bcrypt) trước khi lưu trữ.


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