Quản Lý Khách Hàng¶
Trang Quản lý Khách hàng hiển thị toàn bộ khách hàng của khách sạn — tìm kiếm, lọc theo cấp độ thành viên, xem hồ sơ chi tiết và quản lý lịch sử đặt phòng, dịch vụ, điểm tích lũy.
Danh Sách Khách Hàng¶

Thẻ Thống Kê (①–④)¶
| # | Thẻ | Nội dung |
|---|---|---|
| ① | Tổng Khách hàng | Tổng số khách trong hệ thống |
| ② | Mới Tháng này | Số khách được tạo trong tháng hiện tại |
| ③ | Thành viên VIP | Số khách có cấp độ Gold / Platinum |
| ④ | Chi tiêu Trung bình | Trung bình chi tiêu trên mỗi khách (VNĐ) |
Tìm Kiếm & Lọc¶
| # | Điều khiển | Mô tả |
|---|---|---|
| ⑤ | Ô tìm kiếm | Tìm theo tên, email hoặc số điện thoại — lọc tức thì |
| ⑥ | Lọc cấp độ thành viên | Dropdown: Tất cả / Đồng / Bạc / Vàng / Bạch kim |
Bảng Danh Sách¶
| # | Cột | Nội dung |
|---|---|---|
| ⑦ | Khách hàng | Avatar + tên đầy đủ + email + badge cấp độ thành viên (màu) |
| ⑧ | Liên hệ | Số điện thoại + quốc tịch |
| ⑨ | Lịch sử Đặt phòng | Số lần đặt + ngày đặt phòng gần nhất |
| ⑩ | Tổng Chi tiêu | Tổng số tiền đã thanh toán (VNĐ) |
| ⑪ | Thành viên từ | Ngày tạo tài khoản |
| ⑫ | Hành động | Menu dropdown — Xem Chi tiết / Sửa Khách hàng / Lịch sử Đặt phòng |
Góc trên phải bảng: nút ⑬ Thêm Khách hàng — mở modal tạo mới.
Phía dưới bảng: phân trang hiển thị X–Y trong số Z khách hàng.
Chi Tiết Khách Hàng¶
Nhấp Xem Chi tiết từ menu hành động → mở trang /dashboard/guests/:id.

Trang gồm header và 4 tab:
| Tab | Nội dung |
|---|---|
| Hồ sơ | Thông tin cá nhân đầy đủ |
| Lịch sử Đặt phòng | Tất cả booking của khách |
| Lịch sử Sử dụng Dịch vụ | Các dịch vụ khách đã dùng |
| Giao dịch Tích điểm | Lịch sử tích / đổi điểm loyalty |
Nút Sửa ở góc trên phải — mở modal chỉnh sửa.
Tab Hồ Sơ¶
Thông tin cá nhân:
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Họ / Tên | ✓ | Tên đầy đủ |
| ✓ | Địa chỉ email | |
| Điện thoại | ✓ | Số điện thoại liên hệ |
| Quốc tịch | ✓ | Quốc tịch (VN, US, JP, KR...) |
| Ngày sinh | — | Ngày sinh của khách |
| Địa chỉ | — | Địa chỉ, Thành phố, Tỉnh/Bang, Quốc gia |
| Ngôn ngữ Ưa thích | — | Tiếng Việt / Tiếng Anh / Tiếng Pháp / Tiếng Đức |
Tab Lịch Sử Đặt Phòng¶

Bảng booking với các cột:
| Cột | Nội dung |
|---|---|
| Mã Đặt phòng | Link nhấp để mở chi tiết booking |
| Ngày | Check-in → Check-out |
| Phòng | Số phòng |
| Số tiền | Tổng tiền booking |
| Trạng thái | ĐÃ XÁC NHẬN / ĐÃ NHẬN PHÒNG / ĐÃ TRẢ PHÒNG / ĐÃ HỦY |
| Nguồn | Kênh đặt phòng (Direct, OTA...) |
Tab Lịch Sử Dịch Vụ¶
Danh sách các dịch vụ bổ sung khách đã sử dụng — tên dịch vụ, ngày sử dụng, booking liên quan.
Tab Giao Dịch Tích Điểm¶
Timeline các giao dịch điểm loyalty:
- TÍCH — điểm được cộng (sau check-out, mua dịch vụ...)
- ĐỔI — điểm được dùng để đổi ưu đãi
Chưa tham gia loyalty
Nếu khách chưa đăng ký chương trình tích điểm, tab hiển thị: "Khách hàng chưa tham gia chương trình tích điểm". Liên hệ lễ tân để đăng ký khi khách check-in.
Tạo / Sửa Khách Hàng¶

