# bridan234/parkingbookingportal architecture

> Architecture diagram of the GitHub repository bridan234/parkingbookingportal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bridan234/parkingbookingportal
- Repository: https://github.com/bridan234/parkingbookingportal

## Overview

##### Project type and purpose
- This is a full-stack ASP.NET Core MVC web application (“ParkingBookingPortal”) that lets users reserve parking spots, processes payments via Stripe, persists data in SQL Server (Entity Framework Core) and sends confirmation emails.

##### File structure
- Top-level solution “ParkingBookingPortal.sln” contains these projects:
- PBP.Main – the ASP.NET Core MVC web UI (Controllers, Views, wwwroot static assets, Startup/Program).
- PBP.BusinessLogic – business layer (ReservationLogic, CalendarLogic, TransactionLogic, validation).
- PBP.DataAccess – data layer using EF Core (DBModel, DataRepository, appsettings.json connection strings).
- PBP.Pocos – plain-old CLR objects (domain models: ReservationPoco, CalendarPoco, TransactionPoco).
- EmailSender – reusable email service (IEmail, MailSender, RenderViewToStringAsync).
- Database folder – backup of the SQL Server database.
- Also integration artifacts: Rotativa (wkhtmltopdf) in wwwroot for PDF receipts, Stripe SDK likely referenced in BusinessLogic/TransactionLogic, static js/css in wwwroot.

