Điều phối Dock
Nhân viên điều phối kho (Warehouse Dispatcher)
I. Tổng quan
Trang Điều phối Dock là công cụ dành cho nhân viên điều phối kho quản lý toàn bộ vòng đời vận hành xe trong khu vực dock. Các nghiệp vụ chính gồm:
- Theo dõi luồng xe qua 4 cột trạng thái: Danh sách chờ → Chuẩn bị gọi → Đang gọi vào dock → Tại dock.
- Gọi xe vào dock bằng loa và thông báo App Driver tự động.
- Điều phối ưu tiên xe, đổi dock khi có sự cố.
- Xác nhận xe vào dock và rời dock.
- Theo dõi thống kê tổng quan và tra cứu đăng ký nhanh.
Tài liệu này dành cho nhân viên điều phối kho (Warehouse Dispatcher). Không áp dụng cho bảo vệ kho hoặc tài xế.
Màn hình Điều phối Dock
II. Giao diện và bố cục trang
2.1. Khu vực thống kê tổng quan
Phía trên trang hiển th ị 3 chỉ số thời gian thực:
| Chỉ số | Ý nghĩa |
|---|---|
| Đang chờ | Tổng xe đã vào cổng (WAITING_FOR_DOCK), chờ được điều phối vào dock. |
| Trễ | Xe đã quá giờ slot nhưng chưa vào dock, hoặc xe đang trong dock quá giờ kết thúc slot. |
| Đang thực hiện | Tổng xe đang tại dock (AT_DOCK). |
2.2. Luồng trạng thái 4 cột
Mỗi land dock hiển thị 4 cột theo luồng vận hành từ trái sang phải:
| Danh sách chờ | Chuẩn bị gọi | Đang gọi vào dock | Tại dock |
|---|---|---|---|
CHECK_IN_CONFIRMED / DOCK_CALL_DELAYED | PREPARING | DOCK_CALLED | ENTER_DOCK |
Xe di chuyển từ trái sang phải: Chờ → Chuẩn bị → Gọi vào → Tại dock. Điều phối có thể can thiệp ở bất kỳ bước nào.
2.3. Land dock
Mỗi dock trong kho hiển thị thành 1 land dock riêng. Thanh trạng thái land dock:
- Màu đỏ: Dock đang có xe (≥1 card đăng ký đang hiển thị trong land).
- Màu xanh: Dock trống, không có xe đang xử lý.
Bạn có thể kéo thả để sắp xếp lại thứ tự các land dock theo ý muốn — hệ thống lưu thứ tự theo từng nhân viên.
2.4. Card đăng ký
Mỗi xe được thể hiện bằng 1 card, hiển thị: biển số xe, khung giờ, tên dock, STT hàng đợi. Icon card chuyển màu đỏ khi xe trễ giờ. Hover vào card để xem thêm: ID đăng ký, loại xe, số phút trễ.
III. Luồng vận hành chuẩn
Quy trình xử lý một xe qua toàn bộ vòng đời tại dock:
| Bước | Thao tác |
|---|---|
| 1. Xe vào cổng | Bảo vệ check-in → Xe xuất hiện trong cột 'Danh sách chờ' (trạng thái WAITING_FOR_DOCK). |
| 2. Hệ thống tự chọn | Hệ thống tự động đưa xe có STT nhỏ nhất vào cột 'Chuẩn bị gọi' của land dock tương ứng. |
| 3. Gọi vào dock | Điều phối click 'Gọi vào' → Loa phát tên xe + dock, App Driver tài xế nhận thông báo. |
| 4. Xác nhận vào dock | Điều phối click 'Vào dock' sau khi xe thực sự vào dock. |
| 5. Xe hoàn thành | Điều phối click 'Rời dock' khi xe hoàn tất vận hành trong dock. |
| 6. Xe rời cổng | Bảo vệ thực hiện check-out → Xe hoàn tất vòng đời. |
IV. Gọi xe vào dock
4.1. Hệ thống tự động chọn xe vào 'Chuẩn bị gọi'
Khi reload trang hoặc click 'Gọi vào', hệ thống tự động chọn xe ưu tiên vào cột 'Chuẩn bị gọi' theo tiêu chí:
- Xe có trạng thái
CHECK_IN_CONFIRMEDhoặcDOCK_CALL_DELAYED. - Có STT hàng đợi nhỏ nhất trong dock đó.
- Dock chưa có xe nào đang ở trạng thái
PREPARING.
Bạn không cần thao tác thủ công để đưa xe vào 'Chuẩn bị gọi' — hệ thống tự xử lý. Chỉ can thiệp khi cần ưu tiên hoặc đổi dock.
4.2. Gọi xe vào dock
| Bước | Thao tác |
|---|---|
| 1. Kiểm tra xe | Xác nhận xe trong cột 'Chuẩn bị gọi' là xe cần gọi tiếp theo. |
| 2. Click 'Gọi vào' | Nhấn button 'Gọi vào' trên card đăng ký. |
| 3. Loa phát | Loa tự động phát: "Mời xe có biển số [XXX] vào dock [Tên dock]" |
| 4. App Driver | Tài xế nhận thông báo: "Đăng ký [ID], mời xe bạn vào dock [Tên dock]" |
| 5. Card chuyển cột | Card di chuyển sang cột 'Đang gọi vào dock'. |
Nếu cần phát lại thông báo loa mà không tạo event mới, click icon Loa trên land dock. Thao tác này chỉ gửi lại audio, không thay đổi trạng thái đăng ký.
4.3. Xác nhận xe vào dock
| Bước | Thao tác |
|---|---|
| 1. Xe đến dock | Xác nhận xe thực tế đã đến và vào dock. |
| 2. Click 'Vào dock' | Nhấn button 'Vào dock' trên card ở cột 'Đang gọi vào dock'. |
| 3. Xác nhận | Card chuyển sang cột 'Tại dock', trạng thái → AT_DOCK. |
4.4. Xác nhận xe rời dock
| Bước | Thao tác |
|---|---|
| 1. Xe hoàn tất | Xe hoàn thành vận hành trong dock. |
| 2. Click 'Rời dock' | Nhấn button 'Rời dock' trên card ở cột 'Tại dock'. |
| 3. Hoàn tất | Card biến khỏi land dock, trạng thái → LEFT_DOCK. |
V. Điều phối ưu tiên và đổi dock
Điều phối có thể can thiệp thủ công khi cần xử lý ngoại lệ. Có 3 tình huống:
Tình huống 1: Ưu tiên xe — KHÔNG đổi dock
Khi muốn đưa một xe lên trước xe đang ở 'Chuẩn bị gọi', trong cùng dock đó.
| Thao tác | Mô tả |
|---|---|
| Cách 1 | Click button 'Ưu tiên' (icon mũi tên cam ↑) trên card ở cột 'Danh sách chờ'. |
| Cách 2 | Kéo card từ 'Danh sách chờ' vào đúng land dock ở cột 'Chuẩn bị gọi'. |
Pop-up xác nhận hiển thị: "Bạn muốn ưu tiên STT [X] trư ớc STT [Y]?" → Click Xác nhận để thực hiện | Click Huỷ để bỏ qua.
Sau khi xác nhận: Xe bị thay thế trở về 'Danh sách chờ', xe được ưu tiên lên 'Chuẩn bị gọi'. Toast: 'Thực hiện ưu tiên thành công!'
Tình huống 2: Ưu tiên xe + Đổi sang dock khác
Khi muốn vừa ưu tiên xe, vừa chuyển xe đó sang dock khác (dock mới chưa có xe đang 'Chuẩn bị gọi').
| Thao tác | Mô tả |
|---|---|
| Cách 1 | Kéo card từ 'Chuẩn bị gọi' sang land dock khác. |
| Cách 2 | Kéo card từ 'Danh sách chờ' vào cột 'Chuẩn bị gọi' của land dock khác. |
Pop-up xác nhận: "Bạn muốn đổi STT [X] sang dock [Tên dock mới] và ưu tiên STT [X] trước STT [Y]?"
Sau khi xác nhận: Hệ thống log event DOCK_CHANGED + PREPARING. Toast: 'Thực hiện ưu tiên và đổi dock thành công!'
Việc đổi dock chỉ ghi nhận event vận hành (log), không cập nhật dock gốc trong lịch đăng ký ban đầu. Dock gốc vẫn giữ nguyên trong hồ sơ đăng ký.
Tình huống 3: Đổi dock — KHÔNG thay đổi ưu tiên
Khi dock đang 'Chuẩn bị gọi' có sự cố và cần chuyển xe sang dock trống khác.
| Thao tác | Mô tả |
|---|---|
| Thao tác | Kéo card đang ở cột 'Chuẩn bị gọi' sang land dock khác còn trống (chưa có xe PREPARING). |
Pop-up xác nhận: "Bạn muốn đổi STT [X] sang dock [Tên dock mới]?"
Sau khi xác nhận: Hệ thống log event DOCK_CHANGED. Xe vẫn ở cột 'Chuẩn bị gọi' nhưng tại land dock mới.
VI. Huỷ ưu tiên và đưa xe về danh sách chờ
6.1. Huỷ ưu tiên xe đang ở 'Chuẩn bị gọi'
Áp dụng khi xe đã được ưu tiên thủ công (queue_priority_level = 1) và cần hoàn tác.
| Thao tác | Mô tả |
|---|---|
| Cách 1 | Click button 'Trở về' (icon mũi tên xanh ←) trên card ở cột 'Chuẩn bị gọi'. |
| Cách 2 | Kéo card từ 'Chuẩn bị gọi' về 'Danh sách chờ'. |
Pop-up xác nhận: "Bạn muốn chuyển STT [X] về danh sách chờ?"
Sau khi xác nhận: Xe trở về 'Danh sách chờ', hệ thống tự động chọn xe tiếp theo theo thứ tự. Toast: 'Thực hiện thành công!'
6.2. Đưa xe về danh sách chờ từ 'Đang gọi vào dock'
Áp dụng khi xe đã được gọi nhưng chưa vào dock, cần hoàn lại hàng chờ.
| Thao tác | Mô tả |
|---|---|
| Thao tác | Click button 'Trở về' (icon mũi tên xanh ←) trên card ở cột 'Đang gọi vào dock'. |
Pop-up xác nhận: "Bạn muốn chuyển STT [X] về danh sách chờ?"
Sau khi xác nhận: Xe trở về 'Danh sách chờ', hệ thống tự chọn xe tiếp theo. Toast: 'Thực hiện thành công!'
VII. Tìm kiếm đăng ký
Nhập từ khoá vào ô tìm kiếm rồi nhấn Enter. Hệ thống tìm theo:
- ID đăng ký (
dock_appointment_id) — cần nhập chính xác toàn bộ giá trị. - Biển số xe — cần nhập chính xác toàn bộ giá trị.
- Tìm thấy: Card đăng ký được highlight bằng viền đỏ trong land dock.
- Không tìm thấy: Không hiển thị viền đỏ, kiểm tra lại từ khoá.
- Xoá từ khoá: Tất cả card hiển thị lại theo mặc định.
VIII. Xử lý thông báo lỗi
| Thông báo lỗi | Nguyên nhân | Hành động |
|---|---|---|
| Không thể thực hiện. Vui lòng làm trống slot! | Dock đích đã có xe khác đang ở trạng thái PREPARING hoặc đã được ưu tiên thủ công. | Đợi xe hiện tại được gọi vào dock, hoặc huỷ ưu tiên xe đó trước rồi thử lại. |
| Không thể thực hiện! | Điều kiện validate không hợp lệ (sai trạng thái, xe không đủ điều kiện). | Kiểm tra lại trạng thái xe trong card, reload trang nếu cần. |
| Lỗi hệ thống (toast đỏ) | Sự cố kỹ thuật phía server. | Thử lại sau vài giây, nếu vẫn lỗi liên hệ bộ phận kỹ thuật. |
IX. Thông báo tài xế trên App Driver
Khi điều phối click 'Gọi vào', hệ thống tự động gửi thông báo đến App Driver của tài xế:
| Kênh | Nội dung |
|---|---|
| Loa kho | "Mời xe có biển số [Biển số] vào dock [Tên dock]" |
| Thông báo App Driver (popup) | "Đăng ký [ID đăng ký], mời xe bạn vào dock [Tên dock]" |
| Mục thông báo App Driver | Hiển thị trong danh sách thông báo, click vào → mở Chi tiết đăng ký. |
X. Tóm tắt các button và thao tác
| Button | Vị trí | Tác dụng |
|---|---|---|
| Ưu tiên (↑ cam) | Danh sách chờ | Đưa xe lên 'Chuẩn bị gọi' với ưu tiên cao hơn xe hiện tại. |
| Gọi vào | Chuẩn bị gọi | Phát loa + gửi thông báo app, chuyển sang 'Đang gọi vào dock'. |
| Trở về (← xanh) | Chuẩn bị gọi / Đang gọi | Đưa xe trở lại 'Danh sách chờ'. |
| Vào dock | Đang gọi vào dock | Xác nhận xe đã vào dock, chuyển sang 'Tại dock'. |
| Rời dock | Tại dock | Xác nhận xe đã rời dock, kết thúc vận hành tại dock. |
| Loa (icon) | Land dock | Phát lại thông báo loa mà không tạo event mới. |
| Reload (icon) | Danh sách chờ | Làm mới danh sách, hệ thống tự chọn lại xe ưu tiên. |