Hệ thống điều vận đội xe tải

Công nghệ

• Node.js
• TypeScript
• Fastify
• PostgreSQL
• Drizzle ORM
• React
• Vite
• Tailwind CSS
• TanStack Query
• Zod
• Leaflet
• Groq
• GitHub Actions
• Vitest

Xây một nền tảng web (PWA) Node.js/TypeScript + PostgreSQL với 4 vai trò riêng biệt (quản trị, điều phối, tài xế, khách hàng). Đơn hàng có thể nhập tay, do khách tự đặt, hoặc bóc tách tự động từ tin nhắn đặt xe viết tay bằng AI. Xe được gợi ý theo thuật toán chấm điểm nhiều tiêu chí thay vì chỉ lọc xe rảnh, vị trí đội xe đồng bộ gần thời gian thực từ một dịch vụ định vị GPS bên thứ ba, và mọi chuyển trạng thái đơn/chuyến đều đi qua một tầng nghiệp vụ tập trung để đảm bảo đúng luật nghiệp vụ thay vì client tự ý cập nhật. Lược đồ CSDL được tự thiết kế lại từ đầu, ràng buộc chặt ở tầng dữ liệu, quản lý qua migration có phiên bản. Triển khai production có HTTPS, dựng CI/CD tự động cho hai môi trường tách biệt.

• Luồng nghiệp vụ chính (tạo đơn → gợi ý xe → gán chuyến/ghép chuyến → tài xế cập nhật → duyệt chi phí → vào lương) đã chạy đầu-cuối trên dữ liệu thật.

• Toàn bộ dữ liệu đơn hàng và chi phí cũ được chuẩn hóa và chuyển sang hệ thống mới, không còn phụ thuộc bảng tính thủ công.

Điểm nổi bật

• Thuật toán gợi ý xe chấm điểm sáu tiêu chí (khoảng cách rỗng, lộ trình, giờ hẹn, độ lấp đầy, sức chứa còn lại, khung giờ giao) viết thành hàm thuần tách khỏi CSDL — dễ viết test và điều chỉnh trọng số, và cố ý không loại xe đang chạy khỏi danh sách gợi ý, chỉ dựa vào sức chứa còn trống.

• Bóc tách đơn hàng bằng AI từ tin nhắn viết tay, với lớp validate riêng cho từng trường và không cho phép mô hình tự suy đoán số tiền khi tin không ghi rõ; luật cứng bằng biểu thức cố định làm lưới dự phòng khi thiếu khoá hoặc AI gọi lỗi.

• Máy trạng thái tập trung cho ba lớp thực thể (đơn hàng, chuyến chạy, dòng ghép trong chuyến) — mọi chuyển trạng thái đi qua một tầng nghiệp vụ duy nhất, chặn cập nhật thẳng từ phía client.

• Ảnh giao nhận được đóng dấu vị trí/thời gian và resize/nén ở phía máy chủ (không phải trình duyệt) để không thể bị chỉnh sửa qua công cụ dev, kèm suy địa chỉ chữ từ toạ độ có xếp hàng và cache để tôn trọng giới hạn của dịch vụ bản đồ miễn phí.