##### README
- Confirms MVC + EF Core + Stripe payment gateway.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Layers
    subgraph "Client"
        Browser["Web Browser"]:::internal
    end

    subgraph "Presentation Layer"
        MVC["PBP.Main (ASP.NET Core MVC)"]:::internal
        Program["Program.cs"]:::internal
        Startup["Startup.cs"]:::internal

        subgraph "Controllers"
            HomeController["HomeController"]:::internal
            DefaultController["DefaultController"]:::internal
        end

        subgraph "Razor Views"
            Index["Index.cshtml"]:::internal
            Privacy["Privacy.cshtml"]:::internal
            TransactionSuccess["TransactionSuccessful.cshtml"]:::internal
            Layout["_Layout.cshtml"]:::internal
            LayoutMain["_LayoutMain.cshtml"]:::internal
            ErrorView["Error.cshtml"]:::internal
        end

        subgraph "Static Assets (wwwroot)"
            CSS["css/"]:::internal
            JS["js/"]:::internal
            LIB["lib/"]:::internal
            Images["Images/"]:::internal
            Rotativa["Rotativa/"]:::internal
            Picker["Multiple-Dates-Picker-for-jQuery-UI-latest/"]:::internal
        end
    end

    subgraph "Business Logic Layer"
        ReservationLogic["ReservationLogic"]:::internal
        CalendarLogic["CalendarLogic"]:::internal
        TransactionLogic["TransactionLogic"]:::internal
    end

    subgraph "Data Access Layer"
        DataRepo["DataRepository"]:::internal
        IDataRepo["IDataRepository"]:::internal
        DBModel["DBModel"]:::internal
        AppSettings["appsettings.json"]:::internal
    end

    subgraph "Domain Models"
        ReservationPoco["ReservationPoco"]:::internal
        CalendarPoco["CalendarPoco"]:::internal
        TransactionPoco["TransactionPoco"]:::internal
    end

    subgraph "Database"
        SQLServer["SQL Server\n(EF Core)"]:::db
    end

    subgraph "External Services"
        Stripe["Stripe Payment Gateway"]:::external
        EmailService["SMTP/Email Service"]:::external
        PDFGen["Rotativa PDF Generator"]:::external
    end

    %% Connections
    Browser -->|"HTTP GET/POST"| MVC
    MVC -->|"Dependency Injection"| ReservationLogic
    MVC -->|"Dependency Injection"| CalendarLogic
    MVC -->|"Dependency Injection"| TransactionLogic
    MVC -->|"serves"| CSS
    MVC -->|"serves"| JS
    MVC -->|"serves"| LIB
    MVC -->|"serves"| Images
    MVC -->|"invokes exe"| Rotativa
    MVC -->|"serves"| Picker
    MVC -->|"renders"| Index
    MVC -->|"renders"| Privacy
    MVC -->|"renders"| TransactionSuccess
    MVC -->|"renders"| Layout
    MVC -->|"renders"| LayoutMain
    MVC -->|"renders"| ErrorView

    ReservationLogic -->|"uses"| IDataRepo
    CalendarLogic -->|"uses"| IDataRepo
    TransactionLogic -->|"uses"| IDataRepo
    IDataRepo -->|"implements"| DataRepo
    DataRepo -->|"uses EF Core"| DBModel
    DataRepo -->|"reads/writes"| SQLServer
    AppSettings -.-> DataRepo

    ReservationLogic -->|"passes/returns"| ReservationPoco
    CalendarLogic -->|"passes/returns"| CalendarPoco
    TransactionLogic -->|"passes/returns"| TransactionPoco

    TransactionLogic -->|"Stripe.Charge.Create()"| Stripe
    TransactionLogic -->|"IEmail.Send()"| EmailService
    MVC -->|"PDFReceipt"| PDFGen

    %% Click events
    click MVC "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/PBP.Main.csproj"
    click Program "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Program.cs"
    click Startup "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Startup.cs"
    click HomeController "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Controllers/HomeController.cs"
    click DefaultController "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Controllers/DefaultController.cs"
    click Index "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Views/Home/Index.cshtml"
    click Privacy "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Views/Home/Privacy.cshtml"
    click TransactionSuccess "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Views/Home/TransactionSuccessful.cshtml"
    click Layout "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Views/Shared/_Layout.cshtml"
    click LayoutMain "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Views/Shared/_LayoutMain.cshtml"
    click ErrorView "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Main/Views/Shared/Error.cshtml"
    click CSS "https://github.com/bridan234/parkingbookingportal/tree/master/PBP.Main/wwwroot/css/"
    click JS "https://github.com/bridan234/parkingbookingportal/tree/master/PBP.Main/wwwroot/js/"
    click LIB "https://github.com/bridan234/parkingbookingportal/tree/master/PBP.Main/wwwroot/lib/"
    click Images "https://github.com/bridan234/parkingbookingportal/tree/master/PBP.Main/wwwroot/Images/"
    click Rotativa "https://github.com/bridan234/parkingbookingportal/tree/master/PBP.Main/wwwroot/Rotativa/"
    click Picker "https://github.com/bridan234/parkingbookingportal/tree/master/PBP.Main/wwwroot/Multiple-Dates-Picker-for-jQuery-UI-latest/"
    click ReservationLogic "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.BusinessLogic/ReservationLogic.cs"
    click CalendarLogic "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.BusinessLogic/CalendarLogic.cs"
    click TransactionLogic "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.BusinessLogic/TransactionLogic.cs"
    click DataRepo "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.DataAccess/DataRepository.cs"
    click IDataRepo "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.DataAccess/IDataRepository.cs"
    click DBModel "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.DataAccess/DBModel.cs"
    click AppSettings "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.DataAccess/appsettings.json"
    click ReservationPoco "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Pocos/ReservationPoco.cs"
    click CalendarPoco "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Pocos/CalendarPoco.cs"
    click TransactionPoco "https://github.com/bridan234/parkingbookingportal/blob/master/PBP.Pocos/TransactionPoco.cs"
    click EmailService "https://github.com/bridan234/parkingbookingportal/blob/master/EmailSender/MailSender.cs"
    click Stripe "https://github.com/bridan234/parkingbookingportal/blob/master/EmailSender/IEmail.cs"
    click PDFGen "https://github.com/bridan234/parkingbookingportal/blob/master/EmailSender/RenderViewToStringAsync.cs"
    click SQLServer "https://github.com/bridan234/parkingbookingportal/blob/master/Database/ParkingBookingPortal.bak"

    %% Styles
    classDef internal fill:#D6EAF8,stroke:#3498DB,color:#154360
    classDef external fill:#D5F5E3,stroke:#27AE60,color:#145A32
    classDef db fill:#FADBD8,stroke:#E74C3C,color:#641E16
```
