# anasimosss/car_rental_system architecture

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

- Interactive diagram: https://gitdiagram.com/anasimosss/car_rental_system
- Repository: https://github.com/anasimosss/car_rental_system

## Overview

This is a car-rental booking and fleet-management application. Customers register and verify accounts, browse vehicles, create bookings, and pay; staff administer reservations, fleet, maintenance, payments, and reviews. The frontend routes users through these workflows, while an Express API dispatches requests to domain routes and controllers backed by Sequelize models and SQL Server. The source index documents many module references, but several route implementations and frontend API calls were not excerpted; those relationships are omitted or marked unverified rather than inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/App.jsx) (Route application), [`backend/src/config/db.js`](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/config/db.js) (SQL Server), [`backend/src/models/Vehicle.js`](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Vehicle.js) (Vehicle records), [`backend/src/controllers/bookingController.js`](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/bookingController.js) (Booking operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer application"]
  node_webapp["Route application<br/>[App.jsx]"]
  node_authui["Account access<br/>[AuthContext.jsx]"]
  node_browse["Vehicle browsing<br/>[Vehicles.jsx]"]
  node_details["Vehicle details<br/>[VehicleDetails.jsx]"]
  node_home["Home discovery<br/>[Home.jsx]"]
  node_bookingui["Booking and payment<br/>[BookingPayment.jsx]"]
  node_mybookings["My bookings<br/>[MyBookings.jsx]"]
  node_adminui["Staff dashboard<br/>[AdminDashboard.jsx]"]
  node_vehiclemodal["Vehicle editor"]
  node_dashboard["User dashboard<br/>[Dashboard.jsx]"]
  node_apiutil["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["HTTP server<br/>[server.js]"]
  node_app["API application<br/>[app.js]"]
  node_authroutes["Account routes<br/>[auth.js]"]
  node_reviewroutes["Review routes<br/>[reviews.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_guard["Access control<br/>[auth.js]"]
end

subgraph group_domain["Rental operations"]
  node_booking["Booking operations"]
  node_vehicles["Fleet operations"]
  node_reviews["Review operations"]
  node_maintenance["Maintenance"]
  node_payments["Payment operations"]
  node_locations["Rental locations"]
  node_users["User management<br/>[userController.js]"]
end

subgraph group_data["Persistence"]
  node_bookingmodel["Booking records<br/>[Booking.js]"]
  node_vehiclemodel["Vehicle records<br/>[Vehicle.js]"]
  node_usermodel["User records<br/>[User.js]"]
  node_locationmodel["Location records<br/>[Location.js]"]
  node_reviewmodel["Review records<br/>[Review.js]"]
  node_maintmodel["Maintenance records<br/>[Maintenance.js]"]
  node_paymentmodel["Payment records<br/>[Payment.js]"]
  node_db[("SQL Server<br/>[db.js]")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_home
node_webapp -.->|"routes to"| node_authui
node_webapp -->|"routes to"| node_browse
node_webapp -->|"routes to"| node_details
node_webapp -->|"routes to"| node_bookingui
node_webapp -->|"routes to"| node_mybookings
node_webapp -->|"routes to"| node_adminui
node_webapp -->|"routes to"| node_dashboard
node_authui -->|"calls"| node_apiutil
node_adminui -->|"renders"| node_vehiclemodal
node_webapp -.->|"requests API"| node_app
node_server -->|"loads"| node_app
node_app -->|"mounts"| node_authroutes
node_app -->|"mounts"| node_reviewroutes
node_authroutes -->|"dispatches"| node_auth
node_reviewroutes -->|"dispatches"| node_reviews
node_reviewroutes -->|"protects"| node_guard
node_booking -->|"reads and writes"| node_bookingmodel
node_booking -->|"reads"| node_vehiclemodel
node_booking -->|"loads relations"| node_usermodel
node_booking -->|"loads relations"| node_locationmodel
node_reviews -->|"reads and writes"| node_reviewmodel
node_reviews -->|"loads reviewer"| node_usermodel
node_reviews -->|"updates ratings"| node_vehiclemodel
node_auth -->|"reads and writes"| node_usermodel
node_vehicles -->|"manages"| node_vehiclemodel
node_maintenance -->|"manages"| node_maintmodel
node_payments -->|"reads"| node_bookingmodel
node_payments -->|"reads"| node_vehiclemodel
node_bookingmodel -->|"uses"| node_db
node_vehiclemodel -->|"uses"| node_db
node_usermodel -->|"uses"| node_db
node_locationmodel -->|"uses"| node_db
node_reviewmodel -->|"uses"| node_db
node_server -->|"connects"| node_db

click node_webapp "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/App.jsx"
click node_authui "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/contexts/AuthContext.jsx"
click node_browse "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/Vehicles.jsx"
click node_details "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/VehicleDetails.jsx"
click node_home "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/Home.jsx"
click node_bookingui "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/BookingPayment.jsx"
click node_mybookings "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/MyBookings.jsx"
click node_adminui "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/AdminDashboard.jsx"
click node_vehiclemodal "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/components/AddVehicleModal.jsx"
click node_dashboard "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/Dashboard.jsx"
click node_apiutil "https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/utils/api.js"
click node_server "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/server.js"
click node_app "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/app.js"
click node_authroutes "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/routes/auth.js"
click node_reviewroutes "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/routes/reviews.js"
click node_auth "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/authController.js"
click node_guard "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/middleware/auth.js"
click node_booking "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/bookingController.js"
click node_vehicles "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/vehicleController.js"
click node_reviews "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/reviewController.js"
click node_maintenance "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/maintenanceController.js"
click node_payments "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/paymentController.js"
click node_locations "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/locationController.js"
click node_users "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/userController.js"
click node_bookingmodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Booking.js"
click node_vehiclemodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Vehicle.js"
click node_usermodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/User.js"
click node_locationmodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Location.js"
click node_reviewmodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Review.js"
click node_maintmodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Maintenance.js"
click node_paymentmodel "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Payment.js"
click node_db "https://github.com/anasimosss/car_rental_system/blob/master/backend/src/config/db.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_webapp,node_authui,node_browse,node_details,node_home,node_bookingui,node_mybookings,node_adminui,node_vehiclemodal,node_dashboard,node_apiutil toneBlue
class node_server,node_app,node_authroutes,node_reviewroutes,node_auth,node_guard toneAmber
class node_booking,node_vehicles,node_reviews,node_maintenance,node_payments,node_locations,node_users toneMint
class node_bookingmodel,node_vehiclemodel,node_usermodel,node_locationmodel,node_reviewmodel,node_maintmodel,node_paymentmodel,node_db toneRose
class node_customer toneIndigo
```

## Components

### Customer application

- [Route application](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Account access](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/contexts/AuthContext.jsx): `frontend/src/contexts/AuthContext.jsx`
- [Vehicle browsing](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/Vehicles.jsx): `frontend/src/pages/Vehicles.jsx`
- [Vehicle details](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/VehicleDetails.jsx): `frontend/src/pages/VehicleDetails.jsx`
- [Home discovery](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Booking and payment](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/BookingPayment.jsx): `frontend/src/pages/BookingPayment.jsx`
- [My bookings](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/MyBookings.jsx): `frontend/src/pages/MyBookings.jsx`
- [Staff dashboard](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Vehicle editor](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/components/AddVehicleModal.jsx): `frontend/src/components/AddVehicleModal.jsx`
- [User dashboard](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [API client](https://github.com/anasimosss/car_rental_system/blob/master/frontend/src/utils/api.js): `frontend/src/utils/api.js`

### API and access

- [HTTP server](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/server.js): `backend/src/server.js`
- [API application](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/app.js): `backend/src/app.js`
- [Account routes](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [Review routes](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/routes/reviews.js): `backend/src/routes/reviews.js`
- [Authentication](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Access control](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`

### Rental operations

- [Booking operations](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/bookingController.js): `backend/src/controllers/bookingController.js`
- [Fleet operations](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/vehicleController.js): `backend/src/controllers/vehicleController.js`
- [Review operations](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/reviewController.js): `backend/src/controllers/reviewController.js`
- [Maintenance](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/maintenanceController.js): `backend/src/controllers/maintenanceController.js`
- [Payment operations](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/paymentController.js): `backend/src/controllers/paymentController.js`
- [Rental locations](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/locationController.js): `backend/src/controllers/locationController.js`
- [User management](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/controllers/userController.js): `backend/src/controllers/userController.js`

### Persistence

- [Booking records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Booking.js): `backend/src/models/Booking.js`
- [Vehicle records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Vehicle.js): `backend/src/models/Vehicle.js`
- [User records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/User.js): `backend/src/models/User.js`
- [Location records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Location.js): `backend/src/models/Location.js`
- [Review records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Review.js): `backend/src/models/Review.js`
- [Maintenance records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Maintenance.js): `backend/src/models/Maintenance.js`
- [Payment records](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/models/Payment.js): `backend/src/models/Payment.js`
- [SQL Server](https://github.com/anasimosss/car_rental_system/blob/master/backend/src/config/db.js): `backend/src/config/db.js`

### Other components

- **Customer**

## Connections

- Customer → Route application: uses (evidence: `frontend/src/App.jsx`)
- Route application → Home discovery: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Account access: routes to
- Route application → Vehicle browsing: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Vehicle details: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Booking and payment: routes to (evidence: `frontend/src/App.jsx`)
- Route application → My bookings: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Staff dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route application → User dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Account access → API client: calls (evidence: `frontend/src/contexts/AuthContext.jsx`)
- Staff dashboard → Vehicle editor: renders (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Route application → API application: requests API
- HTTP server → API application: loads (evidence: `backend/src/server.js`)
- API application → Account routes: mounts (evidence: `backend/src/app.js`)
- API application → Review routes: mounts (evidence: `backend/src/app.js`)
- Account routes → Authentication: dispatches (evidence: `backend/src/routes/auth.js`)
- Review routes → Review operations: dispatches (evidence: `backend/src/routes/reviews.js`)
- Review routes → Access control: protects (evidence: `backend/src/routes/reviews.js`)
- Booking operations → Booking records: reads and writes (evidence: `backend/src/controllers/bookingController.js`)
- Booking operations → Vehicle records: reads (evidence: `backend/src/controllers/bookingController.js`)
- Booking operations → User records: loads relations (evidence: `backend/src/controllers/bookingController.js`)
- Booking operations → Location records: loads relations (evidence: `backend/src/controllers/bookingController.js`)
- Review operations → Review records: reads and writes (evidence: `backend/src/controllers/reviewController.js`)
- Review operations → User records: loads reviewer (evidence: `backend/src/controllers/reviewController.js`)
- Review operations → Vehicle records: updates ratings (evidence: `backend/src/controllers/reviewController.js`)
- Authentication → User records: reads and writes (evidence: `backend/src/controllers/authController.js`)
- Fleet operations → Vehicle records: manages (evidence: `backend/src/controllers/vehicleController.js`)
- Maintenance → Maintenance records: manages (evidence: `backend/src/controllers/maintenanceController.js`)
- Payment operations → Booking records: reads (evidence: `backend/src/controllers/paymentController.js`)
- Payment operations → Vehicle records: reads (evidence: `backend/src/controllers/paymentController.js`)
- Booking records → SQL Server: uses (evidence: `backend/src/models/Booking.js`)
- Vehicle records → SQL Server: uses (evidence: `backend/src/models/Vehicle.js`)
- User records → SQL Server: uses (evidence: `backend/src/models/User.js`)
- Location records → SQL Server: uses (evidence: `backend/src/models/Location.js`)
- Review records → SQL Server: uses (evidence: `backend/src/models/Review.js`)
- HTTP server → SQL Server: connects (evidence: `backend/src/server.js`)
