# nassim1014/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a single-service, full-stack portfolio web app built with Python and Streamlit.
- The user-facing portion is a Streamlit frontend. Internally it uses an MVC-style separation: models hold data, controllers drive business logic, views render UI.

##### File structure
- Top-level
- .devcontainer/ : VS Code remote-container definitions
- .github/workflows/deploy.yml : CI/CD pipeline (deploy step)
- .streamlit/config.toml : Streamlit server config
- portfolio.py : app entry point (router)
- requirements.txt : Python dependencies
- style.css : custom styling
- utils.py : shared helper functions
- src/
- about_me.py, contact.py, skills.py : single-purpose pages or data loaders
- controllers/ : certificate_controller.py, experience_controller.py, projects_controller.py, skill_controller.py
- models/ : certificate.py, experience.py, project.py, skill.py
- views/ : certificate_view.py, experience_view.py, project_view.py, skill_view.py

##### (minimal) README
- Title “portfolio” confirms it is a personal portfolio presentation. No further architecture details are provided.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Streamlit Service
    subgraph "Front-End & Back-End (Streamlit Service)"
        direction TB
        ENTRY["portfolio.py"]:::entry
        UTILS["utils.py"]:::util

        subgraph "Page Dispatchers"
            direction TB
            About["about_me.py"]:::entry
            Contact["contact.py"]:::entry
            SkillsPage["skills.py"]:::entry
        end

        subgraph "Controllers"
            direction TB
            CertC["CertificateController"]:::controller
            ExpC["ExperienceController"]:::controller
            ProjC["ProjectsController"]:::controller
            SkillC["SkillController"]:::controller
        end

        subgraph "Models"
            direction TB
            CertM["CertificateModel"]:::model
            ExpM["ExperienceModel"]:::model
            ProjM["ProjectModel"]:::model
            SkillM["SkillModel"]:::model
        end

        subgraph "Views"
            direction TB
            CertV["CertificateView"]:::view
            ExpV["ExperienceView"]:::view
            ProjV["ProjectView"]:::view
            SkillV["SkillView"]:::view
        end

        ENTRY -->|dispatches to| About
        ENTRY -->|dispatches to| Contact
        ENTRY -->|dispatches to| SkillsPage
        ENTRY -->|uses| UTILS

        About -->|calls| CertC
        Contact -->|calls| ExpC
        SkillsPage -->|calls| SkillC

        CertC -->|retrieves data from| CertM
        ExpC -->|retrieves data from| ExpM
        ProjC -->|retrieves data from| ProjM
        SkillC -->|retrieves data from| SkillM

        CertC -->|passes data to| CertV
        ExpC -->|passes data to| ExpV
        ProjC -->|passes data to| ProjV
        SkillC -->|passes data to| SkillV

        CertV -->|render UI to| User
        ExpV -->|render UI to| User
        ProjV -->|render UI to| User
        SkillV -->|render UI to| User
    end

    %% User
    User["User (Browser)"]:::external
    User -->|interacts with| ENTRY

    %% Static Assets
    subgraph "Static Assets"
        direction TB
        CSS["style.css"]:::static
        Images["images/"]:::static
    end
    CertV -->|applies| CSS
    ExpV -->|applies| CSS
    ProjV -->|applies| CSS
    SkillV -->|applies| CSS

    CertV -->|loads| Images
    ExpV -->|loads| Images
    ProjV -->|loads| Images
    SkillV -->|loads| Images

    %% Infrastructure & CI/CD
    subgraph "Infra & CI/CD"
        direction TB
        DevC["DevContainer"]:::infra
        CI["GitHub Actions (deploy.yml)"]:::infra
    end
    CI -->|builds & deploys container| DevC
    DevC -->|provides env for| ENTRY

    %% Click Events
    click ENTRY "https://github.com/nassim1014/portfolio/blob/main/portfolio.py"
    click About "https://github.com/nassim1014/portfolio/blob/main/src/about_me.py"
    click Contact "https://github.com/nassim1014/portfolio/blob/main/src/contact.py"
    click SkillsPage "https://github.com/nassim1014/portfolio/blob/main/src/skills.py"
    click CertC "https://github.com/nassim1014/portfolio/blob/main/src/controllers/certificate_controller.py"
    click ExpC "https://github.com/nassim1014/portfolio/blob/main/src/controllers/experience_controller.py"
    click ProjC "https://github.com/nassim1014/portfolio/blob/main/src/controllers/projects_controller.py"
    click SkillC "https://github.com/nassim1014/portfolio/blob/main/src/controllers/skill_controller.py"
    click CertM "https://github.com/nassim1014/portfolio/blob/main/src/models/certificate.py"
    click ExpM "https://github.com/nassim1014/portfolio/blob/main/src/models/experience.py"
    click ProjM "https://github.com/nassim1014/portfolio/blob/main/src/models/project.py"
    click SkillM "https://github.com/nassim1014/portfolio/blob/main/src/models/skill.py"
    click CertV "https://github.com/nassim1014/portfolio/blob/main/src/views/certificate_view.py"
    click ExpV "https://github.com/nassim1014/portfolio/blob/main/src/views/experience_view.py"
    click ProjV "https://github.com/nassim1014/portfolio/blob/main/src/views/project_view.py"
    click SkillV "https://github.com/nassim1014/portfolio/blob/main/src/views/skill_view.py"
    click UTILS "https://github.com/nassim1014/portfolio/blob/main/utils.py"
    click CSS "https://github.com/nassim1014/portfolio/blob/main/style.css"
    click Images "https://github.com/nassim1014/portfolio/tree/main/images/"
    click DevC "https://github.com/nassim1014/portfolio/blob/main/.devcontainer/devcontainer.json"
    click CI "https://github.com/nassim1014/portfolio/blob/main/.github/workflows/deploy.yml"

    %% Styles
    classDef entry fill:#9ae6b4,stroke:#2f855a,color:#1a202c
    classDef controller fill:#bee3f8,stroke:#2b6cb0,color:#2a4365
    classDef model fill:#bee3f8,stroke:#2b6cb0,color:#2a4365
    classDef view fill:#bee3f8,stroke:#2b6cb0,color:#2a4365
    classDef util fill:#fefcbf,stroke:#d69e2e,color:#975a16
    classDef static fill:#faf089,stroke:#d69e2e,color:#744210
    classDef infra fill:#e2e8f0,stroke:#4a5568,color:#2d3748
    classDef external fill:#f0fff4,stroke:#38a169,color:#22543d
```
