> ## 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-13: Cấu hình Nền tảng (System Configuration)

> Admin thiết lập các biến số cốt lõi ảnh hưởng đến dòng tiền và chính sách vận hành của hệ thống.

> [!NOTE]
>
> **Cập nhật v.1.7.0:** Điều chỉnh Escrow Hold Time mặc định từ 14 → 7 ngày;
> bổ sung cơ chế buffer 24h trước khi tự động release; thêm cấu hình Ngưỡng
> rút tiền theo Phân hạng Shop.

## 1. Điều kiện tiên quyết

* Admin có quyền (Role) Super Admin.

## 2. Giải thích cơ chế Dòng tiền (Money Flow)

Để dễ hình dung cách các cấu hình trên tương tác với nhau và tạo nên dòng chảy của tiền ("tiền vào, tiền ra"), dưới đây là sơ đồ và giải thích chi tiết:

### Sơ đồ Dòng tiền

```mermaid theme={null}
sequenceDiagram
    participant C as Khách hàng
    participant E as Ví tạm giữ (Escrow)
    participant ILU as Doanh thu ILU PET
    participant M as Ví khả dụng (Shop)
    participant B as Ngân hàng MB Bank

    Note over C,E: Tiền vào (Money In)
    C->>E: Thanh toán Đơn hàng/Booking
    Note over E: Bắt đầu giữ tiền (Escrow: 7 ngày)

    alt Có khiếu nại (Dispute)
        E-->>C: Xử lý hoàn tiền
    else Không có khiếu nại
        Note over E: Chờ thêm Buffer Time (24h)
        E->>ILU: Trích Phí nền tảng (Platform Fee)
        E->>M: Chuyển doanh thu thực nhận
    end

    Note over M,B: Tiền ra (Money Out)
    M->>M: Shop tạo lệnh rút tiền
    Note over M: Áp dụng Ngưỡng rút tiền (Tier)
    M->>B: Chuyển khoản về ngân hàng
```

## 3. Cách tiền hoạt động qua từng giai đoạn

1. **Tiền vào (Khách thanh toán):** Khi đơn hàng hoặc dịch vụ hoàn tất, tiền của khách hàng không chuyển thẳng cho Shop. Hệ thống giữ khoản tiền này tại một trạng thái trung gian gọi là **Ví tạm giữ (Escrow)**.
2. **Thời gian giữ tiền chờ khiếu nại (Escrow Hold Time):** Hệ thống giữ tiền mặc định trong **7 ngày**. Khoảng thời gian này bảo vệ khách hàng, cho phép họ yêu cầu hoàn trả nếu dịch vụ/sản phẩm có lỗi. Nếu qua 7 ngày không có khiếu nại, hệ thống chờ thêm **24 giờ (Buffer)** để đảm bảo đồng bộ trạng thái an toàn.
3. **Phân bổ và Đối soát (Settlement):** Khi thời gian tạm giữ kết thúc, số tiền sẽ được tách tự động:
   * Hệ thống tự động thu **Phí nền tảng (Platform Fee)** dựa trên `%` đã cài đặt và ghi nhận vào doanh thu của ILU PET.
   * Phần tiền còn lại chính là **Doanh thu thực nhận**, được cộng tự động vào **Ví khả dụng (Available Balance)** của Shop.
4. **Tiền ra (Shop rút tiền):** Sau khi tiền vào Ví khả dụng, Shop bắt đầu được phép rút tiền. Lúc này, **Ngưỡng rút tiền (Withdrawal Tier)** sẽ phát huy tác dụng. Hệ thống sẽ dựa vào hạng của Shop (Beginner, Intermediate, Pro) để quyết định Shop có được rút miễn phí hay không, tối thiểu rút bao nhiêu và có giới hạn nào không trước khi tiền thực sự đổ về tài khoản ngân hàng của họ.

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

> **Cấu hình Phí nền tảng (Platform Fee)**
>
> * Cho phép Admin cài đặt tỷ lệ `%` thu phí trên mỗi giao dịch thành công.
> * **Ràng buộc:** Mức phí phải nằm trong khoảng `0%` đến `100%`.
> * **Impact:** Giá trị này sẽ được dùng để tự động trích lập doanh thu của ILU PET khi chạy lệnh Đối soát (Settlement) cho Merchant.

> **Cấu hình Thời gian giữ tiền (Escrow Hold Time)**
>
> > [!TIP]
> >
> > **Cập nhật v.1.7.0:** Điều chỉnh giá trị mặc định từ 14 ngày → 7 ngày và
> > bổ sung cơ chế buffer 24h trước khi tự động release.
>
> * Cho phép cài đặt số ngày giữ tiền tạm ứng (Hold) tính từ lúc Đơn
>   hàng/Booking hoàn tất. - **Giá trị mặc định:** 7 ngày (Phục vụ cho quy trình
>   khiếu nại/trả hàng). - **Buffer Release:** Sau khi hết thời gian Hold và
>   không có Dispute, hệ thống chờ thêm **24 giờ** trước khi tự động chuyển tiền
>   vào Available Balance. Tổng thời gian hiệu lực từ khi đơn "Hoàn thành" đến
>   khi Merchant có thể rút tiền là **T+7 ngày + 24h**. - **Impact:** Quá thời
>   gian này (và không có khiếu nại), hệ thống mới tự động chuyển tiền vào ví
>   khả dụng (Available Balance) để Merchant rút về MB Bank.

> **Cấu hình Ngưỡng rút tiền theo Phân hạng Shop (Withdrawal Tier)**
>
> > [!TIP]
> >
> > **Mới v.1.7.0:** Cho phép Admin thiết lập hạn mức rút tiền và số lần rút
> > miễn phí tương ứng với từng phân hạng Shop.
>
> * Admin thiết lập các mức hạn mức cho từng tier: - **Beginner:** Số tiền rút
>   tối thiểu mỗi lần và số lần rút miễn phí/tháng; vượt ngưỡng thu thêm
>   phí/lệnh. - **Intermediate:** Hạn mức rút cao hơn, thêm lượt rút miễn
>   phí/tháng. - **Pro:** Không giới hạn số tiền, không giới hạn số lần rút, ưu
>   tiên xử lý. - **Impact:** Giá trị này được áp dụng khi Merchant tạo lệnh rút
>   tiền ở **US-MER-39**.

> **Lưu vết hệ thống (Audit Log)**
>
> * Bất kỳ thay đổi nào đối với cấu hình hệ thống đều phải được ghi log (Ai đổi, đổi lúc nào, giá trị cũ là gì, giá trị mới là gì) để phục vụ tra soát.


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