Quản lý nhiên liệu (Fuel)

Theo dõi tiêu thụ xăng dầu per xe, per chuyến — tự động chảy vào chi phí lô hàng. Route: /fleet/fuel.

Tổng quan

Fuel Module theo dõi mọi lần đổ xăng và liên kết với chuyến (Trip) → Shipment → Debit Note tự động:

Luồng dữ liệu:

FuelLog → Trip.fuelCost → Shipment.tripCosts → P&L lô hàng → Debit Note

Không cần nhập tay chi phí xăng vào Finance — hệ thống tự tính khi Trip DELIVERED.

KPI nhiên liệu workspace:

Chỉ số	Ví dụ	Ý nghĩa
Tổng chi xăng tháng	45.200.000 ₫	Tổng FuelLog.totalCost tháng này
Tiêu hao trung bình	28 lít/100km	So sánh giữa các xe
Xe tiêu hao cao nhất	29-A1 234 (35 lít/100km)	Cần kiểm tra động cơ
Cảnh báo vượt định mức	3 xe	Đã vượt ngưỡng tháng này

🔍

Dashboard Fuel — KPI tiêu thụ và cảnh báo vượt định mức

Ghi nhận đổ xăng

Tạo FuelLog:

1. Vào /fleet/fuel → + Ghi nhận đổ xăng (hoặc từ app mobile tài xế)
2. Điền:

Trường	Mô tả
Xe	Chọn biển số
Chuyến (Trip)	Liên kết chuyến đang chạy (nếu có)
Ngày giờ	Thời điểm đổ xăng
Trạm xăng	Tên trạm, địa chỉ
Số lít	Lít thực tế đổ
Đơn giá / lít	Giá tại thời điểm đổ (₫/lít)
Tổng tiền	Tự tính = Số lít × Đơn giá
Odo (km)	Số km đồng hồ tại thời điểm đổ
Upload hóa đơn	Ảnh hóa đơn xăng (OCR tự điền trường)

3. Lưu → FuelLog ghi nhận, nếu có Trip liên kết → Trip.fuelCost cập nhật ngay

Upload ảnh hóa đơn

Chụp ảnh hóa đơn xăng → AI OCR tự điền số lít, đơn giá, tổng tiền, tên trạm. Tài xế chỉ cần chọn xe và liên kết chuyến.

🔍

Form ghi nhận đổ xăng — upload ảnh hóa đơn để AI tự điền

Định mức & cảnh báo

Đặt định mức tiêu hao per xe:

1. Vào chi tiết xe trong Fleet → trường Định mức xăng (lít/100km)
2. Nhập định mức dựa trên thông số kỹ thuật + điều kiện vận hành thực tế
3. Hệ thống so sánh thực tế vs định mức theo tháng

Ngưỡng cảnh báo:

Mức vượt	Hành động
> 10% định mức	Cảnh báo vàng trên dashboard
> 20% định mức	Telegram alert OPS + OWNER
> 30% định mức	Yêu cầu giải trình (tài xế nhập lý do)

Vượt định mức liên tục

Xe vượt định mức > 20% liên tục 3 tháng → đề xuất kiểm tra kỹ thuật động cơ, lốp xe. Có thể có rò rỉ nhiên liệu hoặc tài xế gian lận.

Báo cáo tiêu thụ

Báo cáo per xe theo kỳ:

Trường	Mô tả
Tổng km	Tổng kilométer trong kỳ
Tổng lít	Tổng nhiên liệu tiêu thụ
Lít/100km	Tiêu hao thực tế
Định mức	Lít/100km theo cài đặt
Chênh lệch	Thực tế - Định mức
Tổng chi phí	Tổng FuelLog.totalCost

Biểu đồ xu hướng:

So sánh tiêu hao theo tháng — phát hiện bất thường (tăng đột biến tháng nào, xe nào).

Export:

• Excel chi tiết từng FuelLog
• PDF báo cáo tổng hợp per xe / per tài xế
• CSV để import vào phần mềm kế toán

Luồng tài chính: Xăng → P&L

Chuỗi dữ liệu đầy đủ từ đổ xăng đến P&L lô hàng:

FuelLog (đổ xăng)
    → liên kết Trip
    → Trip.fuelCost = tổng FuelLog trong Trip
    → khi Trip DELIVERED:
        → Debit Note DRAFT tạo tự động
        → Debit Note.lines = [xăng, cầu đường, phụ cấp, cước nhà xe]
    → Debit Note liên kết Shipment
    → Shipment P&L = revenue - sum(Debit Note costs)

Mỗi bước đều có audit trail — từ hóa đơn xăng đến dòng P&L cuối cùng có thể drill-down.

Ghi nhận nhiên liệu theo chuyến TRUCKER

Với chuyến thuê nhà xe ngoài (TRUCKER), không có FuelLog nội bộ. Thay vào đó:

• Chi phí xăng được tính gộp vào Trip.vendorCost (cước nhà xe bao gồm xăng)
• Hoặc nhà xe gửi hóa đơn xăng riêng → upload FUEL_RECEIPT → AI extract → tạo FuelLog ngoại bộ
• FuelLog ngoại bộ có flag isExternal = true — không tính vào định mức nội bộ

Fuel Module — deferred features

Một số tính năng fuel đang trong lộ trình phát triển (Đợt 1):

• Tích hợp trực tiếp với thẻ xăng điện tử (PV Oil, Shell Fleet)
• So sánh giá xăng theo trạm/khu vực
• Dự báo chi phí xăng theo lịch chuyến tương lai