# TransitOps - Smart Transport Operations Platform: Odoo Hackathon 2026
TransitOps is a comprehensive transport operations platform that digitizes vehicle registries, driver compliance, trip dispatches, maintenance logs, and financial expenses. The platform provides robust operational insights, live telemetry updates, and automated calculations for vehicle ROI and fuel efficiency.
- Vehicle Registry: Complete CRUD controls for vehicles (registration number, model, capacity, odometer, acquisition cost).
- Driver Management: Add and register drivers, tracking safety records and contact details.
- Maintenance Workflow: Send vehicles to the shop for repairs, which automatically marks their status as
In Shopand removes them from dispatch selection.
- Trip Planning: Schedule draft deliveries by choosing source, destination, available vehicles, and drivers.
- Trip Dispatching: Trigger active dispatches, automatically setting vehicle and driver statuses to
On Trip. - Trip Completion: Log actual fuel consumed and final odometer readings to instantly restore asset availability and update odometers.
- License Tracking: Monitor driver compliance, license categories, and expiry dates.
- Suspension Actions: Enforce compliance by suspending unsafe drivers and managing driver safety scores.
- Safety Safeguard: The system automatically blocks dispatches for drivers with expired licenses.
- Fuel Logging: Log fuel refills including liters, fuel costs, and refill dates.
- Expense Ledger: Record custom operating expenses categorized by Tolls, Fuel, Maintenance, or Other.
- Analytics & ROI: Audit vehicle-specific fuel efficiency ratios and return on investment (ROI) metrics.
- Reports Export: Download the unified transaction ledger in standard CSV format.
- React (Vite) - Fast, modern React build toolchain
- Tailwind CSS - Glassmorphism UI layout styling
- Recharts - Dynamic charts for ROI and fuel efficiency metrics
- Lucide React - Vector icons library
- Node.js (Express) - Lightweight, RESTful API framework
- JWT (JsonWebToken) - Secure session authentication
- Bcrypt - Strong password hashing
- Middleware Filters - Role-Based Access Control (RBAC) validation
- PostgreSQL - Relational database enforcing key boundaries
- ACID Transactions - Transactional database commands (
BEGIN; ... COMMIT;) for safe operations transitions
TransitOps-Smart-Transport-Operations-Platform/
├── server/ # Node Express API Source
│ ├── index.js # App mount and database seeder
│ ├── db.js # Pool client configuration
│ ├── middleware.js # RBAC role check filters
│ └── routes/ # API endpoint controllers
│ ├── auth.js # Registration & Login endpoints
│ ├── vehicles.js # Vehicle CRUD endpoints
│ ├── drivers.js # Driver CRUD & Compliance endpoints
│ ├── trips.js # Trips dispatch transaction endpoints
│ ├── maintenance.js # Vehicle maintenance shop endpoints
│ ├── expenses.js # General operating expenses endpoints
│ ├── fuel.js # Dedicated fuel logging endpoints
│ └── reports.js # Analytics metrics endpoints
├── client/ # React frontend source
│ ├── src/
│ │ ├── main.jsx # React app mount
│ │ ├── App.jsx # Dashboard navigation and tab controls
│ │ ├── index.css # Typography and custom glass-card styles
│ │ └── components/ # Modular workspace panels
│ │ ├── Login.jsx # Sign in & strict password validation card
│ │ ├── Dashboard.jsx # Live telemetry monitor and KPIs
│ │ ├── Vehicles.jsx # Vehicles list and creation form
│ │ ├── Drivers.jsx # Drivers registry and safety updates
│ │ ├── Trips.jsx # Trips planner and completion forms
│ │ ├── Maintenance.jsx # Vehicle shop logs
│ │ ├── Expenses.jsx # Fuel logging and ledger forms
│ │ └── Analytics.jsx # Vehicle performance grids and charts
│ ├── vite.config.js # Vite configuration with API routing proxy
│ └── tailwind.config.js # Tailwind utility settings
├── database.sql # PostgreSQL table schemas and constraints
├── README.md # Project documentation
└── mermaidcode.md # Natively compiled Mermaid.js ERD code
- Node.js 18+
- PostgreSQL database named
transitops_db
-
Clone the repository
git clone <repository-url> cd TransitOps-Smart-Transport-Operations-Platform
-
Install dependencies Install core packages for both server and frontend dev layers:
npm install
-
Configure environment variables Create a
.envfile in the root directory:PORT=5000 PGUSER=postgres PGPASSWORD=your_postgres_password PGHOST=localhost PGPORT=5432 PGDATABASE=transitops_db JWT_SECRET=your_jwt_secret_key
-
Initialize database schema Execute the schema creation file in your local PostgreSQL environment:
psql -U postgres -d transitops_db -f database.sql
-
Start the application Run the helper scripts to start the backend Express server and Vite frontend client:
- Start Backend:
npm run server - Start Client:
npm run client
The backend seeder will automatically insert demo accounts and operational logs on its first boot. Open
http://localhost:5173to test. - Start Backend:
- Simulates active vehicle operations logging on the dashboard interface.
- Appends scrolling operations logs every 6 seconds, making the user interface feel alive.
- Monitors profitability (revenue minus fuel and repair bills).
- Visualizes fleet allocation status charts (Pie Charts) and regional distributions (Bar Charts).
- Calculates Return on Investment (ROI) and fuel efficiency metrics automatically.
- Handles lifecycle states:
Draft->Dispatched->CompletedorCancelled. - Enforces strict concurrency control using locks (
SELECT FOR UPDATE) to prevent double-booking. - Validates maximum cargo load limit constraints dynamically on both creation and dispatch boundaries.
- Role-Based Access Control (RBAC): Backend route controllers validate the active JWT user role (
Fleet Manager,Driver,Safety Officer,Financial Analyst) before allowing modifications. - Strict Password Validation: Registering accounts validates password complexity rules on both frontend and backend (requires at least 8 characters, one uppercase letter, one lowercase letter, one number, and one special character).
- Data Validation & Sanitization: Excludes negative financial costs, distance checks, and cargo load weights.