> ## 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-MER-27: Thiết lập cảnh báo tồn kho tối thiểu

> Là một Merchant, tôi muốn thiết lập mức cảnh báo tồn kho cho từng sản phẩm, để hệ thống tự động thông báo khi sản phẩm sắp hết hàng và tôi có thể chủ động nhập hàng kịp thời.

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

* Merchant đã đăng nhập vào hệ thống
* Sản phẩm đã tồn tại trong hệ thống.

## Luồng quy trình thiết lập cảnh báo

```mermaid theme={null}
flowchart TB
    A[Mở chi tiết sản phẩm] --> B{Nhấn nút Cài đặt cảnh báo}
    B --> C[Mở form nhập giá trị min_stock_alert]
    C --> D[Nhập giá trị mong muốn]
    D --> E{Kiểm tra validation}
    E -->|Không hợp lệ| F[Hiển thị lỗi]
    F --> D
    E -->|Hợp lệ| G{Lưu thay đổi}
    G --> H[Kiểm tra lại trạng thái cảnh báo hiện tại]
    H --> I[Ghi log lịch sử thay đổi]
    I --> J[Thông báo thành công]
```

## Chức năng thiết lập cảnh báo

* Chức năng truy cập được từ màn hình chi tiết sản phẩm
* Merchant có thể thiết lập giá trị `min_stock_alert` cho từng sản phẩm riêng biệt
* Giá trị mặc định khi tạo sản phẩm mới = 1
* Khi đặt giá trị = 0 → tắt hoàn toàn cảnh báo tồn kho thấp cho sản phẩm này
* Mọi thay đổi giá trị đều được ghi log lịch sử chi tiết vĩnh viễn

## Các loại cảnh báo hệ thống

| Loại cảnh báo | Điều kiện kích hoạt | Mức độ | Hiển thị |
| - | - | - | - |
| **Tồn kho thấp** | Tổng tồn kho nhỏ hơn hoặc bằng `min_stock_alert` | Warning | Banner cảnh báo chi tiết |

## Ràng buộc và Quy tắc

* Giá trị `min_stock_alert` chỉ chấp nhận số nguyên lớn hơn hoặc bằng 0
* Khi tồn kho được cập nhật, hệ thống realtime kiểm tra nếu nhỏ hơn hoặc bằng `min_stock_alert` thì sẽ hiển thị cảnh báo
* Cảnh báo tự động ẩn đi khi điều kiện không còn thỏa mãn nữa (ví dụ: sau khi nhập thêm hàng)
* Cảnh báo tồn kho thấp chỉ áp dụng cho tổng số lượng tồn kho của sản phẩm


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