A centralized, rule-based digital hub that optimizes delivery fleet lifecycle, monitors driver safety, and tracks financial performance.
| Layer | Technology |
|---|---|
| Framework | Nuxt 4 (Full-stack) |
| Frontend | Vue 3 + Tailwind CSS |
| Database | SQLite + Prisma ORM |
| Authentication | JWT |
| Language | TypeScript |
- Dashboard - Real-time KPIs (Active Fleet, Maintenance Alerts, Utilization Rate)
- Vehicle Management - CRUD operations with status tracking (Available, On Trip, In Shop, Retired)
- Driver Management - License compliance tracking and safety scores
- Trip Dispatcher - Cargo validation, auto-status updates on dispatch/complete
- Maintenance Logs - Auto vehicle status updates when logging maintenance
- Expense Tracking - Fuel logs and operational costs with summaries
- Analytics - Fuel efficiency charts, cost breakdown, ROI calculations, CSV exports
- RBAC - Role-based access control (Manager, Dispatcher, Safety Officer, Financial Analyst)
- Auth is cookie-based (
HttpOnly,SameSite=Lax,Securein production). - API routes rely on authenticated cookie sessions instead of client-supplied bearer tokens.
- Self-registration is disabled by default; user provisioning should be manager-controlled.
- Driver
ON_TRIPstatus is system-managed by trip dispatch/complete/cancel flows.
# Install dependencies
bun install
# Setup database
bunx prisma generate
bunx prisma db push
bun run seed
# Run development server
bun run devThe default seed data is for local development. Do not use these accounts or passwords in production environments.
| Role | Password | |
|---|---|---|
| Manager | admin@fleetflow.com | password123 |
| Dispatcher | dispatch@fleetflow.com | password123 |
| Safety Officer | safety@fleetflow.com | password123 |
| Financial Analyst | finance@fleetflow.com | password123 |
See docs/ folder for detailed documentation:
- Team Leader: Atulya Rai
- Mentor: Bharat Singh Rathore (@bsra-odoo)
MIT