# shravanikale13/garagebuddy-project architecture

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

- Interactive diagram: https://gitdiagram.com/shravanikale13/garagebuddy-project
- Repository: https://github.com/shravanikale13/garagebuddy-project

## Overview

GarageBuddy is a Django garage-management web app. Admins use its routes and views to manage customer/vehicle data, service records, and bills, with HTML pages for interaction. The README also describes job tracking, history, reminders, and dashboard capabilities, but the supplied tree does not show separate implementations for these. The implementation differs from the README’s stated stack: settings configure SQLite, while sampled views also connect directly to MongoDB. The graph reflects only evidenced calls and documented capabilities; several README features are not verifiable in sampled source.

Main entry points: [`garageproject/garageproject/views.py`](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py) (Request handlers), [`garageproject/garageproject/urls.py`](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/urls.py) (URL routing), [`garageproject/garageproject/models.py`](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/models.py) (Record models), [`garageproject/templates`](https://github.com/shravanikale13/garagebuddy-project/tree/main/garageproject/templates) (Garage pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_routing["URL routing<br/>[urls.py]"]
  node_views["Request handlers<br/>[views.py]"]
  node_pages["Garage pages"]
end

subgraph group_operations["Garage operations"]
  node_customer_vehicle["Customer and vehicles<br/>[views.py]"]
  node_service["Service records<br/>[views.py]"]
  node_billing["Billing<br/>[views.py]"]
  node_dashboard["Dashboard<br/>[views.py]"]
  node_history["Service history"]
  node_reminders["Service reminders"]
end

subgraph group_data["Persistence"]
  node_models["Record models<br/>[models.py]"]
  node_sqlite[("SQLite database<br/>[db.sqlite3]")]
  node_mongodb[("MongoDB")]
end

node_admin(("Garage admin"))

node_admin -->|"sends requests"| node_routing
node_routing -->|"routes to"| node_views
node_views -->|"renders pages"| node_pages
node_views -->|"handles management"| node_customer_vehicle
node_views -->|"creates records"| node_service
node_views -->|"handles billing"| node_billing
node_views -->|"serves dashboard"| node_dashboard
node_views -->|"reads and writes"| node_mongodb
node_views -->|"creates records"| node_models
node_models -.->|"uses configured database"| node_sqlite
node_views -.->|"supports history"| node_history
node_views -.->|"supports reminders"| node_reminders

click node_routing "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/urls.py"
click node_views "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py"
click node_pages "https://github.com/shravanikale13/garagebuddy-project/tree/main/garageproject/templates"
click node_customer_vehicle "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py"
click node_service "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py"
click node_billing "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py"
click node_dashboard "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py"
click node_models "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/models.py"
click node_sqlite "https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/db.sqlite3"

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_routing,node_views,node_pages toneBlue
class node_customer_vehicle,node_service,node_billing,node_dashboard,node_history,node_reminders toneAmber
class node_models,node_sqlite,node_mongodb toneMint
class node_admin toneIndigo
```

## Components

### Web application

- [URL routing](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/urls.py): `garageproject/garageproject/urls.py`
- [Request handlers](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py): `garageproject/garageproject/views.py`
- [Garage pages](https://github.com/shravanikale13/garagebuddy-project/tree/main/garageproject/templates): `garageproject/templates`

### Garage operations

- [Customer and vehicles](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py): `garageproject/garageproject/views.py`
- [Service records](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py): `garageproject/garageproject/views.py`
- [Billing](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py): `garageproject/garageproject/views.py`
- [Dashboard](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/views.py): `garageproject/garageproject/views.py`
- **Service history**
- **Service reminders**

### Persistence

- [Record models](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/garageproject/models.py): `garageproject/garageproject/models.py`
- [SQLite database](https://github.com/shravanikale13/garagebuddy-project/blob/main/garageproject/db.sqlite3): `garageproject/db.sqlite3`
- **MongoDB**

### Other components

- **Garage admin**

## Connections

- Garage admin → URL routing: sends requests (evidence: `garageproject/garageproject/urls.py`)
- URL routing → Request handlers: routes to (evidence: `garageproject/garageproject/urls.py`)
- Request handlers → Garage pages: renders pages (evidence: `garageproject/garageproject/views.py`)
- Request handlers → Customer and vehicles: handles management (evidence: `garageproject/garageproject/views.py`)
- Request handlers → Service records: creates records (evidence: `garageproject/garageproject/views.py`)
- Request handlers → Billing: handles billing (evidence: `garageproject/garageproject/views.py`)
- Request handlers → Dashboard: serves dashboard (evidence: `README.md`)
- Request handlers → MongoDB: reads and writes (evidence: `garageproject/garageproject/views.py`)
- Request handlers → Record models: creates records (evidence: `garageproject/garageproject/views.py`)
- Record models → SQLite database: uses configured database
- Request handlers → Service history: supports history (evidence: `README.md`)
- Request handlers → Service reminders: supports reminders (evidence: `README.md`)