Kiểm Tra Minibar¶

Trang Kiểm Tra Minibar (/dashboard/stock/minibar-check) cho phép nhân viên ghi nhận tình trạng minibar trong phòng khi khách đang lưu trú. Hệ thống tự động tính số lượng tiêu thụ, tổng tiền cần tính phí và tạo đề xuất bổ sung tồn kho.

Tổng Quan¶

Trang kiểm tra minibar với ô chọn phòng và trạng thái chờ chọn phòng

Trang chỉ hiển thị các phòng đang có khách checked-in. Chọn phòng để mở ngay modal kiểm tra.

#	Thành phần	Mô tả
①	Chọn phòng	Dropdown chứa danh sách phòng đang có khách — định dạng `Phòng {số} — {tên khách}`
②	Trạng thái trống	Thông báo "Không có phòng đang checked-in." khi không có khách nào

Lưu ý: Chỉ phòng có trạng thái Checked-in mới xuất hiện trong danh sách.

Modal kiểm tra minibar phòng với bảng hàng hóa template mode — cột Chuẩn, Thực tế, Tiêu thụ, Miễn phí

Sau khi chọn phòng, modal Kiểm tra Minibar — Phòng {số} tự động mở với danh sách hàng hóa minibar.

Hai Chế Độ Hiển Thị¶

Hệ thống tự nhận biết loại phòng có template minibar hay không:

Template Mode (có template)Free Mode (không có template)

Hiển thị khi loại phòng đã cấu hình Minibar Template với số lượng chuẩn (par):

Cột	Mô tả
Hàng hóa	Tên hàng hóa minibar
ĐVT	Đơn vị tính
Chuẩn	Số lượng chuẩn (par) theo template
Thực tế	Nhập số lượng còn lại trong minibar (tối đa = chuẩn)
Tiêu thụ	Tự động tính: `Chuẩn − Thực tế` (hiển thị badge đỏ)
Giá	Đơn giá tính phí
Miễn phí	Checkbox — tự động tích nếu tiêu thụ = 0; bỏ tích để vẫn tính phí

Hướng dẫn nhập: Nhập số lượng thực tế còn lại trong minibar. Hệ thống tự tính tiêu thụ.

Hiển thị khi loại phòng chưa có template minibar:

Cột	Mô tả
Hàng hóa	Tên hàng hóa minibar
ĐVT	Đơn vị tính
Tiêu thụ	Nhập trực tiếp số lượng đã tiêu thụ
Giá	Đơn giá tính phí
Miễn phí	Checkbox — tích nếu không tính phí mục này

Hướng dẫn nhập: Nhập số lượng đã tiêu thụ cho từng mục.

Thống kê	Mô tả
Mục tiêu thụ	Tổng số hàng hóa có tiêu thụ > 0
Tổng tính phí	Tổng tiền cần tính cho khách (màu xanh)

Các Nút Hành Động¶

Nút	Chức năng
Bỏ qua	Đóng modal, không ghi nhận gì
Không tiêu thụ	Xác nhận tất cả hàng hóa nguyên vẹn, không tính phí
Xác nhận ({n} mục)	Ghi nhận tiêu thụ và tính phí cho `n` mục có tiêu thụ > 0

Kết Quả Sau Xác Nhận¶

Màn hình kết quả kiểm tra minibar — danh sách hàng tính phí và đề xuất bổ sung tồn kho

Sau khi nhấn Xác nhận, hệ thống xử lý và hiển thị kết quả ngay trong modal:

Hàng Hóa Tính Phí¶

Danh sách các mục tiêu thụ kèm số lượng và thành tiền — sẽ được cộng vào hóa đơn của khách.

Đề Xuất Bổ Sung Tồn Kho¶

Danh sách hàng cần bổ sung vào minibar để đảm bảo số lượng chuẩn cho lần kiểm tra tiếp theo.

Lưu ý: Việc bổ sung tồn kho phải được thực hiện thủ công — hệ thống chỉ đề xuất, không tự động xuất kho.

Quy Trình Kiểm Tra Minibar¶

flowchart TD
    A[Chọn phòng checked-in] --> B[Modal tự mở]
    B --> C{Loại phòng có\nMinibar Template?}
    C -->|Có| D[Template Mode\nNhập số lượng thực tế còn lại]
    C -->|Không| E[Free Mode\nNhập số lượng đã tiêu thụ]
    D --> F[Hệ thống tự tính Tiêu thụ = Chuẩn − Thực tế]
    E --> F
    F --> G{Xác nhận?}
    G -->|Bỏ qua| H[Không ghi nhận]
    G -->|Không tiêu thụ| I[Ghi nhận 0 tiêu thụ]
    G -->|Xác nhận| J[Ghi nhận tiêu thụ\nTính phí vào hóa đơn]
    J --> K[Hiển thị kết quả\n+ Đề xuất bổ sung kho]

Cấu Hình Trước Khi Dùng¶

Để tính năng Template Mode hoạt động, cần cấu hình trước:

Tạo hàng hóa minibar — tại Hàng hóa với loại phù hợp
Tạo Minibar Template — tại Minibar Templates, gắn với loại phòng và đặt số lượng chuẩn (par)
Khách đã check-in — phòng phải có booking đang hoạt động với trạng thái Checked-in

Nếu loại phòng chưa có Minibar Template, hệ thống vẫn hoạt động ở chế độ Free Mode.