📚 Hướng dẫn sử dụng hệ thống LepusDMS

LepusDMS (Lepus Delivery Management System) là hệ thống quản lý giao hàng với các tính năng:

  • Quản lý đơn hàng và theo dõi trạng thái
  • Đồng bộ đơn hàng từ Odoo ERP
  • Theo dõi vị trí tài xế realtime
  • Quản lý thu hộ COD và công nợ
  • Thông báo qua browser notification
🌐 URL truy cập: https://delivery.mygear.vn

2. Đăng nhập hệ thống

2.1. Màn hình đăng nhập

Thành phần Mô tả
Email Nhập email đã đăng ký
Mật khẩu Nhập mật khẩu (có thể bấm icon 👁 để hiện/ẩn)
Nút "Đăng nhập" Bấm để đăng nhập
Link "Đăng ký" Chỉ hiển thị khi hệ thống cho phép đăng ký

2.2. Các bước đăng nhập

  1. Mở trình duyệt và truy cập https://delivery.mygear.vn
  2. Nhập Email vào ô "Email"
  3. Nhập Mật khẩu vào ô "Mật khẩu"
  4. Bấm nút "Đăng nhập"
  5. Hệ thống sẽ chuyển đến Dashboard phù hợp với vai trò

2.3. Lỗi thường gặp khi đăng nhập

Lỗi Nguyên nhân Cách xử lý
"Email hoặc mật khẩu không đúng" Sai thông tin đăng nhập Kiểm tra lại email và mật khẩu
"Tài khoản đã bị khóa" Tài khoản bị vô hiệu hóa Liên hệ Admin để mở khóa
Trang không load Mất kết nối mạng Kiểm tra internet, thử reload trang

3. Vai trò người dùng

3.1. Các vai trò trong hệ thống

Vai trò Quyền hạn
ADMIN Toàn quyền: quản lý người dùng, cài đặt hệ thống, tất cả đơn hàng
MANAGER Quản lý vận hành: quản lý đơn hàng, tài xế, kho hàng (không có cài đặt hệ thống)
SHIPPER Tài xế: nhận đơn, cập nhật trạng thái, xem đơn được giao

3.2. Menu theo vai trò

Admin/Manager:

  • Dashboard
  • Đơn hàng
  • Tài xế
  • Kho hàng
  • Người dùng (chỉ Admin)
  • Cài đặt (chỉ Admin)

Shipper:

  • Dashboard (danh sách đơn được giao)
  • Chi tiết đơn hàng

4. Dashboard Tài xế

4.1. Giao diện Dashboard Tài xế

Sau khi đăng nhập với tài khoản Shipper, bạn sẽ thấy:

Header:

  • Tên tài xế
  • Nút Trực tuyến/Ngoại tuyến (Switch)

Thống kê:

  • Số đơn Chờ lấy hàng
  • Số đơn Đang giao
  • Số đơn Đã giao hôm nay

4.2. Bật/Tắt trạng thái Trực tuyến

  1. Tìm switch "Trực tuyến" ở góc phải header
  2. Bật (màu xanh): Bạn sẵn sàng nhận đơn mới
  3. Tắt (màu xám): Bạn không nhận đơn mới
⚠️ Lưu ý: Khi tắt trạng thái trực tuyến, Admin vẫn có thể giao đơn cho bạn.

4.3. Xem và cập nhật đơn hàng

  1. Bấm vào đơn hàng trong danh sách
  2. Xem chi tiết đơn hàng (địa chỉ, số điện thoại, tiền COD)
  3. Cập nhật trạng thái: Đã lấy hàng → Đang giao → Đã giao

5. Dashboard Admin/Manager

URL: /admin/dashboard

5.1. Thống kê tổng quan

Thẻ Mô tả
Tổng đơn hàng Số đơn trong hệ thống
Đang chờ xử lý Đơn chưa được giao cho tài xế
Đang giao Đơn đang trong quá trình giao
Đã hoàn thành Đơn đã giao thành công

5.2. Menu điều hướng

Menu Đường dẫn Mô tả
Dashboard /admin/dashboard Tổng quan hệ thống
Đơn hàng /admin/orders Quản lý tất cả đơn hàng
Tài xế /admin/shippers Quản lý tài xế
Kho hàng /admin/warehouses Quản lý kho/điểm lấy hàng
Người dùng /admin/users Quản lý tài khoản (Admin only)
Cài đặt /admin/settings Cấu hình hệ thống (Admin only)

6. Quản lý đơn hàng

URL: /admin/orders

6.1. Các trạng thái đơn hàng

Trạng thái Badge Mô tả
PENDING Chờ xử lý Chờ xử lý, chưa giao tài xế
ASSIGNED Đã giao Đã giao cho tài xế
PICKED_UP Đã lấy hàng Tài xế đã lấy hàng
IN_TRANSIT Đang giao Đang trên đường giao
DELIVERED Đã giao Đã giao thành công
CANCELLED Đã hủy Đã hủy
FAILED Thất bại Giao thất bại

6.2. Các thao tác với đơn hàng

Bấm menu ⋮ ở cột Thao tác:

Thao tác Mô tả
Xem chi tiết Mở trang chi tiết đơn hàng
Chỉnh sửa Mở dialog sửa thông tin
Giao tài xế Chọn tài xế để giao đơn
Xóa Xóa đơn hàng (cần xác nhận)

6.3. Giao đơn cho tài xế

  1. Bấm menu ⋮ → "Giao tài xế"
  2. Dialog hiện ra với danh sách tài xế
  3. Chọn tài xế từ dropdown (chỉ hiển thị tài xế đang online)
  4. Bấm "Xác nhận"
  5. Đơn hàng chuyển sang trạng thái ASSIGNED
