Quản lý cổng
Đối tượng
Bảo vệ kho / Gate keeper sử dụng Trang Quản lý cổng
I. Tổng quan
Trang Quản lý cổng là công cụ dành cho bảo vệ kho thực hiện các nghiệp vụ:
- Đăng tài xe bằng cách nhập mã đăng ký hoặc quét mã QR/Barcode của tài xế.
- Xác nhận xe vào cổng (Check-in) khi xe đến kho.
- Xác nhận xe rời cổng (Check-out) khi xe hoàn tất vận hành và rời kho.
- Tra cứu lịch sử xe ra vào cổng trong ngày.
ghi chú
Toàn bộ thao tác được thực hiện trên tab Vận hành cổng và tab Lịch sử của trang Quản lý cổng trên web.
Màn hình Quản lý cổng
II. Đăng tài xe
Đăng tài là thao tác ghi nhận xe đã đến kho và cấp số thứ tự (STT) hàng đợi. Có 2 cách thực hiện:
Cách 1: Quét mã QR / Barcode
| Bước | Thao tác |
|---|---|
| 1. Y êu cầu tài xế | Đề nghị tài xế mở App Driver → Chi tiết đăng ký → hiển thị mã QR. |
| 2. Quét mã | Dùng thiết bị quét mã QR hoặc Barcode trên màn hình 'Quản lý cổng'. |
| 3. Hệ thống validate | Hệ thống tự động kiểm tra tính hợp lệ của mã và thời gian. |
| 4. Hoàn tất | Nếu hợp lệ → Pop-up 'Chi tiết đăng ký' hiển thị, xe được cấp STT hàng đợi. |
Cách 2: Nhập mã đăng ký thủ công
| Bước | Thao tác |
|---|---|
| 1. Lấy mã từ tài xế | Yêu cầu tài xế cung cấp mã đăng ký (dock_appointment_id). |
| 2. Nhập mã | Gõ mã vào ô 'Mã đăng ký' trong tab 'Vận hành cổng'. |
| 3. Bấm 'Đăng tài' | Click button 'Đăng tài', hệ thống kiểm tra tính hợp lệ. |
| 4. Hoàn tất | Nếu hợp lệ → Pop-up 'Chi tiết đăng ký' hiển thị, xe được cấp STT hàng đợi. |
Thời gian đăng tài
Xe chỉ được đăng tài trong khung giờ cho phép. Đến quá sớm hoặc quá trễ so với khung giờ đăng ký đều bị từ chối. Xem bảng xử lý lỗi ở Phần VI.
III. Quản lý xe vào cổng (Check-in)
3.1. Danh sách chờ vào cổng
Sau khi đăng tài thành công, xe xuất hiện trong Danh sách chờ vào cổng với trạng thái CHECKING_IN. Thông tin hiển thị trên mỗi card:
| Thông tin | Mô tả |
|---|---|
| Icon màu xám | Xe chưa đến giờ bắt đầu slot đăng ký. |
| Icon màu đỏ | Xe đã đến hoặc quá giờ bắt đầu slot — cần ưu tiên xử lý. |
| Mã đăng ký | ID của lịch hẹn dock. |
| Biển số xe | Biển số xe đăng ký. |
| Loại xe | Loại phương tiện. |
| Khung giờ | Thời gian bắt đầu – kết thúc slot. |
| S ố thứ tự (STT) | Vị trí hàng đợi của xe tại kho. |
Ưu tiên xử lý
Các card có icon màu đỏ là xe đã đến giờ hoặc trễ giờ — cần được check-in sớm. Dùng bộ lọc Trễ để lọc nhanh các xe này.
3.2. Thực hiện Check-in (Xe vào cổng)
| Bước | Thao tác |
|---|---|
| 1. Xác nhận xe | Kiểm tra biển số xe thực tế khớp với thông tin trên card. |
| 2. Click 'Vào cổng' | Nhấn button 'Vào cổng' trên card hoặc trong pop-up Chi tiết đăng ký. |
| 3. Xác nhận thành công | Toast 'Vào cổng thành công!' hiển thị → Card ẩn khỏi danh sách chờ vào cổng. |
| 4. Xe vào kho | Xe chuyển sang 'Danh sách chờ ra cổng' với trạng thái WAITING_FOR_DOCK. |
3.3. Lọc danh sách chờ vào cổng
| Tuỳ chọn lọc | Kết quả hiển thị |
|---|---|
| Tất cả | Tất cả xe có trạng thái CHECKING_IN (mặc định). |
| Trễ | Chỉ xe có giờ bắt đầu slot ≤ giờ hiện tại (xe trễ hoặc đúng giờ). |
IV. Quản lý xe ra cổng (Check-out)
4.1. Danh sách chờ ra cổng
Danh sách hiển thị các xe đang trong khuôn viên kho, gồm những xe có trạng thái:
| Trạng thái | Ý nghĩa |
|---|---|
| WAITING_FOR_DOCK | Xe đã vào cổng, đang chờ được phân dock. |
| AT_DOCK | Xe đang tại dock, đang tiến hành vận hành. |
| LEFT_DOCK | Xe đã rời dock, chờ ra cổng. |
4.2. Thực hiện Check-out (Xe rời cổng)
| Bước | Thao tác |
|---|---|
| 1. Xác nhận xe | Kiểm tra biển số xe thực tế khớp với thông tin trong danh sách. |
| 2. Click 'Rời cổng' | Nhấn button 'Rời cổng' trên card hoặc trong pop-up Chi tiết đăng ký. |
| 3. Xác nhận thành công | Toast 'Rời cổng thành công!' hiển thị → Card ẩn khỏi danh sách chờ ra cổng. |
| 4. Ghi nhận kết quả | Hệ thống tự động ghi nhận: OPERATION_COMPLETED (hoàn thành) hoặc OPERATION_FAILED (chưa vào dock). |
Ghi chú kết quả
- Nếu xe chưa vào dock (
WAITING_FOR_DOCK) mà đã rời cổng → hệ thống ghiOPERATION_FAILED. - Nếu xe đã qua dock (
AT_DOCK/LEFT_DOCK) → ghiOPERATION_COMPLETED.
V. Tra cứu lịch sử
5.1. Xem tab Lịch sử
Tab Lịch sử hiển thị tất cả xe đã từng đăng tài trong ngày (kể cả đã check-out hoặc bị huỷ sau khi đăng tài). Thông tin hiển thị:
- ID đăng ký, trạng thái, ngày đăng ký, khung giờ.
- SĐT tài xế, biển số xe, loại xe.
5.2. Xem chi tiết trong Lịch sử
Click vào mã đăng ký (ID) trong tab Lịch sử để xem đầy đủ timeline vận hành:
| Thông tin | Mô tả |
|---|---|
| Tạo bởi | Nhân viên tạo lịch hẹn và thời điểm tạo. |
| Chỉnh sửa bởi | Nhân viên chỉnh sửa lịch (nếu có). |
| Huỷ bởi | Vai trò và lý do huỷ (nếu bị huỷ). |
| Đăng tài | Bảo vệ thực hiện, thời điểm, phương thức đăng tài (QR / mã / barcode). |
| Vào cổng | Bảo vệ xác nhận check-in và thời điểm. |
| Check-out | Bảo vệ xác nhận rời cổng và thời điểm. |
5.3. Tìm kiếm
Nhập từ khoá vào ô tìm kiếm 'Tìm kiếm ID đăng ký, SĐT, biển số' rồi nhấn Enter:
- Tìm theo ID đăng ký, số điện thoại tài xế, hoặc biển số xe.
- Không phân biệt chữ hoa/thường, hỗ trợ tìm kiếm một phần (không cần nhập đầy đủ).
- Nếu không tìm thấy → hiển thị 'Không tìm thấy đăng ký phù hợp'.
5.4. Lọc theo trạng thái và khoảng ngày
- Lọc theo trạng thái:
CHECKING_IN,WAITING_FOR_DOCK,AT_DOCK,LEFT_DOCK,CHECKED_OUT,CANCELED. - Lọc theo khoảng ngày (
appointment_date): chọn ngày bắt đầu và kết thúc → nhấn Áp dụng.
VI. Xử lý các thông báo lỗi
6.1. Lỗi khi Đăng tài
| Thông báo/Lỗi | Nguyên nhân | Hành động |
|---|---|---|
| Đăng ký không tồn tại! | Mã đăng ký không đúng hoặc không có trong hệ thống. | Yêu cầu tài xế kiểm tra lại mã trên App Driver và cung cấp lại. |
| Đăng ký đã bị huỷ! | Lịch hẹn đã bị điều phối huỷ trước đó. | Thông báo tài xế liên hệ điều phối vận tải để được hỗ trợ. |
| Đăng ký đã quá thời gian! | Xe đến quá trễ, trạng thái đã chuyển NO_SHOW. | Liên hệ điều phối để xử lý trường hợp ngoại lệ nếu cần. |
| Đăng ký đã đăng tài rồi! | Xe đã được đăng tài trước đó. | Tìm xe trong 'Danh sách chờ vào cổng' theo biển số để check-in. |
| Chưa tới thời gian đăng tài! | Xe đến quá sớm so với khung giờ cho phép. | Đề nghị xe chờ và quay lại đăng tài khi đến giờ. |
| Chưa tới ngày đăng tài! | Ngày hôm nay không phải ngày trong lịch đăng ký. | Kiểm tra lại ngày trong lịch hẹn của tài xế. |
6.2. Lỗi khi Check-in
| Thông báo/Lỗi | Nguyên nhân | Hành động |
|---|---|---|
| Cảnh báo: Đăng ký đã bị huỷ, xe không thể vào cổng! | Lịch hẹn bị huỷ sau khi đã đăng tài. | Nhấn 'Đã hiểu' để đóng cảnh báo, thông báo tài xế liên hệ điều phối. |
VII. Tóm tắt quy trình vận hành
Luồng xử lý tiêu chuẩn trong ca làm việc của bảo vệ:
| Bước | Thao tác | Kết quả | Trạng thái sau |
|---|---|---|---|
| 1 | Đăng tài | Xe xuất hiện trong Danh sách chờ vào cổng, được cấp STT. | CHECKING_IN |
| 2 | Click 'Vào cổng' | Toast 'Vào cổng thành công!', xe sang Danh sách chờ ra cổng. | WAITING_FOR_DOCK |
| 3 | Xe vận hành trong kho | (Hệ thống quản lý dock xử lý) | AT_DOCK → LEFT_DOCK |
| 4 | Click 'Rời cổng' | Toast 'Rời cổng thành công!', xe biến khỏi danh sách chờ. | CHECKED_OUT |