> ## 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-28: Xem lịch sử biến động kho

> Là một Merchant, tôi muốn xem toàn bộ lịch sử biến động số lượng tồn kho của một sản phẩm, để tôi có thể kiểm tra nguồn gốc thay đổi và truy xuất mọi thao tác đã xảy ra.

## Đ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 truy cập lịch sử

```mermaid theme={null}
flowchart TB
    A[Mở chi tiết sản phẩm] --> B{Chuyển sang tab Lịch sử}
    B --> C[Tải toàn bộ log biến động kho của sản phẩm]
    C --> D[Hiển thị danh sách theo thời gian mới nhất]
    D --> E{Lọc hoặc tìm kiếm}
    E --> F[Xem chi tiết log]
    E --> G[Export ra file Excel]
```

## Chức năng xem lịch sử

* Hiển thị toàn bộ log của sản phẩm từ khi tạo đến hiện tại
* Luôn sắp xếp theo thời gian mới nhất lên trên
* Có thể lọc theo loại giao dịch, khoảng thời gian, người thực hiện
* Có thể tìm kiếm theo ghi chú, mã tham chiếu
* Hỗ trợ export toàn bộ lịch sử ra file Excel
* Không có giới hạn số lượng bản ghi hiển thị

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

> ❌ **KHÔNG AI** được quyền xóa / chỉnh sửa một log biến động kho đã được tạo. Bao gồm cả ADMIN và hệ thống.

* Luôn sắp xếp lịch sử theo thời gian mới nhất lên trên
* Số lượng dương hiển thị màu xanh, số lượng âm hiển thị màu đỏ
* Khi click vào log chi tiết, hiển thị toàn bộ thông tin của giao dịch đó
* Hiển thị liên kết trực tiếp đến đơn hàng / phiếu nhập kho liên quan
* Có thể lọc theo loại giao dịch, khoảng thời gian, người thực hiện
* Hỗ trợ export toàn bộ lịch sử ra file Excel

Thông tin hiển thị trên mỗi dòng log:

* Thời gian giao dịch
* Loại giao dịch: `IMPORT` / `SALE` / `ADJUSTMENT` / `RETURN` / `EXPIRED`
* Số lượng biến động (+/-)
* Số lượng còn lại sau giao dịch
* Tham chiếu (Mã đơn hàng / Mã nhập kho)
* Người thực hiện
* Ghi chú lý do


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