Đặt lịch & Hẹn (Bookings)

Trang Đặt lịch & Hẹn (/app/bookings) quản lý toàn bộ các cuộc hẹn dịch vụ (Spa, Salon, Phòng khám, Tư vấn, Đặt bàn…) được tạo tự động bởi AI Agent (qua tool booking_creator) hoặc nhân viên tạo tay.

2 Chế độ hiển thị

Chế độ	Mã View	Mô tả & Thao tác
Dạng Lịch (Calendar)	FullCalendar	Hiển thị trực quan theo mốc giờ/ngày. Hỗ trợ 3 chế độ: - Tuần (`timeGridWeek`): Xem theo khung giờ trong tuần. - Tháng (`dayGridMonth`): Xem tổng quan các mốc trong tháng. - Danh sách tuần (`listWeek`): Liệt kê các cuộc hẹn theo tuần.
Dạng Bảng (List)	Bảng dữ liệu	Xem danh sách dạng bảng phân trang, hỗ trợ tìm kiếm tên khách, lọc theo Sản phẩm/Dịch vụ và lọc theo Trạng thái.

4 Trạng thái Lịch hẹn & Mã màu

Trạng thái key	Nhãn tiếng Việt	Màu hiển thị	Ý nghĩa
`pending`	Chờ duyệt	Vàng (`ui-tone-warning`)	AI hoặc khách mới đặt, chưa xác nhận.
`confirmed`	Đã xác nhận	Xanh dương (`ui-tone-info`)	Đã chốt lịch với khách hàng.
`completed`	Hoàn thành	Xanh lá (`ui-tone-success`)	Khách đã đến và hoàn tất dịch vụ.
`cancelled`	Đã hủy	Đỏ (`ui-tone-danger`)	Khách hủy hoặc shop hủy lịch.

Các thao tác xử lý Lịch hẹn

1. Nút thao tác nhanh trên từng lịch hẹn

✈️ Gửi tin nhắn xác nhận (send-confirmation): Bắn tin nhắn tự động sang kênh Facebook/Zalo của khách thông báo lịch hẹn đã được chốt (kèm ngày giờ và ghi chú).
📋 Gửi Form đăng ký (send-form): Bắn tin nhắn gửi link/form yêu cầu khách cung cấp thêm thông tin trước khi đến.
✅ Chuyển trạng thái: Đổi nhanh giữa Chờ duyệt → Đã xác nhận → Hoàn thành hoặc Đã hủy (có modal xác nhận hủy).
✏️ Sửa lịch hẹn: Đổi ngày giờ hẹn, đổi dịch vụ hoặc chỉnh sửa ghi chú.
🗑️ Xóa: Xóa cuộc hẹn khỏi hệ thống (có confirm dialog).

Bấm + Tạo lịch hẹn (trên header):

Khách hàng (subscriber_id): Chọn khách từ danh sách.
Sản phẩm / Dịch vụ (product_id): Chọn dịch vụ đăng ký (vd: Gói tư vấn 60 phút, Dịch vụ Spa).
Thời gian hẹn (booking_time): Chọn ngày và giờ hẹn chính xác (datetime-local).
Trạng thái ban đầu: Mặc định là Chờ duyệt (pending) hoặc Đã xác nhận (confirmed).
Ghi chú nội bộ (notes): Ghi lại yêu cầu đặc biệt của khách.

Tích hợp tự động hóa với AI Agent

Khi Agent được bật tool booking_creator:

AI đọc hiểu nhu cầu đặt lịch từ chat (vd: “Cho mình đặt lịch làm tóc 3h chiều thứ 7”).
AI đối chiếu giờ làm việc (working_hours), tự tạo bản ghi Booking ở trạng thái pending.
AI phản hồi xác nhận cho khách và hiển thị cuộc hẹn mới trên trang /app/bookings.

Bước tiếp theo

Sản phẩm & Dịch vụ — Quản lý catalog dịch vụ đặt lịch.
Đơn hàng — Quản lý đơn hàng bán lẻ.
Theo dõi khách hàng (Follow-ups) — Lên lịch nhắc khách trước giờ hẹn.