Product deep dive
Kiến trúc & modules của FleetOS – góc nhìn BA / Dev / Solution
Trang này dành cho đội nội bộ & đối tác kỹ thuật: Business Analyst, Product Owner, Solution Architect, Dev backend/frontend, AI Engineer, QA. Mục tiêu: có cùng “bản đồ chung” về các module và luồng dữ liệu của FleetOS.
Module map
Domain model
API surface
Roadmap
Module map
Các domain chính trong FleetOS
| Domain | Modules chính | Vai trò |
|---|---|---|
| FMS (Fleet) | Vehicle, Device, Trip, Event, Geofence | Quản lý xe, thiết bị, hành trình và sự kiện. |
| TMS | Order, Shipment, TripAssignment, RoutePlan | Kết nối đơn hàng với chuyến, tuyến, tài xế. |
| Cost & Finance | CostDetail, Tariff, Invoice, Settlement | Tính chi phí, bảng kê, lãi/lỗ. |
| Driver & Safety | Driver, BehaviorEvent, DriverScore | Quản lý tài xế & an toàn. |
| Customer & Zalo OA | Customer, Contact, Notification, OAChannel | Tương tác khách hàng & tài xế. |
| AI & Analytics | TripIntel, RouteAI, CostAI, ScoreAI | Model & pipeline AI. |
Core flows
3 luồng nghiệp vụ cốt lõi cần triển khai
Luồng 1 – Đơn hàng → chuyến → bảng kê
- BA mô tả quy trình hiện tại (AS-IS): nhận đơn, xếp chuyến, giao tài xế, lập bảng kê.
- Thiết kế TO-BE với FleetOS: Order → Trip → CostDetail → Invoice.
- Dev backend build API: tạo đơn, gán xe/tài xế, finalize chuyến, sinh bảng kê.
Luồng 2 – Hành trình → Trip → Driver Score
- Device gửi data → Gateway → Trip segmentation.
- BehaviorEvent (phanh, tăng tốc, overspeed) → DriverScore.
- App hiển thị scoreboard cho điều độ & quản lý.
Luồng 3 – Cảnh báo & AI gợi ý
- Cảnh báo realtime: overspeed, dừng lâu, lệch tuyến.
- Daily digest: top tài xế/tuyến rủi ro, đề xuất hành động.
- Task engine: tạo “công việc” cho điều độ & quản lý.
Gợi ý cho BA & Dev
- Tách rõ domain: FMS / TMS / Cost / Driver / AI.
- Ưu tiên build luồng end-to-end nhỏ, nhưng hoàn chỉnh.
- Gắn Acceptance Criteria theo góc nhìn business, không chỉ theo API.
API surface (high-level)
Các nhóm API chính
FMS / Trip API
- GET /vehicles, GET /vehicles/{id}
- GET /trips?vehicle_id=&from=&to=
- GET /trips/{id}
- POST /trips/resegment (trigger AI Trip Intelligence)
TMS / Order API
- POST /orders (tạo đơn hàng)
- POST /orders/{id}/assign-trip
- GET /orders/{id}/statement (bảng kê)
- POST /orders/{id}/close
Driver & Score API
- GET /drivers, GET /drivers/{id}
- GET /drivers/{id}/score
- GET /drivers/scoreboard?from=&to=
Cost & Finance API
- GET /trips/{id}/cost
- POST /trips/{id}/cost/recalculate
- GET /analytics/profit-by-route
Roadmap nội bộ
Gợi ý roadmap triển khai (technical)
Phase 1 – Nền tảng
- Hoàn thiện Device → Gateway → Trip (FMS).
- Trip segmentation & Driver behavior cơ bản.
- BI tối thiểu: số chuyến, km, tốc độ trung bình.
Phase 2 – TMS & Cost
- Đơn hàng, chuyến, bảng kê.
- Cost Engine cơ bản (km, nhiên liệu, BOT).
- Driver Score 0–100 cơ bản.
Phase 3 – AI nâng cao & Automation
- AI Route Optimization.
- Daily/Weekly AI Supervisor.
- Tự động tạo tasks & workflow.
Phase 4 – Ecosystem & Partner
- API cho đối tác (khách hàng lớn, 3PL, chủ hàng).
- Marketplace cho modules, tích hợp thêm.
- SDK/Docs cho developer bên ngoài.