# 02bhaskar/redvolt architecture

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

- Interactive diagram: https://gitdiagram.com/02bhaskar/redvolt
- Repository: https://github.com/02bhaskar/redvolt

## Overview

RedVolt supports EV station discovery and administration, account access, charger availability, slot reservations, and user/admin booking management. The principal user flow is to browse stations, check availability, complete the booking wizard, and have the backend validate and persist the reservation. The sampled code shows Express routes and MongoDB models behind a React app. The README also describes session monitoring; live station status is visible in sampled admin code, but no charging-session lifecycle or payment processing is evidenced, so those are not modeled as implemented subsystems.

Main entry points: [`backend/server.js`](https://github.com/02bhaskar/redvolt/blob/main/backend/server.js) (HTTP server), [`frontend/src/App.jsx`](https://github.com/02bhaskar/redvolt/blob/main/frontend/src/App.jsx) (App workflow), [`backend/routes/stations.js`](https://github.com/02bhaskar/redvolt/blob/main/backend/routes/stations.js) (Station operations), [`backend/routes/bookings.js`](https://github.com/02bhaskar/redvolt/blob/main/backend/routes/bookings.js) (Booking operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web experience"]
  node_app["App workflow<br/>[App.jsx]"]
  node_map["Station map<br/>[MapView.jsx]"]
  node_bookingform["Booking wizard<br/>[BookingForm.jsx]"]
  node_userdash["User dashboard<br/>[UserDash.jsx]"]
  node_admindash["Admin dashboard<br/>[AdminDash.jsx]"]
end

subgraph group_api["Backend API"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth["Identity and access<br/>[auth.js]"]
  node_stations["Station operations<br/>[stations.js]"]
  node_bookings["Booking operations<br/>[bookings.js]"]
  node_dbconn["Database connection<br/>[db.js]"]
end

subgraph group_data["MongoDB domain"]
  node_users[("User records<br/>[User.js]")]
  node_stationrecords[("Station records<br/>[StationModel.js]")]
  node_bookingrecords[("Booking records<br/>[Booking.js]")]
end

node_user(("EV customer"))
node_admin(("Platform admin"))
node_mongodb[("MongoDB")]
node_browser(("Web browser"))

node_user -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_browser -->|"renders"| node_app
node_app -->|"renders"| node_map
node_app -->|"opens"| node_bookingform
node_app -->|"renders"| node_userdash
node_app -->|"renders"| node_admindash
node_app -->|"requests API"| node_server
node_bookingform -->|"submits booking"| node_server
node_admindash -->|"loads live status"| node_server
node_server -->|"connects"| node_dbconn
node_server -->|"mounts routes"| node_auth
node_server -->|"mounts routes"| node_stations
node_server -->|"mounts routes"| node_bookings
node_auth -->|"reads and writes"| node_users
node_bookings -->|"uses guards"| node_auth
node_stations -->|"uses guards"| node_auth
node_bookings -->|"reads and writes"| node_bookingrecords
node_bookings -->|"checks station"| node_stationrecords
node_stations -->|"reads and writes"| node_stationrecords
node_stations -->|"counts reservations"| node_bookingrecords
node_dbconn -->|"connects"| node_mongodb
node_users -.->|"persists"| node_mongodb
node_stationrecords -.->|"persists"| node_mongodb
node_bookingrecords -.->|"persists"| node_mongodb
node_map -.->|"loads stations"| node_server
node_userdash -.->|"manages bookings"| node_server
node_admindash -.->|"administers records"| node_server

click node_app "https://github.com/02bhaskar/redvolt/blob/main/frontend/src/App.jsx"
click node_map "https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/MapView.jsx"
click node_bookingform "https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/BookingForm.jsx"
click node_userdash "https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/UserDash.jsx"
click node_admindash "https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/AdminDash.jsx"
click node_server "https://github.com/02bhaskar/redvolt/blob/main/backend/server.js"
click node_auth "https://github.com/02bhaskar/redvolt/blob/main/backend/routes/auth.js"
click node_stations "https://github.com/02bhaskar/redvolt/blob/main/backend/routes/stations.js"
click node_bookings "https://github.com/02bhaskar/redvolt/blob/main/backend/routes/bookings.js"
click node_dbconn "https://github.com/02bhaskar/redvolt/blob/main/backend/config/db.js"
click node_users "https://github.com/02bhaskar/redvolt/blob/main/backend/models/User.js"
click node_stationrecords "https://github.com/02bhaskar/redvolt/blob/main/backend/models/StationModel.js"
click node_bookingrecords "https://github.com/02bhaskar/redvolt/blob/main/backend/models/Booking.js"

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_map,node_bookingform,node_userdash,node_admindash,node_browser toneBlue
class node_server,node_auth,node_stations,node_bookings,node_dbconn,node_mongodb toneAmber
class node_users,node_stationrecords,node_bookingrecords toneMint
class node_user,node_admin toneIndigo
```

## Components

### Web experience

- [App workflow](https://github.com/02bhaskar/redvolt/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Station map](https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/MapView.jsx): `frontend/src/components/MapView.jsx`
- [Booking wizard](https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/BookingForm.jsx): `frontend/src/components/BookingForm.jsx`
- [User dashboard](https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/UserDash.jsx): `frontend/src/components/UserDash.jsx`
- [Admin dashboard](https://github.com/02bhaskar/redvolt/blob/main/frontend/src/components/AdminDash.jsx): `frontend/src/components/AdminDash.jsx`

### Backend API

- [HTTP server](https://github.com/02bhaskar/redvolt/blob/main/backend/server.js): `backend/server.js`
- [Identity and access](https://github.com/02bhaskar/redvolt/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Station operations](https://github.com/02bhaskar/redvolt/blob/main/backend/routes/stations.js): `backend/routes/stations.js`
- [Booking operations](https://github.com/02bhaskar/redvolt/blob/main/backend/routes/bookings.js): `backend/routes/bookings.js`
- [Database connection](https://github.com/02bhaskar/redvolt/blob/main/backend/config/db.js): `backend/config/db.js`

### MongoDB domain

- [User records](https://github.com/02bhaskar/redvolt/blob/main/backend/models/User.js): `backend/models/User.js`
- [Station records](https://github.com/02bhaskar/redvolt/blob/main/backend/models/StationModel.js): `backend/models/StationModel.js`
- [Booking records](https://github.com/02bhaskar/redvolt/blob/main/backend/models/Booking.js): `backend/models/Booking.js`

### Other components

- **EV customer**
- **Platform admin**
- **MongoDB**
- **Web browser**

## Connections

- EV customer → App workflow: uses (evidence: `frontend/src/App.jsx`)
- Platform admin → App workflow: uses (evidence: `frontend/src/App.jsx`)
- Web browser → App workflow: renders
- App workflow → Station map: renders (evidence: `frontend/src/App.jsx`)
- App workflow → Booking wizard: opens (evidence: `frontend/src/App.jsx`)
- App workflow → User dashboard: renders (evidence: `frontend/src/App.jsx`)
- App workflow → Admin dashboard: renders (evidence: `frontend/src/App.jsx`)
- App workflow → HTTP server: requests API (evidence: `frontend/src/App.jsx`)
- Booking wizard → HTTP server: submits booking (evidence: `frontend/src/components/BookingForm.jsx`)
- Admin dashboard → HTTP server: loads live status (evidence: `frontend/src/components/AdminDash.jsx`)
- HTTP server → Database connection: connects (evidence: `backend/server.js`)
- HTTP server → Identity and access: mounts routes (evidence: `backend/server.js`)
- HTTP server → Station operations: mounts routes (evidence: `backend/server.js`)
- HTTP server → Booking operations: mounts routes (evidence: `backend/server.js`)
- Identity and access → User records: reads and writes (evidence: `backend/routes/auth.js`)
- Booking operations → Identity and access: uses guards (evidence: `backend/routes/bookings.js`)
- Station operations → Identity and access: uses guards (evidence: `backend/routes/stations.js`)
- Booking operations → Booking records: reads and writes (evidence: `backend/routes/bookings.js`)
- Booking operations → Station records: checks station (evidence: `backend/routes/bookings.js`)
- Station operations → Station records: reads and writes (evidence: `backend/routes/stations.js`)
- Station operations → Booking records: counts reservations (evidence: `backend/routes/stations.js`)
- Database connection → MongoDB: connects (evidence: `backend/config/db.js`)
- User records → MongoDB: persists
- Station records → MongoDB: persists
- Booking records → MongoDB: persists
- Station map → HTTP server: loads stations
- User dashboard → HTTP server: manages bookings
- Admin dashboard → HTTP server: administers records
