TransitOps - Fleet Management System

TransitOps is a comprehensive, full-stack logistics and fleet management platform designed to streamline the operations of transport and logistics companies. It provides tools for managing vehicles, drivers, trips, fuel consumption, maintenance, and expenses, all within a role-based access control system.

🌟 Key Features

• Fleet Management: Track vehicle status, details, capacity, and cost.
• Driver Management: Monitor driver statuses, safety scores, licenses, and contact information.
• Trip Tracking: Create, dispatch, and track trips from source to destination with real-time status updates.
• Fuel & Expense Tracking: Log fuel consumption and trip-related expenses (maintenance, toll, others) to calculate operating costs.
• Maintenance Records: Schedule and track vehicle maintenance (routine, oil changes, brake service, etc.).
• Role-Based Access Control (RBAC): Secure access with distinct roles (ADMIN, DRIVER, FLEET_MANAGER, DISPATCHER, SAFETY_OFFICER, FINANCIAL_ANALYST) and granular permissions.
• Company Multi-tenancy: Designed to support organizational structures and company-specific configurations.

---

🏗 System Architecture

The application is built on a modern stack featuring a Next.js frontend and an Express.js backend powered by Prisma and PostgreSQL.

graph TD
    Client[Web Browser] -->|HTTP / REST API| NextJS[Next.js Frontend]
    NextJS -->|API Requests| Express[Express.js API Backend]
    Express -->|Prisma Client Queries| Prisma[Prisma ORM]
    Prisma -->|SQL Queries| Postgres[(PostgreSQL Database)]

    subgraph Frontend [Frontend - Next.js App Router]
        NextJS
        Tailwind[Tailwind CSS]
        Lucide[Lucide Icons]
    end

    subgraph Backend [Backend - Express API]
        Express
        Auth[Auth Middleware JWT]
        RBAC[RBAC / Permissions Middleware]
        Controllers[Controllers & Services]
    end

Loading

---

🗄 Database Schema (ERD)

The relational database is carefully structured to handle complex fleet operations. View the detailed Database Design Document

erDiagram
    COMPANIES ||--o{ USERS : "has"
    COMPANIES ||--o{ VEHICLES : "owns"
    ROLES ||--o{ USERS : "assigned to"
    ROLES ||--o{ ROLE_PERMISSIONS : "grants"
    
    USERS ||--o| DRIVER : "is a"
    
    VEHICLES ||--o{ TRIP : "performs"
    VEHICLES ||--o{ FUEL_LOGS : "consumes"
    VEHICLES ||--o{ EXPENSES : "incurs"
    VEHICLES ||--o{ MAINTENANCE : "undergoes"
    
    DRIVER ||--o{ TRIP : "drives"
    TRIP ||--o{ EXPENSES : "incurs"

    COMPANIES {
        int id PK
        string name
        string currency
        string distance_unit
    }
    
    USERS {
        int id PK
        int company_id FK
        int role_id FK
        string name
        string email
        string password
    }

    ROLES {
        int id PK
        string role "Enum: ADMIN, DRIVER, etc."
    }

    VEHICLES {
        string reg_no PK
        int company_id FK
        string vehicle_model
        string type
        float load_capacity
        string status "Enum: Available, On_Trip, etc."
    }

    DRIVER {
        string license_no PK
        int driver_id FK "References Users"
        string status
        float safety_score
    }

    TRIP {
        int id PK
        string reg_no FK
        int driver_id FK
        string src
        string dest
        string trip_status "Enum: Draft, Dispatched, etc."
    }

Loading

---

🛠 Tech Stack

Frontend

• Framework: Next.js (App Router)
• Library: React 19
• Styling: Tailwind CSS v4
• Icons: Lucide React

Backend

• Framework: Express.js
• Language: TypeScript
• ORM: Prisma
• Database: PostgreSQL
• Security: JWT Authentication, Custom Role & Permission Middleware

---

🚀 Getting Started

Prerequisites

• Node.js (v20+)
• pnpm (recommended) or npm/yarn
• PostgreSQL Database
• Docker (optional, for running the database)

Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Install dependencies:

   pnpm install

3. Set up your .env file (copy from .env.example if available) and ensure DATABASE_URL is set.
4. Run Prisma migrations:

   pnpm dlx prisma migrate dev

5. Start the development server:

   pnpm dev

Frontend Setup

1. Navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   pnpm install

3. Start the Next.js development server:

   pnpm dev

The frontend will be available at http://localhost:3000 and the API backend typically at http://localhost:5000 (depending on your .env configuration).

---

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request