# uzairayed/maju-parking-system architecture

> Architecture diagram of the GitHub repository uzairayed/maju-parking-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/uzairayed/maju-parking-system
- Repository: https://github.com/uzairayed/maju-parking-system

## Overview

##### Project Type and Purpose
- This is a monolithic full-stack PHP/MySQL web application (no separate “frontend” and “backend” repos).
- Users interact via web pages (e.g., index.php, admin.php) to perform CRUD operations on questions.

##### File Structure
- Top-level scripts (controllers):
- index.php – landing page/login/form
- admin.php – question admin dashboard
- .php – list or view questions
- updateQue(B).php & updateQue(C).php – editing questions (two variants)
- delete.php – question deletion
- Static assets: queStyle.css, style.css
- Deployment bundle: MPS.zip, intended for XAMPP’s htdocs.
- Database interaction lives inside each PHP script using MySQL calls.

##### Extract Additional Insights from README
- Requires XAMPP (Apache + PHP + MySQL).
- Deploy by unzipping into htdocs/ and accessing via localhost.

##### Main Components & Their Relationships
a. Client Browser
– Requests PHP pages, loads CSS; submits forms.
b. Web Server & PHP Runtime (Apache + mod_php under XAMPP)
– Receives HTTP requests, invokes the appropriate .php script.
c. Application Logic Modules (the .php files)
– index.php handles authentication/landing.
– admin.php loads admin operations view.
– display.php reads and renders questions.
– updateQue(B/C).php process updates.
– delete.php handles removals.
d. MySQL Database
– Stores question data, user credentials, etc.
– Each PHP module issues SQL queries (SELECT, INSERT, UPDATE, DELETE).
e. Static File Server
– Serves CSS files (queStyle.css, style.css).

##### Architectural Patterns & Design Principles
- Monolithic structure: all code lives in one tier.
- Implicit MVC:
– Controllers = your .php scripts
– Views = embedded HTML/CSS in those scripts
– Model = MySQL tables accessed directly
- Separation of concerns is minimal; each PHP script handles both view and DB logic.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Browser["Client Browser"]:::frontend

    %% XAMPP Host Container
    subgraph "XAMPP Host"
        %% Apache + PHP Runtime
        subgraph "Apache + PHP Runtime"
            idx["index.php<br/>Authentication/Landing"]:::backend
            adm["admin.php<br/>Admin Dashboard"]:::backend
            dsp["display.php<br/>Question Listing/View"]:::backend
            upB["updateQue(B).php<br/>Question Update B"]:::backend
            upC["updateQue(C).php<br/>Question Update C"]:::backend
            del["delete.php<br/>Question Deletion"]:::backend

            subgraph "Static Assets"
                css1["queStyle.css"]:::static
                css2["style.css"]:::static
            end
        end

        %% MySQL Database
        subgraph "MySQL Database"
            db[(MySQL Database)]:::database
        end
    end

    %% Data Flows
    Browser -->|"HTTP GET index.php"| idx
    Browser -->|"HTTP GET admin.php"| adm
    Browser -->|"HTTP GET display.php"| dsp
    Browser -->|"HTTP GET updateQue(B).php"| upB
    Browser -->|"HTTP GET updateQue(C).php"| upC
    Browser -->|"HTTP GET delete.php"| del
    Browser -->|"HTTP GET CSS"| css1
    Browser -->|"HTTP GET CSS"| css2

    idx -->|"SQL SELECT/INSERT/UPDATE/DELETE"| db
    adm -->|"SQL SELECT/INSERT/UPDATE/DELETE"| db
    dsp -->|"SQL SELECT"| db
    upB -->|"SQL UPDATE"| db
    upC -->|"SQL UPDATE"| db
    del -->|"SQL DELETE"| db

    %% Click Events
    click idx "https://github.com/uzairayed/maju-parking-system/blob/main/./index.php"
    click adm "https://github.com/uzairayed/maju-parking-system/blob/main/./admin.php"
    click dsp "https://github.com/uzairayed/maju-parking-system/blob/main/./display.php"
    click upB "https://github.com/uzairayed/maju-parking-system/blob/main/./updateQue(B).php"
    click upC "https://github.com/uzairayed/maju-parking-system/blob/main/./updateQue(C).php"
    click del "https://github.com/uzairayed/maju-parking-system/blob/main/./delete.php"
    click css1 "https://github.com/uzairayed/maju-parking-system/blob/main/./queStyle.css"
    click css2 "https://github.com/uzairayed/maju-parking-system/blob/main/./style.css"
    click MPS "https://github.com/uzairayed/maju-parking-system/blob/main/./MPS.zip"
    click README "https://github.com/uzairayed/maju-parking-system/blob/main/./readme.txt"

    %% Styles
    classDef frontend fill:#D0E7FF,stroke:#005B9A,color:#005B9A
    classDef backend fill:#DFF5D0,stroke:#3A7F00,color:#3A7F00
    classDef database fill:#FFE6B3,stroke:#B36B00,color:#B36B00
    classDef static fill:#E0E0E0,stroke:#6B6B6B,color:#333333
```
