# samiya-ait/portfolio architecture

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

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

## Overview

##### Project type & purpose (from file tree + README)
This repository is a **static portfolio website** (likely a personal site) consisting of:
- `index.html` → the single page (or primary entry point) of the portfolio
- `style.css` → styling for the page
- `cv.pdf` + `projets/*.pdf` → downloadable documents (CV and project PDFs)
- No backend code, no build system, no package manager, no server-side runtime indicated.

The README contains only “portfolio”, reinforcing that this is a simple static site.

##### End User / Browser
- Renders HTML/CSS
- Requests assets via HTTP(S)
- Opens/Downloads PDFs

##### Static Hosting / Web Server
- Serves `index.html`, `style.css`, and PDF files
- Examples (not in repo, but typical): GitHub Pages, Netlify, Vercel static, S3+CloudFront, Nginx/Apache

##### Static Assets (the repo contents)
- `index.html` (UI structure + links)
- `style.css` (presentation)
- `cv.pdf` (document asset)
- `projets/formation.pdf`, `projets/restaurant.pdf` (project document assets)

##### (Optional but common) DNS + TLS
- DNS resolves domain to hosting
- TLS certificate for HTTPS

##### Initial page load
- Browser → Static Host: `GET /index.html`
- Host → Browser: HTML response

##### Loading styles
- Browser → Static Host: `GET /style.css`
- Host → Browser: CSS response

##### Opening/downloading PDFs
- Browser → Static Host: `GET /cv.pdf`
- Browser → Static Host: `GET /projets/formation.pdf` (and others)
- Host → Browser: PDF response

##### Architectural pattern to highlight (what this “system” is)
This is a classic **static site architecture**:
- **Client-side rendering** (HTML/CSS only; no SPA framework indicated)
- **Content served as static files**
- **No compute layer** beyond a file server/CDN

- **Static origin** (where files live)
- **CDN/Edge cache** (optional but very common)

Because the system is small, use 2 levels so it’s still “detailed”:

Focus: who uses it and what it depends on.
- Actor: “Visitor”
- System: “Portfolio Website (Static)”
- External dependencies (optional): “DNS”, “Static Hosting Provider”

Focus: runtime containers and responsibilities.
- “Browser (Client)” container
- “Static Hosting / CDN” container
- “Static Files” container (or annotate within hosting)
- index.html
- style.css
- PDFs

- HTML page
- CSS stylesheet
- Document assets (CV + project PDFs)
This is unusual for large systems, but for this repo it’s the cleanest way to “separate into as many components as possible” without inventing services.

- **User (Visitor)**
→ uses →
- **Web Browser**
→ HTTP(S) →
- **Static Hosting (origin and/or CDN)**
→ serves →
- **index.html**
→ references →
- **style.css**
- **cv.pdf**
- **projets/formation.pdf**
- **projets/restaurant.pdf**

Optionally include:
- **DNS** (Browser queries DNS before HTTP)
- **TLS certificate** (HTTPS termination at hosting/CDN)

##### What NOT to include (to keep it accurate)
- Backend services, APIs, databases, queues
- CI/CD pipelines unless you have evidence (no workflow files shown)
- Analytics/third-party scripts unless present in `index.html` (not provided here)

- Left: User + Browser
- Center: CDN/Static Host
- Right/below: the asset set (HTML/CSS/PDFs)