Nhấp Thêm Khách hàng (danh sách) hoặc Sửa (chi tiết) → modal mở ra.
| # | Trường | Bắt buộc | Mô tả |
|---|---|---|---|
| ① | Họ | ✓ | Họ của khách |
| ② | Tên | ✓ | Tên của khách |
| ③ | ✓ | Định dạng customer@email.com |
|
| ④ | Điện thoại | ✓ | VD: +84 xxx xxx xxx |
| ⑤ | Quốc tịch | ✓ | Dropdown chọn quốc tịch |
| ⑥ | Ngày sinh | — | DatePicker (tùy chọn) |
| ⑦ | Địa chỉ | — | Địa chỉ đường phố |
| ⑧ | Thành phố | — | Tên thành phố |
| ⑨ | Tỉnh/Bang | — | Tỉnh hoặc bang |
| ⑩ | Quốc gia | — | Dropdown chọn quốc gia |
| ⑪ | Ngôn ngữ Ưa thích | — | Dropdown ngôn ngữ giao tiếp |
Cấp Độ Thành Viên¶
| Cấp độ | Màu badge | Ý nghĩa |
|---|---|---|
| Đồng (BRONZE) | 🟫 Nâu | Thành viên mới, ít lưu trú |
| Bạc (SILVER) | ⚪ Bạc | Thành viên thường xuyên |
| Vàng (GOLD) | 🟡 Vàng | Khách hàng thân thiết |
| Bạch kim (PLATINUM) | 💎 Xanh | Khách VIP cao nhất |
Badge cấp độ hiển thị trực tiếp trên avatar trong cột Khách hàng của bảng danh sách.
Mẹo & Thực Hành Tốt Nhất¶
Tìm khách nhanh
Gõ 4 số cuối điện thoại vào ô tìm kiếm — nhanh và chính xác hơn gõ tên đầy đủ.
Lọc VIP trước khi check-in mùa cao điểm
Dùng bộ lọc Bạch kim + Vàng để xem danh sách khách VIP sắp đến — chuẩn bị phòng và amenities phù hợp.
Loyalty chưa kích hoạt
Nếu tab Giao dịch Tích điểm hiển thị thông báo chưa đăng ký, đề xuất khách đăng ký khi check-in qua màn hình Nhận Phòng.
Câu Hỏi Thường Gặp¶
Không tìm thấy khách trong danh sách?
Kiểm tra xem có đang áp dụng bộ lọc cấp độ không — xóa bộ lọc trước rồi tìm lại. Nếu vẫn không thấy, khách chưa được tạo trong hệ thống.
Badge cấp độ không hiển thị?
Khách chưa được gán cấp độ thành viên. Cấp độ được cập nhật tự động qua module Loyalty khi đủ điều kiện.
Muốn xem booking của một khách cụ thể?
Từ menu hành động → Lịch sử Đặt phòng — chuyển thẳng đến danh sách booking đã lọc theo khách đó. Hoặc mở tab Lịch sử Đặt phòng trong trang chi tiết khách.
Sửa thông tin khách nhưng email đã được dùng?
Email phải là duy nhất trong hệ thống. Nếu muốn thay đổi email, cần đảm bảo email mới chưa tồn tại ở khách hàng nào khác.
Liên Kết Liên Quan¶
- Quy Trình Nhận Phòng — Đăng ký loyalty khi check-in
- Danh Sách Đặt Phòng — Quản lý booking
- Loyalty & Thành Viên — Chương trình tích điểm