💡 Mẹo: Có thể giao lại đơn cho tài xế khác khi đơn ở trạng thái ASSIGNED.

7. Tạo đơn hàng mới

URL: /admin/orders/create

7.1. Có 2 cách tạo đơn

  1. Đồng bộ từ Odoo (khuyến nghị)
  2. Nhập thủ công

7.2. Đồng bộ từ Odoo

  1. Chọn tab "Odoo trực tiếp"
  2. Nhập mã đơn Odoo (VD: S20087) và bấm "Đồng bộ Odoo"
  3. Kiểm tra thông tin tự động điền
  4. Chọn kho lấy hàng (tùy chọn)
  5. Phân công tài xế (tùy chọn)
  6. Bấm "Tạo đơn hàng"

7.3. Phương thức thanh toán

Phương thức Mô tả
Tiền mặt (CASH) Thu tiền khi giao hàng
Chuyển khoản (BANK_TRANSFER) Khách đã chuyển khoản
MoMo Thanh toán qua MoMo
ZaloPay Thanh toán qua ZaloPay
Công nợ (DEBT) Không thu tiền, ghi công nợ
📝 Lưu ý về Công nợ: Khi chọn "Công nợ", hệ thống hiển thị "Giá trị đơn hàng" thay vì "Tiền thu hộ" và tài xế không cần thu tiền.

8. Chi tiết đơn hàng

URL: /orders/[id]

8.1. Thông tin hiển thị

  • Header: Mã đơn, trạng thái, phương thức thanh toán
  • Thông tin khách hàng: Tên, SĐT (bấm để gọi), địa chỉ giao
  • Thông tin thanh toán: Tiền COD, QR code, trạng thái thanh toán
  • Thông tin hàng hóa: Số kiện, khối lượng, mô tả

8.2. Hiển thị theo phương thức thanh toán

Đơn COD (Tiền mặt):

  • Hiển thị số tiền cần thu (màu xanh lá)
  • QR code để khách thanh toán
  • Sau khi thu: hiển thị "ĐÃ THANH TOÁN"

Đơn Công nợ (DEBT):

  • Hiển thị box màu tím "CÔNG NỢ"
  • Ghi chú "Không cần thu tiền"
  • Không hiển thị QR code

9. Quản lý tài xế

URL: /admin/shippers

9.1. Thêm tài xế mới

  1. Bấm nút "Thêm tài xế"
  2. Điền thông tin: Tên, Email, SĐT, Mật khẩu, Loại xe, Biển số
  3. Bấm "Tạo tài xế"

10. Quản lý kho hàng

URL: /admin/warehouses

10.1. Thêm kho mới

  1. Bấm "Thêm kho"
  2. Điền: Tên kho, Mã Odoo (nếu có), Địa chỉ
  3. Bấm "Tạo kho"

10.2. Sử dụng kho khi tạo đơn

Khi tạo đơn hàng, chọn kho từ dropdown → Địa chỉ lấy hàng tự động điền.

11. Cài đặt hệ thống

URL: /admin/settings

⚠️ Lưu ý: Chỉ Admin mới có quyền truy cập.
Cài đặt Mô tả
Tắt đăng ký Không cho phép người dùng tự đăng ký
Tên công ty Hiển thị trên header
Logo Upload logo công ty

12. Tracking công khai

12.1. URL Tracking

Mỗi đơn hàng có URL tracking riêng:

https://delivery.mygear.vn/tracking/[trackingId]

12.2. Thông tin hiển thị cho khách

  • Trạng thái đơn hàng
  • Vị trí tài xế trên bản đồ (realtime)
  • Thông tin liên hệ tài xế
  • Timeline giao hàng

13. Xử lý lỗi thường gặp

13.1. Lỗi đăng nhập

Vấn đề Giải pháp
Quên mật khẩu Liên hệ Admin để reset
Tài khoản bị khóa Liên hệ Admin để mở khóa
Đăng nhập xong bị đá ra Xóa cache trình duyệt, đăng nhập lại

13.2. Lỗi đồng bộ Odoo

Vấn đề Giải pháp
"Không tìm thấy đơn hàng" Kiểm tra mã đơn, bỏ khoảng trắng
Tiền COD = 0 Có thể là đơn công nợ
Thiếu địa chỉ giao hàng Kiểm tra partner_shipping_id trên Odoo

13.3. Lỗi hiển thị

Vấn đề Giải pháp
Trang trắng Refresh (F5) hoặc Ctrl+Shift+R
Dữ liệu không cập nhật Bấm nút "Làm mới" hoặc refresh trang
Bản đồ không hiển thị Kiểm tra kết nối mạng, cho phép location

Phụ lục: Phím tắt và mẹo

Phím tắt trình duyệt

  • F5: Refresh trang
  • Ctrl+Shift+R: Refresh và xóa cache
  • Ctrl+F: Tìm kiếm trên trang

Mẹo sử dụng

  1. Đồng bộ nhanh: Copy mã đơn từ Odoo, paste vào ô tìm kiếm
  2. Gọi điện nhanh: Bấm vào số điện thoại trên mobile
  3. Xem bản đồ: Bấm vào địa chỉ để mở Google Maps

Liên hệ hỗ trợ

  • Email: support@mygear.vn
  • Hotline: 1900-xxxx
  • Zalo OA: MyGear Support

Tài liệu được cập nhật lần cuối: 25/11/2024 | Phiên bản: 1.0