# bukyajagadishnaik/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/bukyajagadishnaik/portfolio
- Repository: https://github.com/bukyajagadishnaik/portfolio

## Overview

##### Main Components
- Frontend Client: Representing the static assets (HTML templates under app/templates, CSS files under app/static/css, JavaScript under app/static/js, and images in app/static/images).
- Flask Backend: Showing the server logic (app/__init__.py, app/routes.py) which handles HTTP requests, routing, and template rendering.
- Static Assets: Separate out the static folder, emphasizing CSS styling, JavaScript interactions, and media files (including the resume in PDF form).
- Database (SQLite): Although not directly visible in the file tree, the README notes SQLite, so include this as a component powering data such as portfolio projects, blog articles, or contact form submissions.
- Deployment: Represent the hosting environment (Render), along with potential version control integration (Git/GitHub).

##### Relationships and Interactions
- The client (web browser) sends HTTP requests to the Flask backend.
- The backend processes these requests using its routing logic (contained in app/routes.py) and serves appropriate HTML templates.
- Static content is delivered by the backend directly from the app/static directory.
- Data interactions (for example, retrieving portfolio project data or handling form inputs) occur via the SQLite database.
- Any external communication (like the contact form integration, or external APIs for blogs) should be shown as separate nodes that the Flask service interacts with.

##### Architectural Patterns and Design Principles
- MVC-like Separation: Even though Flask itself doesn’t enforce a strict MVC, your file structure indicates that views (templates), static content, and route logic are separated.
- Modular Structure: Using an application package (the app folder with an __init__.py and separate route file) promotes modular design.
- Responsive & Dynamic Content: Emphasize the separation of presentation (HTML/CSS/JS) from backend logic.
- Extensibility: The README hints at additional features like blogs, which suggests that the architecture allows for scalability.

##### Relevant Technologies
- Frontend: HTML, CSS, JavaScript, and Bootstrap.
- Backend: Python with Flask.
- Database: SQLite.
- Version Control and Deployment: Git/GitHub and Render, respectively.

## Diagram (Mermaid)

```mermaid
graph TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        Client("Client (Browser)"):::frontend
        subgraph "Frontend Assets"
            Templates("HTML Templates"):::frontend
            Static("Static Folder"):::frontend
            subgraph "Static Assets"
                CSS("CSS Files"):::frontend
                JS("JavaScript Files"):::frontend
                Images("Images & Media"):::frontend
                PDF("PDF Resume"):::frontend
            end
        end
    end

    %% Backend Layer
    subgraph "Backend Layer"
        subgraph "Flask Backend"
            Flask("Flask Server"):::backend
            Init("Initialization"):::backend
            Routes("Routing"):::backend
        end
        DB("SQLite Database"):::database
        External("External Services"):::external
        subgraph "Deployment & Version Control"
            Readme("README.md"):::devops
            Gitignore(".gitignore"):::devops
            Config("config.py"):::devops
            Requirements("requirements.txt"):::devops
            Run("run.py"):::devops
        end
    end

    %% Connections - Presentation Flow
    Client -->|"HTTP_request"| Flask
    Flask -->|"Renders"| Templates
    Flask -->|"Serves"| Static
    Static -->|"Includes"| CSS
    Static -->|"Includes"| JS
    Static -->|"Includes"| Images
    Static -->|"Includes"| PDF
    Flask -->|"Queries/Stores"| DB
    Flask -->|"Connects"| External

    %% Internal Flask Components
    Flask -->|"Uses"| Init
    Init -->|"Leads_to"| Routes

    %% Deployment & VCS Connections
    Flask -->|"Deploys_via"| Readme
    Flask -->|"Deploys_via"| Gitignore
    Flask -->|"Deploys_via"| Config
    Flask -->|"Deploys_via"| Requirements
    Flask -->|"Deploys_via"| Run

    %% Click Events for Component Mapping
    click Templates "https://github.com/bukyajagadishnaik/portfolio/tree/main/app/templates"
    click Flask "https://github.com/bukyajagadishnaik/portfolio/blob/main/app/__init__.py"
    click Init "https://github.com/bukyajagadishnaik/portfolio/blob/main/app/__init__.py"
    click Routes "https://github.com/bukyajagadishnaik/portfolio/blob/main/app/routes.py"
    click Static "https://github.com/bukyajagadishnaik/portfolio/tree/main/app/static"
    click CSS "https://github.com/bukyajagadishnaik/portfolio/tree/main/app/static/css"
    click JS "https://github.com/bukyajagadishnaik/portfolio/tree/main/app/static/js"
    click Images "https://github.com/bukyajagadishnaik/portfolio/tree/main/app/static/images"
    click PDF "https://github.com/bukyajagadishnaik/portfolio/blob/main/app/static/Bukya_jagadish_Naik_Resume.pdf"
    click Readme "https://github.com/bukyajagadishnaik/portfolio/blob/main/README.md"
    click Gitignore "https://github.com/bukyajagadishnaik/portfolio/blob/main/.gitignore"
    click Config "https://github.com/bukyajagadishnaik/portfolio/blob/main/config.py"
    click Requirements "https://github.com/bukyajagadishnaik/portfolio/blob/main/requirements.txt"
    click Run "https://github.com/bukyajagadishnaik/portfolio/blob/main/run.py"

    %% Classes and Styles
    classDef frontend fill:#FFD700,stroke:#333,stroke-width:2px;
    classDef backend fill:#ADD8E6,stroke:#333,stroke-width:2px;
    classDef database fill:#98FB98,stroke:#333,stroke-width:2px;
    classDef devops fill:#FFB6C1,stroke:#333,stroke-width:2px;
    classDef external fill:#DDA0DD,stroke:#333,stroke-width:2px;
```
