# anasimran22/buddyride architecture

> Architecture diagram of the GitHub repository anasimran22/buddyride, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anasimran22/buddyride
- Repository: https://github.com/anasimran22/buddyride

## Overview

BuddyRide is a ride-sharing and parcel-delivery app for passengers, drivers, and administrators. Passengers search trips and book seats or parcels; drivers post trips, handle requests, and complete rides or deliveries. The backend exposes authenticated APIs backed by MongoDB, with Socket.io for live location and notifications and an ML service for route/fare-related capabilities. The README documents the core booking and tracking flows; several secondary feature implementations are represented from the repository tree, so their internal wiring is not asserted here.

Main entry points: [`backend/controllers/bookingController.js`](https://github.com/anasimran22/buddyride/blob/main/backend/controllers/bookingController.js) (Booking and delivery), [`backend/server.js`](https://github.com/anasimran22/buddyride/blob/main/backend/server.js) (HTTP and socket server), [`backend/controllers/adminController.js`](https://github.com/anasimran22/buddyride/blob/main/backend/controllers/adminController.js) (Admin management), [`backend/sockets/socketHandler.js`](https://github.com/anasimran22/buddyride/blob/main/backend/sockets/socketHandler.js) (Live event handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile app"]
  node_app["BuddyRide app<br/>[App.tsx]"]
  node_session["Session management<br/>[AuthContext.tsx]"]
  node_search["Trip search<br/>[SearchScreen.tsx]"]
  node_driver_ops["Driver operations<br/>[DriverScreens.tsx]"]
  node_passenger_ops["Passenger rides"]
  node_parcel_tracking["Parcel tracking"]
  node_safety_ui["Safety features<br/>[safetyApi.ts]"]
  node_wallet_ui["Wallet screens<br/>[WalletScreen.tsx]"]
  node_admin_ui["Admin console"]
end

subgraph group_api["Backend API"]
  node_api_server["HTTP and socket server<br/>[server.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_trips["Trip management<br/>[tripController.js]"]
  node_bookings["Booking and delivery"]
  node_admin["Admin management<br/>[adminController.js]"]
  node_support_features["Safety, wallet, and feedback"]
  node_ml_api["ML API client<br/>[mlApi.js]"]
end

subgraph group_data["Domain data"]
  node_user_data[("User records<br/>[User.js]")]
  node_trip_data[("Trip records<br/>[Trip.js]")]
  node_booking_data[("Booking records<br/>[Booking.js]")]
end

subgraph group_realtime["Live services"]
  node_socket_handler["Live event handling<br/>[socketHandler.js]"]
  node_notifications["Notifications<br/>[notify.js]"]
end

subgraph group_ml["ML service"]
  node_ml_service["Route and demand API<br/>[main.py]"]
end

node_users(("Passengers and drivers"))
node_admins(("Administrators"))

node_users -->|"use"| node_app
node_admins -->|"manage"| node_admin_ui
node_app -->|"provides session"| node_session
node_session -->|"authenticates through"| node_auth
node_session -->|"connects socket"| node_socket_handler
node_search -->|"requests trips"| node_trips
node_search -->|"requests booking"| node_bookings
node_driver_ops -.->|"posts trips"| node_trips
node_passenger_ops -.->|"manages rides"| node_bookings
node_parcel_tracking -.->|"tracks delivery"| node_bookings
node_safety_ui -.->|"uses safety API"| node_support_features
node_wallet_ui -.->|"uses wallet API"| node_support_features
node_admin_ui -.->|"calls admin API"| node_admin
node_api_server -->|"mounts routes"| node_auth
node_api_server -->|"mounts routes"| node_trips
node_api_server -->|"mounts routes"| node_bookings
node_api_server -->|"mounts routes"| node_support_features
node_api_server -->|"mounts routes"| node_admin
node_api_server -->|"registers handlers"| node_socket_handler
node_auth -->|"reads users"| node_user_data
node_trips -->|"reads and writes"| node_trip_data
node_bookings -->|"reads and writes"| node_booking_data
node_bookings -->|"reserves trip seats"| node_trip_data
node_bookings -->|"requests fare estimate"| node_ml_api
node_trips -->|"requests predictions"| node_ml_api
node_ml_api -.->|"calls ML service"| node_ml_service
node_socket_handler -->|"updates location"| node_user_data
node_socket_handler -->|"checks bookings"| node_booking_data
node_socket_handler -->|"sends alerts"| node_notifications
node_admin -->|"manages bookings"| node_booking_data
node_admin -->|"monitors trips"| node_trip_data
node_admin -->|"manages users"| node_user_data

click node_app "https://github.com/anasimran22/buddyride/blob/main/frontend/App.tsx"
click node_session "https://github.com/anasimran22/buddyride/blob/main/frontend/src/context/AuthContext.tsx"
click node_search "https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/SearchScreen.tsx"
click node_driver_ops "https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/driver/DriverScreens.tsx"
click node_passenger_ops "https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/PassengerScreens.tsx"
click node_parcel_tracking "https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/ParcelTrackScreen.tsx"
click node_safety_ui "https://github.com/anasimran22/buddyride/blob/main/frontend/src/services/safetyApi.ts"
click node_wallet_ui "https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/WalletScreen.tsx"
click node_admin_ui "https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/admin/AdminDashboardScreen.tsx"
click node_api_server "https://github.com/anasimran22/buddyride/blob/main/backend/server.js"
click node_auth "https://github.com/anasimran22/buddyride/blob/main/backend/controllers/authController.js"
click node_trips "https://github.com/anasimran22/buddyride/blob/main/backend/controllers/tripController.js"
click node_bookings "https://github.com/anasimran22/buddyride/blob/main/backend/controllers/bookingController.js"
click node_admin "https://github.com/anasimran22/buddyride/blob/main/backend/controllers/adminController.js"
click node_support_features "https://github.com/anasimran22/buddyride/tree/main/backend/routes"
click node_user_data "https://github.com/anasimran22/buddyride/blob/main/backend/models/User.js"
click node_trip_data "https://github.com/anasimran22/buddyride/blob/main/backend/models/Trip.js"
click node_booking_data "https://github.com/anasimran22/buddyride/blob/main/backend/models/Booking.js"
click node_socket_handler "https://github.com/anasimran22/buddyride/blob/main/backend/sockets/socketHandler.js"
click node_notifications "https://github.com/anasimran22/buddyride/blob/main/backend/utils/notify.js"
click node_ml_api "https://github.com/anasimran22/buddyride/blob/main/backend/services/mlApi.js"
click node_ml_service "https://github.com/anasimran22/buddyride/blob/main/ml-service/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_session,node_search,node_driver_ops,node_passenger_ops,node_parcel_tracking,node_safety_ui,node_wallet_ui,node_admin_ui toneBlue
class node_api_server,node_auth,node_trips,node_bookings,node_admin,node_support_features,node_ml_api toneAmber
class node_user_data,node_trip_data,node_booking_data toneMint
class node_socket_handler,node_notifications toneRose
class node_ml_service,node_users,node_admins toneIndigo
```

## Components

### Mobile app

- [BuddyRide app](https://github.com/anasimran22/buddyride/blob/main/frontend/App.tsx): `frontend/App.tsx`
- [Session management](https://github.com/anasimran22/buddyride/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Trip search](https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/SearchScreen.tsx): `frontend/src/screens/passenger/SearchScreen.tsx`
- [Driver operations](https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/driver/DriverScreens.tsx): `frontend/src/screens/driver/DriverScreens.tsx`
- [Passenger rides](https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/PassengerScreens.tsx): `frontend/src/screens/passenger/PassengerScreens.tsx`
- [Parcel tracking](https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/ParcelTrackScreen.tsx): `frontend/src/screens/passenger/ParcelTrackScreen.tsx`
- [Safety features](https://github.com/anasimran22/buddyride/blob/main/frontend/src/services/safetyApi.ts): `frontend/src/services/safetyApi.ts`
- [Wallet screens](https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/passenger/WalletScreen.tsx): `frontend/src/screens/passenger/WalletScreen.tsx`
- [Admin console](https://github.com/anasimran22/buddyride/blob/main/frontend/src/screens/admin/AdminDashboardScreen.tsx): `frontend/src/screens/admin/AdminDashboardScreen.tsx`

### Backend API

- [HTTP and socket server](https://github.com/anasimran22/buddyride/blob/main/backend/server.js): `backend/server.js`
- [Authentication](https://github.com/anasimran22/buddyride/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Trip management](https://github.com/anasimran22/buddyride/blob/main/backend/controllers/tripController.js): `backend/controllers/tripController.js`
- [Booking and delivery](https://github.com/anasimran22/buddyride/blob/main/backend/controllers/bookingController.js): `backend/controllers/bookingController.js`
- [Admin management](https://github.com/anasimran22/buddyride/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Safety, wallet, and feedback](https://github.com/anasimran22/buddyride/tree/main/backend/routes): `backend/routes`
- [ML API client](https://github.com/anasimran22/buddyride/blob/main/backend/services/mlApi.js): `backend/services/mlApi.js`

### Domain data

- [User records](https://github.com/anasimran22/buddyride/blob/main/backend/models/User.js): `backend/models/User.js`
- [Trip records](https://github.com/anasimran22/buddyride/blob/main/backend/models/Trip.js): `backend/models/Trip.js`
- [Booking records](https://github.com/anasimran22/buddyride/blob/main/backend/models/Booking.js): `backend/models/Booking.js`

### Live services

- [Live event handling](https://github.com/anasimran22/buddyride/blob/main/backend/sockets/socketHandler.js): `backend/sockets/socketHandler.js`
- [Notifications](https://github.com/anasimran22/buddyride/blob/main/backend/utils/notify.js): `backend/utils/notify.js`

### ML service

- [Route and demand API](https://github.com/anasimran22/buddyride/blob/main/ml-service/main.py): `ml-service/main.py`

### Other components

- **Passengers and drivers**
- **Administrators**

## Connections

- Passengers and drivers → BuddyRide app: use (evidence: `README.md`)
- Administrators → Admin console: manage (evidence: `README.md`)
- BuddyRide app → Session management: provides session (evidence: `frontend/App.tsx`)
- Session management → Authentication: authenticates through (evidence: `README.md`)
- Session management → Live event handling: connects socket (evidence: `frontend/src/context/AuthContext.tsx`)
- Trip search → Trip management: requests trips (evidence: `frontend/src/screens/passenger/SearchScreen.tsx`)
- Trip search → Booking and delivery: requests booking (evidence: `frontend/src/screens/passenger/SearchScreen.tsx`)
- Driver operations → Trip management: posts trips
- Passenger rides → Booking and delivery: manages rides
- Parcel tracking → Booking and delivery: tracks delivery
- Safety features → Safety, wallet, and feedback: uses safety API
- Wallet screens → Safety, wallet, and feedback: uses wallet API
- Admin console → Admin management: calls admin API
- HTTP and socket server → Authentication: mounts routes (evidence: `backend/server.js`)
- HTTP and socket server → Trip management: mounts routes (evidence: `backend/server.js`)
- HTTP and socket server → Booking and delivery: mounts routes (evidence: `backend/server.js`)
- HTTP and socket server → Safety, wallet, and feedback: mounts routes (evidence: `backend/server.js`)
- HTTP and socket server → Admin management: mounts routes (evidence: `backend/server.js`)
- HTTP and socket server → Live event handling: registers handlers (evidence: `backend/server.js`)
- Authentication → User records: reads users (evidence: `backend/controllers/authController.js`)
- Trip management → Trip records: reads and writes (evidence: `backend/controllers/tripController.js`)
- Booking and delivery → Booking records: reads and writes (evidence: `backend/controllers/bookingController.js`)
- Booking and delivery → Trip records: reserves trip seats (evidence: `backend/controllers/bookingController.js`)
- Booking and delivery → ML API client: requests fare estimate (evidence: `backend/controllers/bookingController.js`)
- Trip management → ML API client: requests predictions (evidence: `backend/controllers/tripController.js`)
- ML API client → Route and demand API: calls ML service
- Live event handling → User records: updates location (evidence: `backend/sockets/socketHandler.js`)
- Live event handling → Booking records: checks bookings (evidence: `backend/sockets/socketHandler.js`)
- Live event handling → Notifications: sends alerts (evidence: `backend/sockets/socketHandler.js`)
- Admin management → Booking records: manages bookings (evidence: `backend/controllers/adminController.js`)
- Admin management → Trip records: monitors trips (evidence: `backend/controllers/adminController.js`)
- Admin management → User records: manages users (evidence: `backend/controllers/adminController.js`)
