# preethi-karuna06/car-parking-system architecture

> Architecture diagram of the GitHub repository preethi-karuna06/car-parking-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/preethi-karuna06/car-parking-system
- Repository: https://github.com/preethi-karuna06/car-parking-system

## Overview

Smart Car Parking is a role-based web application connecting drivers with parking-area owners, with administrators overseeing listings and accounts. Drivers find active parking, book a slot, and track or complete a booking; owners manage listings and booking entry/exit; administrators approve listings and manage platform activity. Services implement registration, parking lifecycle, booking and billing, reviews, and image handling, backed by Spring Data repositories and relational entities. The README documents MySQL and map capabilities; source excerpts do not show payment-provider integration or the map’s runtime wiring, so those links are not inferred.

Main entry points: [`src/main/java/com/smartparking/service/BookingService.java`](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/BookingService.java) (Booking and billing), [`src/main/java/com/smartparking/service/ParkingAreaService.java`](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ParkingAreaService.java) (Parking management), [`src/main/java/com/smartparking/repository`](https://github.com/preethi-karuna06/car-parking-system/tree/main/src/main/java/com/smartparking/repository) (JPA repositories), [`src/main/java/com/smartparking/controller/OwnerController.java`](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/OwnerController.java) (Owner actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Web and access"]
  node_home["Home and search"]
  node_userctrl["User actions"]
  node_ownerctrl["Owner actions"]
  node_adminctrl["Admin actions"]
  node_security["Login security"]
  node_identity["User identity lookup"]
end

subgraph group_parking["Parking discovery"]
  node_parkingservice["Parking management"]
  node_images["Parking images"]
end

subgraph group_operations["Bookings and operations"]
  node_bookingservice["Booking and billing"]
  node_reviewservice["Reviews and ratings<br/>[ReviewService.java]"]
  node_userservice["Registration and accounts<br/>[UserService.java]"]
end

subgraph group_domain["Domain and persistence"]
  node_userentity["User model<br/>[User.java]"]
  node_parkingentity["Parking area model<br/>[ParkingArea.java]"]
  node_bookingentity["Booking model<br/>[Booking.java]"]
  node_reviewentity["Review model<br/>[Review.java]"]
  node_states["Role and status enums"]
  node_repositories["JPA repositories"]
  node_database[("MySQL database")]
end

node_driver(("Driver"))
node_owner(("Parking owner"))
node_admin(("Administrator"))

node_driver -->|"searches"| node_home
node_driver -->|"books and reviews"| node_userctrl
node_owner -->|"manages parking"| node_ownerctrl
node_admin -->|"administers"| node_adminctrl
node_home -->|"searches listings"| node_parkingservice
node_home -->|"registers accounts"| node_userservice
node_home -->|"loads reviews"| node_reviewservice
node_userctrl -->|"manages bookings"| node_bookingservice
node_userctrl -->|"loads parking"| node_parkingservice
node_userctrl -->|"submits reviews"| node_reviewservice
node_ownerctrl -->|"manages listings"| node_parkingservice
node_ownerctrl -->|"handles bookings"| node_bookingservice
node_ownerctrl -->|"views reviews"| node_reviewservice
node_ownerctrl -->|"uploads images"| node_images
node_adminctrl -->|"manages accounts"| node_userservice
node_adminctrl -->|"approves listings"| node_parkingservice
node_adminctrl -->|"views bookings"| node_bookingservice
node_security -->|"loads identities"| node_identity
node_identity -->|"looks up users"| node_repositories
node_userservice -->|"persists users"| node_repositories
node_parkingservice -->|"persists listings"| node_repositories
node_bookingservice -->|"persists bookings"| node_repositories
node_reviewservice -->|"persists reviews"| node_repositories
node_repositories -->|"stores records"| node_database
node_parkingservice -->|"manages listings"| node_parkingentity
node_bookingservice -->|"creates and updates"| node_bookingentity
node_reviewservice -->|"creates reviews"| node_reviewentity
node_userservice -->|"registers users"| node_userentity
node_identity -->|"builds principal"| node_userentity
node_bookingservice -->|"updates availability"| node_parkingentity
node_parkingservice -->|"sets listing status"| node_states
node_bookingservice -->|"sets booking status"| node_states
node_userentity -->|"owns listings"| node_parkingentity
node_bookingentity -->|"belongs to user"| node_userentity
node_bookingentity -->|"reserves area"| node_parkingentity
node_reviewentity -->|"authored by"| node_userentity
node_reviewentity -->|"rates area"| node_parkingentity

click node_home "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/HomeController.java"
click node_userctrl "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/UserController.java"
click node_ownerctrl "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/OwnerController.java"
click node_adminctrl "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/AdminController.java"
click node_security "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/config/SecurityConfig.java"
click node_identity "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/security/CustomUserDetailsService.java"
click node_parkingservice "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ParkingAreaService.java"
click node_images "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ImageUploadService.java"
click node_bookingservice "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/BookingService.java"
click node_reviewservice "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ReviewService.java"
click node_userservice "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/UserService.java"
click node_userentity "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/User.java"
click node_parkingentity "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/ParkingArea.java"
click node_bookingentity "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/Booking.java"
click node_reviewentity "https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/Review.java"
click node_states "https://github.com/preethi-karuna06/car-parking-system/tree/main/src/main/java/com/smartparking/enums"
click node_repositories "https://github.com/preethi-karuna06/car-parking-system/tree/main/src/main/java/com/smartparking/repository"

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_home,node_userctrl,node_ownerctrl,node_adminctrl,node_security,node_identity toneBlue
class node_parkingservice,node_images toneAmber
class node_bookingservice,node_reviewservice,node_userservice toneMint
class node_userentity,node_parkingentity,node_bookingentity,node_reviewentity,node_states,node_repositories,node_database toneRose
class node_driver,node_owner,node_admin toneIndigo
```

## Components

### Web and access

- [Home and search](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/HomeController.java): `src/main/java/com/smartparking/controller/HomeController.java`
- [User actions](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/UserController.java): `src/main/java/com/smartparking/controller/UserController.java`
- [Owner actions](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/OwnerController.java): `src/main/java/com/smartparking/controller/OwnerController.java`
- [Admin actions](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/controller/AdminController.java): `src/main/java/com/smartparking/controller/AdminController.java`
- [Login security](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/config/SecurityConfig.java): `src/main/java/com/smartparking/config/SecurityConfig.java`
- [User identity lookup](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/security/CustomUserDetailsService.java): `src/main/java/com/smartparking/security/CustomUserDetailsService.java`

### Parking discovery

- [Parking management](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ParkingAreaService.java): `src/main/java/com/smartparking/service/ParkingAreaService.java`
- [Parking images](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ImageUploadService.java): `src/main/java/com/smartparking/service/ImageUploadService.java`

### Bookings and operations

- [Booking and billing](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/BookingService.java): `src/main/java/com/smartparking/service/BookingService.java`
- [Reviews and ratings](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/ReviewService.java): `src/main/java/com/smartparking/service/ReviewService.java`
- [Registration and accounts](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/service/UserService.java): `src/main/java/com/smartparking/service/UserService.java`

### Domain and persistence

- [User model](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/User.java): `src/main/java/com/smartparking/entity/User.java`
- [Parking area model](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/ParkingArea.java): `src/main/java/com/smartparking/entity/ParkingArea.java`
- [Booking model](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/Booking.java): `src/main/java/com/smartparking/entity/Booking.java`
- [Review model](https://github.com/preethi-karuna06/car-parking-system/blob/main/src/main/java/com/smartparking/entity/Review.java): `src/main/java/com/smartparking/entity/Review.java`
- [Role and status enums](https://github.com/preethi-karuna06/car-parking-system/tree/main/src/main/java/com/smartparking/enums): `src/main/java/com/smartparking/enums`
- [JPA repositories](https://github.com/preethi-karuna06/car-parking-system/tree/main/src/main/java/com/smartparking/repository): `src/main/java/com/smartparking/repository`
- **MySQL database**

### Other components

- **Driver**
- **Parking owner**
- **Administrator**

## Connections

- Driver → Home and search: searches (evidence: `README.md`)
- Driver → User actions: books and reviews (evidence: `README.md`)
- Parking owner → Owner actions: manages parking (evidence: `README.md`)
- Administrator → Admin actions: administers (evidence: `README.md`)
- Home and search → Parking management: searches listings (evidence: `src/main/java/com/smartparking/controller/HomeController.java`)
- Home and search → Registration and accounts: registers accounts (evidence: `src/main/java/com/smartparking/controller/HomeController.java`)
- Home and search → Reviews and ratings: loads reviews (evidence: `src/main/java/com/smartparking/controller/HomeController.java`)
- User actions → Booking and billing: manages bookings (evidence: `src/main/java/com/smartparking/controller/UserController.java`)
- User actions → Parking management: loads parking (evidence: `src/main/java/com/smartparking/controller/UserController.java`)
- User actions → Reviews and ratings: submits reviews (evidence: `src/main/java/com/smartparking/controller/UserController.java`)
- Owner actions → Parking management: manages listings (evidence: `src/main/java/com/smartparking/controller/OwnerController.java`)
- Owner actions → Booking and billing: handles bookings (evidence: `src/main/java/com/smartparking/controller/OwnerController.java`)
- Owner actions → Reviews and ratings: views reviews (evidence: `src/main/java/com/smartparking/controller/OwnerController.java`)
- Owner actions → Parking images: uploads images (evidence: `src/main/java/com/smartparking/controller/OwnerController.java`)
- Admin actions → Registration and accounts: manages accounts (evidence: `src/main/java/com/smartparking/controller/AdminController.java`)
- Admin actions → Parking management: approves listings (evidence: `src/main/java/com/smartparking/controller/AdminController.java`)
- Admin actions → Booking and billing: views bookings (evidence: `src/main/java/com/smartparking/controller/AdminController.java`)
- Login security → User identity lookup: loads identities (evidence: `src/main/java/com/smartparking/config/SecurityConfig.java`)
- User identity lookup → JPA repositories: looks up users (evidence: `src/main/java/com/smartparking/security/CustomUserDetailsService.java`)
- Registration and accounts → JPA repositories: persists users (evidence: `src/main/java/com/smartparking/service/UserService.java`)
- Parking management → JPA repositories: persists listings (evidence: `src/main/java/com/smartparking/service/ParkingAreaService.java`)
- Booking and billing → JPA repositories: persists bookings (evidence: `src/main/java/com/smartparking/service/BookingService.java`)
- Reviews and ratings → JPA repositories: persists reviews (evidence: `src/main/java/com/smartparking/service/ReviewService.java`)
- JPA repositories → MySQL database: stores records (evidence: `README.md`)
- Parking management → Parking area model: manages listings (evidence: `src/main/java/com/smartparking/service/ParkingAreaService.java`)
- Booking and billing → Booking model: creates and updates (evidence: `src/main/java/com/smartparking/service/BookingService.java`)
- Reviews and ratings → Review model: creates reviews (evidence: `src/main/java/com/smartparking/service/ReviewService.java`)
- Registration and accounts → User model: registers users (evidence: `src/main/java/com/smartparking/service/UserService.java`)
- User identity lookup → User model: builds principal (evidence: `src/main/java/com/smartparking/security/CustomUserDetailsService.java`)
- Booking and billing → Parking area model: updates availability (evidence: `src/main/java/com/smartparking/service/BookingService.java`)
- Parking management → Role and status enums: sets listing status (evidence: `src/main/java/com/smartparking/service/ParkingAreaService.java`)
- Booking and billing → Role and status enums: sets booking status (evidence: `src/main/java/com/smartparking/service/BookingService.java`)
- User model → Parking area model: owns listings (evidence: `src/main/java/com/smartparking/entity/ParkingArea.java`)
- Booking model → User model: belongs to user (evidence: `src/main/java/com/smartparking/entity/Booking.java`)
- Booking model → Parking area model: reserves area (evidence: `src/main/java/com/smartparking/entity/Booking.java`)
- Review model → User model: authored by (evidence: `src/main/java/com/smartparking/entity/Review.java`)
- Review model → Parking area model: rates area (evidence: `src/main/java/com/smartparking/entity/Review.java`)
