Danh Sách Đặt Phòng¶
Trang trung tâm quản lý tất cả đặt phòng trong hệ thống. Cho phép tìm kiếm, lọc, xem chi tiết, chỉnh sửa và ghi nhận thanh toán.
Thống Kê Nhanh¶
4 thẻ KPI tự động cập nhật theo dữ liệu thực:
| Thẻ | Ý nghĩa |
|---|---|
| ① Tổng đặt phòng | Tổng số đặt phòng trong hệ thống |
| ② Tổng doanh thu | Tổng doanh thu từ tất cả đặt phòng (VND) |
| ③ Đã check-in | Số đặt phòng đang ở trạng thái Checked In |
| ④ Đang chờ | Số đặt phòng ở trạng thái Pending |
Bảng Danh Sách Đặt Phòng¶
Cột Thông Tin¶
| Cột | Nội dung |
|---|---|
| ① Mã Đặt Phòng | Mã định danh duy nhất — nhấp để xem chi tiết |
| ② Khách | Tên, email, số điện thoại |
| ③ Ngày | Ngày check-in, check-out và số đêm (hoặc số giờ nếu đặt theo giờ) |
| ④ Phòng & Khách | Số phòng + tổng số khách (người lớn + trẻ em) |
| ⑤ Trạng Thái | Badge màu thể hiện trạng thái đặt phòng |
| ⑥ Nguồn | Kênh đặt phòng (DIRECT, OTA, PHONE, WALK_IN) |
| ⑦ Nhóm | Badge tím — xuất hiện nếu đặt phòng thuộc nhóm, nhấp để xem nhóm |
| ⑧ Số Tiền | Tổng tiền (VND) + badge trạng thái thanh toán |
| ⑨ Thao Tác | Xem / Sửa / Ghi nhận thanh toán |
Có thể nhấp tiêu đề cột Mã Đặt Phòng, Ngày, Trạng Thái, Số Tiền để sắp xếp.
Trạng Thái Đặt Phòng¶
| Trạng thái | Màu | Ý nghĩa |
|---|---|---|
| Pending | Cam | Chờ xác nhận hoặc xử lý |
| Confirmed | Xanh dương | Đã xác nhận, chờ khách đến |
| Checked In | Xanh lá | Khách đang lưu trú |
| Checked Out | Cyan | Đã trả phòng |
| Completed | Cyan | Lưu trú hoàn tất |
| Cancelled | Đỏ | Đã hủy |
| No Show | Đỏ nhạt | Khách không đến |
| On Hold | Vàng | Đang giữ chỗ |
| Pending Payment | Cam | Chờ thanh toán |
Trạng Thái Thanh Toán¶
| Trạng thái | Màu | Ý nghĩa |
|---|---|---|
| Pending | Cam | Chưa thanh toán |
| Paid / Completed | Xanh lá | Đã thanh toán đủ |
| Partially Paid | Xanh dương | Thanh toán một phần |
| Failed | Đỏ | Thanh toán thất bại |
| Refunded | Tím | Đã hoàn tiền |
Tìm Kiếm & Bộ Lọc¶
Card "Search & Filters" ở trên bảng. Tiêu đề hiển thị số bộ lọc đang áp dụng và nút Clear All khi có filter active.
Các Bộ Lọc¶
| # | Bộ lọc | Mô tả |
|---|---|---|
| ① | Tìm kiếm | Tìm theo tên khách, email, điện thoại hoặc mã đặt phòng (debounce 500ms) |
| ② | Trạng Thái | Lọc theo booking status (Pending, Confirmed, Checked In, ...) |
| ③ | Thanh Toán | Lọc theo trạng thái thanh toán (Pending, Paid, Partial, ...) |
| ④ | Nguồn | Lọc theo kênh: DIRECT, OTA, PHONE, WALK_IN |
| ⑤ | Khoảng Ngày | Date range picker — lọc theo ngày check-in |
| ⑥ | Làm Mới | Tải lại dữ liệu từ server |
Bên dưới các bộ lọc hiển thị dòng tóm tắt kết quả — số đặt phòng tìm được và tags bộ lọc đang active (nhấp ✕ trên tag để xóa từng bộ lọc).
Thao Tác Trên Đặt Phòng¶
Mỗi hàng trong bảng có tối đa 3 nút thao tác:
| Nút | Điều kiện hiển thị | Ý nghĩa |
|---|---|---|
| 👁️ Xem | Luôn hiển thị | Mở trang chi tiết đặt phòng |
| ✏️ Sửa | Có quyền booking:update + chưa CANCELLED/CHECKED_OUT |
Mở trang chỉnh sửa |
| 💰 Ghi nhận thanh toán | Có quyền payment:create + chưa thanh toán đủ + chưa CANCELLED/CHECKED_OUT |
Mở modal ghi nhận thanh toán |
Nhấp Mã Đặt Phòng (link xanh) cũng chuyển đến trang chi tiết.
Tạo Đặt Phòng Mới¶
Nhấp Create Booking (góc phải trên, nút Primary) để chuyển sang trang tạo đặt phòng mới.
Phân quyền
Nút Create Booking chỉ xuất hiện nếu bạn có quyền booking:create.
Mẹo & Thực Hành Tốt Nhất¶
Tìm đặt phòng nhanh
Nhập mã đặt phòng trực tiếp vào ô tìm kiếm để tìm chính xác. Hệ thống tìm kiếm theo tên, email, điện thoại và mã đặt phòng cùng lúc.
Theo dõi check-in hôm nay
Kết hợp lọc Trạng Thái = Confirmed + Khoảng Ngày = hôm nay để xem danh sách khách dự kiến nhận phòng trong ngày.
Ghi nhận thanh toán
Nút 💰 chỉ xuất hiện khi đặt phòng chưa thanh toán đủ và chưa hủy/trả phòng. Nếu không thấy nút, kiểm tra trạng thái thanh toán trong cột Số Tiền.
Câu Hỏi Thường Gặp¶
Nhấp Mã Đặt Phòng nhưng không chuyển trang được?
Kiểm tra quyền booking:read. Nếu đủ quyền mà vẫn không mở được, thử làm mới trang.
Không thấy nút 'Create Booking'?
Bạn chưa có quyền booking:create. Liên hệ quản trị viên để cấp quyền.
Không thấy nút Sửa (✏️) trên đặt phòng?
Nút Sửa ẩn khi đặt phòng đã ở trạng thái CANCELLED hoặc CHECKED_OUT, hoặc bạn chưa có quyền booking:update.
Cột Nhóm hiển thị khi nào?
Cột Nhóm chỉ hiển thị nội dung khi đặt phòng thuộc một group booking. Nhấp badge tím để xem trang quản lý nhóm.
Tìm kiếm gõ xong nhưng bảng chưa cập nhật ngay?
Tìm kiếm có độ trễ 500ms (debounce) để giảm tải API. Sau khi dừng gõ khoảng nửa giây, bảng sẽ tự động cập nhật.
Liên Kết Liên Quan¶
- Tạo Đặt Phòng — Quy trình tạo đặt phòng mới từng bước
- Chi Tiết Đặt Phòng — Xem và quản lý từng đặt phòng
- Lịch Đặt Phòng — Xem đặt phòng theo dạng lịch
- Đặt Phòng Nhóm — Quản lý đặt phòng theo nhóm