This will be the most accurate and sufficiently detailed representation of the system implied by the repository.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% =====================
    %% System Context (L0)
    %% =====================
    subgraph "System Context (Level 0)"
        direction TB

        Visitor["Visitor"]:::actor
        Browser["Web Browser"]:::runtime

        DNS["DNS"]:::infra
        TLS["TLS (HTTPS)"]:::infra

        Hosting["Static Hosting / Web Server"]:::runtime
        CDN["CDN / Edge Cache (Typical)"]:::runtime

        Visitor -->|"uses"| Browser
        Browser -->|"DNS_lookup"| DNS
        Browser -->|"HTTPS_handshake"| TLS
        Browser -->|"HTTP(S)_GET"| CDN
        CDN -->|"cache_miss_fetch"| Hosting
        Hosting -->|"HTTP(S)_response"| CDN
        CDN -->|"HTTP(S)_response"| Browser
    end

    %% =====================
    %% Containers & Assets (L1/L2)
    %% =====================
    subgraph "Portfolio Website (Static) - Containers & Static Assets"
        direction TB

        subgraph "Static Hosting - Served Content"
            direction TB

            RepoRoot["Static Assets (Repository Root)"]:::repo

            subgraph "Primary Page"
                direction TB
                Index["index.html (Portfolio page)"]:::asset
            end

            subgraph "Styling"
                direction TB
                CSS["style.css (Site styling)"]:::asset
            end

            subgraph "Documents"
                direction TB
                CV["cv.pdf (Downloadable CV)"]:::asset

                ProjetsDir["projets/ (Project documents folder)"]:::repo
                Formation["formation.pdf (Project PDF)"]:::asset
                Restaurant["restaurant.pdf (Project PDF)"]:::asset
            end

            subgraph "Repository Metadata"
                direction TB
                Readme["README.md"]:::asset
            end

            RepoRoot -->|"contains"| Index
            RepoRoot -->|"contains"| CSS
            RepoRoot -->|"contains"| CV
            RepoRoot -->|"contains"| ProjetsDir
            RepoRoot -->|"contains"| Readme

            ProjetsDir -->|"contains"| Formation
            ProjetsDir -->|"contains"| Restaurant
        end
    end

    %% =====================
    %% Request/Response Flows
    %% =====================
    Browser -->|"GET_/index.html"| Hosting
    Hosting -->|"200_HTML"| Browser

    Browser -->|"GET_/style.css"| Hosting
    Hosting -->|"200_CSS"| Browser

    Browser -->|"GET_/cv.pdf"| Hosting
    Hosting -->|"200_PDF"| Browser

    Browser -->|"GET_/projets/formation.pdf"| Hosting
    Hosting -->|"200_PDF"| Browser

    Browser -->|"GET_/projets/restaurant.pdf"| Hosting
    Hosting -->|"200_PDF"| Browser

    %% =====================
    %% In-page References (dotted)
    %% =====================
    Index -.->|"references"| CSS
    Index -.->|"links_to"| CV
    Index -.->|"links_to"| Formation
    Index -.->|"links_to"| Restaurant

    %% =====================
    %% Click Events (from component_mapping)
    %% =====================
    click RepoRoot "https://github.com/samiya-ait/portfolio/tree/main/./"
    click Index "https://github.com/samiya-ait/portfolio/blob/main/./index.html"
    click CSS "https://github.com/samiya-ait/portfolio/blob/main/./style.css"
    click CV "https://github.com/samiya-ait/portfolio/blob/main/./cv.pdf"
    click ProjetsDir "https://github.com/samiya-ait/portfolio/tree/main/./projets/"
    click Formation "https://github.com/samiya-ait/portfolio/blob/main/./projets/formation.pdf"
    click Restaurant "https://github.com/samiya-ait/portfolio/blob/main/./projets/restaurant.pdf"
    click Readme "https://github.com/samiya-ait/portfolio/blob/main/./README.md"

    %% =====================
    %% Styles
    %% =====================
    classDef actor fill:#F59E0B,stroke:#92400E,stroke-width:2px,color:#111827
    classDef runtime fill:#2563EB,stroke:#1E3A8A,stroke-width:2px,color:#FFFFFF
    classDef infra fill:#10B981,stroke:#065F46,stroke-width:2px,color:#052e1f
    classDef asset fill:#E5E7EB,stroke:#374151,stroke-width:1.5px,color:#111827
    classDef repo fill:#CBD5E1,stroke:#334155,stroke-width:2px,color:#0F172A
```
