Cài đặt app mobile cho tài xế
App Road Freight Driver chạy trên Android (yêu cầu version 7.0+) và iOS (13.0+). Đây là tool chính tài xế dùng hằng ngày.
Cài đặt Android
Cách 1 — File APK (gửi từ admin)
- Admin gửi file
road-freight-driver.apkqua Zalo/email - Tài xế tải về điện thoại
- Mở file → Android hỏi xác nhận cài app từ nguồn lạ
- Vào Cài đặt > Bảo mật > Cho phép từ nguồn này → bật lên
- Quay lại → bấm "Cài đặt"
- Cài xong → mở app
Cách 2 — Google Play Store (khi đã publish)
Tìm "Road Freight Driver" → cài như app thường.
Cài đặt iOS
Hi ện tại app chưa public trên App Store. Cài qua TestFlight:
- Admin thêm Apple ID của tài xế vào TestFlight
- Tài xế nhận email mời
- Mở email → cài app TestFlight → nhận lời mời
- Trong TestFlight, bấm "Cài đặt" trên app Road Freight Driver
Đăng nhập lần đầu
Mở app → màn Đăng nhập:
- Nhập Email + Mật khẩu đã được admin cấp
- Tích "Ghi nhớ đăng nhập" (tuỳ chọn — đỡ phải nhập lại)
- Bấm "ĐĂNG NHẬP"
Ảnh trên minh họa đúng các phần tài xế cần kiểm tra: email, mật khẩu, tùy chọn ghi nhớ đăng nhập và khối quyền bắt buộc.
Admin công ty (qua web) mời tài xế trong Quản trị > Người dùng → tài xế nhận email mời → đặt mật khẩu → mới dùng được.
Cấu hình URL backend (chỉ lần đầu)
Nếu màn đăng nhập báo "Không kết nối được server", có thể URL backend chưa cấu hình. Cách fix:
- Trên màn Login, bấm "⚙️ Cấu hình kết nối" (dưới form)
- Nhập URL backend admin cung cấp (vd
https://tms-cong-ty.com/api) - Bấm "Lưu"
- Quay lại đăng nhập
URL được lưu vĩnh viễn — không cần nhập lại lần sau.
Cấp quyền
Sau khi đăng nhập, app yêu cầu 3 quyền bắt buộc:
| Quyền | Mục đích | Nếu từ chối |
|---|---|---|
| 📍 Vị trí (GPS) — "Luôn luôn" | Cập nhật vị trí khi chạy chuyến | Không nhận được chuyến |
| 📷 Camera | Chụp ảnh POD + sự cố | Không xác nhận giao được |
| 🔔 Thông báo | Nhận chuyến mới, lịch bảo dư ỡng | Bỏ lỡ chuyến |
Android 10+ có 3 mức: "Khi dùng app" / "Luôn luôn" / "Từ chối". Chọn "Luôn luôn" để GPS chạy cả khi app ở nền (tài xế khoá màn hình khi lái xe).
Test kết nối
Sau khi cấp quyền:
- Màn chính hiện danh sách chuyến
- Nếu thấy
Chưa có chuyến nào→ bình thường (admin chưa gán) - Nếu báo "Lỗi kết nối" → kiểm tra:
- WiFi/4G còn không
- URL backend đúng chưa (vào ⚙️ Cấu hình kiểm tra)
- Liên hệ admin xác minh backend đang hoạt động
Lưu ý quan trọng
- Không cho phép tắt app trong background: vào Cài đặt Android > Pin > Optimization > tắt cho "Road Freight Driver" để app duy trì GPS liên tục
- Không xoá cache app: làm mất token đăng nhập, phải login lại
- App không có quảng cáo / theo dõi cá nhân: chỉ dùng GPS cho mục đích công việc
Bước tiếp theo
- Nhận chuyến — Khi admin gán chuyến mới