# jorgeslfreitas/portfolio architecture

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

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

## Overview

##### Project Type and Purpose
- This is a **static portfolio website** built with plain HTML, CSS, and JavaScript.
- It has no backend or database—its sole purpose is to serve personal/professional information to visitors.

##### High-Level Architecture Components
a. **Client (Browser)**
- User’s web browser (Chrome, Firefox, etc.) that renders HTML, CSS, JS.
b. **Static Web Host / CDN**
- A server or CDN (e.g., GitHub Pages, Netlify, Vercel) that delivers files over HTTPS.
c. **Static Assets**
- **index.html**: entry point.
- **CSS modules** under `assets/css/`:
- global.css (reset, base styles)
- header.css, skills.css, projects.css, forms, accordions, etc.
- **JavaScript modules** under `assets/js/`:
- acordeon.js (handles interactive accordion sections)
- **Fonts** under `assets/fonts/`:
- neue-machina-regular.otf.
- **favicon & manifest** under `assets/favicon/`.

##### Relationships and Data Flow
1. Browser issues an HTTPS GET for `index.html`.
2. `index.html` references CSS, JS, images, fonts.
3. Browser fetches those assets in parallel.
4. CSS modules style the DOM; JS modules enhance interactivity (accordion behavior).
5. Browser renders the complete UI to the user.

##### Architectural Patterns & Design Principles
- **Separation of Concerns**: HTML for structure; CSS split into feature-specific modules; JS for behavior.
- **Static-First**: Entire site is pre-built; no runtime server logic.
- **Modular Asset Organization**: Assets grouped by type and feature for maintainability.

## Diagram (Mermaid)

```mermaid
flowchart TB
    Browser["Browser"]:::browser
    Host["CDN/Static Host"]:::host

    subgraph "Static Assets"
        subgraph "HTML"
            HTML["index.html"]:::html
        end
        subgraph "Styles"
            G["global.css"]:::css
            H["header.css"]:::css
            S["skills.css"]:::css
            P["projetos.css"]:::css
            E["experience.css"]:::css
            Fm["formations.css"]:::css
            C["courses.css"]:::css
            L["languages.css"]:::css
            A["acordeon.css"]:::css
        end
        subgraph "Scripts"
            JS["acordeon.js"]:::js
        end
        subgraph "Images & Icons"
            I1["icons/"]:::img
            I2["tecnologias/"]:::img
        end
        subgraph "Fonts"
            FT["neue-machina-regular.otf"]:::font
        end
        subgraph "Favicon & Manifest"
            M["site.webmanifest"]:::asset
            T["about.txt"]:::asset
        end
    end

    Browser -->|"GET /index.html"| Host
    Host -->|"200 OK index.html"| Browser

    Browser -->|"GET /assets/css/*.css"| Host
    Host -->|"200 OK CSS files"| Browser

    Browser -->|"GET /assets/js/*.js"| Host
    Host -->|"200 OK JS files"| Browser

    Browser -->|"GET /assets/img/*"| Host
    Host -->|"200 OK Image files"| Browser

    Browser -->|"GET /assets/fonts/*"| Host
    Host -->|"200 OK Font files"| Browser

    Browser -->|"GET /assets/favicon/*"| Host
    Host -->|"200 OK Favicon files"| Browser

    click HTML "https://github.com/jorgeslfreitas/portfolio/blob/main/index.html"
    click G "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/global.css"
    click H "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/header.css"
    click S "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/skills.css"
    click P "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/projetos.css"
    click E "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/experience.css"
    click Fm "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/formations.css"
    click C "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/courses.css"
    click L "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/languages.css"
    click A "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/css/acordeon.css"
    click JS "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/js/acordeon.js"
    click I1 "https://github.com/jorgeslfreitas/portfolio/tree/main/assets/img/icons/"
    click I2 "https://github.com/jorgeslfreitas/portfolio/tree/main/assets/img/tecnologias/"
    click FT "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/fonts/neue-machina-regular.otf"
    click M "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/favicon/site.webmanifest"
    click T "https://github.com/jorgeslfreitas/portfolio/blob/main/assets/favicon/about.txt"

    classDef browser fill:#f9f,stroke:#333,stroke-width:2px
    classDef host fill:#ccc,stroke:#333,stroke-width:2px
    classDef html fill:#ffe4c4,stroke:#333,stroke-width:1px
    classDef css fill:#add8e6,stroke:#333,stroke-width:1px
    classDef js fill:#f0e68c,stroke:#333,stroke-width:1px
    classDef img fill:#98fb98,stroke:#333,stroke-width:1px
    classDef font fill:#90ee90,stroke:#333,stroke-width:1px
    classDef asset fill:#d3d3d3,stroke:#333,stroke-width:1px
```
