# achrafhasnaoui31/portfolio architecture

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

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

## Overview

This is a data-driven Hugo technical portfolio. The principal workflow is profile data and Markdown case studies flowing through Hugo templates into a static site for recruiters and technical reviewers; the site also provides project browsing, CV access, contact details, and lightweight navigation and animation behavior. The README documents the rendering relationships, while the sampled JavaScript shows its DOM interactions. The management CLI is included as a content-authoring tool. Unsampled template details are represented only where the README supports the relationship.

Main entry points: [`layouts/index.html`](https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/index.html) (Homepage Layout), [`layouts/partials`](https://github.com/achrafhasnaoui31/portfolio/tree/main/layouts/partials) (Shared Site Shell), [`scripts/manage.py`](https://github.com/achrafhasnaoui31/portfolio/blob/main/scripts/manage.py) (Portfolio Management CLI), [`data/portfolio.yaml`](https://github.com/achrafhasnaoui31/portfolio/blob/main/data/portfolio.yaml) (Profile Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Portfolio Content"]
  node_profile["Profile Data<br/>[portfolio.yaml]"]
  node_localized["Localized Data"]
  node_cases["Project Case Studies"]
  node_cv["Role-specific CVs"]
end

subgraph group_rendering["Hugo Rendering"]
  node_hugo{{"Hugo Generator"}}
  node_home["Homepage Layout<br/>[index.html]"]
  node_sections["Homepage Sections"]
  node_project_list["Project Listing<br/>[list.html]"]
  node_project_detail["Project Detail<br/>[single.html]"]
  node_site_shell["Shared Site Shell"]
  node_contact["Contact Section<br/>[contact.html]"]
end

subgraph group_experience["Visitor Experience"]
  node_style["Responsive Styling<br/>[style.css]"]
  node_interactions["Browser Interactions<br/>[main.js]"]
  node_published["Static Portfolio"]
end

subgraph group_authoring["Content Authoring"]
  node_manage["Portfolio Management CLI<br/>[manage.py]"]
end

node_visitor(("Portfolio Visitor"))

node_visitor -->|"views"| node_published
node_profile -->|"loads data"| node_hugo
node_localized -->|"loads data"| node_hugo
node_cases -->|"loads content"| node_hugo
node_hugo -->|"renders"| node_home
node_hugo -->|"renders"| node_project_list
node_hugo -->|"renders"| node_project_detail
node_home -->|"composes"| node_sections
node_home -->|"uses templates"| node_site_shell
node_project_list -->|"uses templates"| node_site_shell
node_project_detail -->|"uses templates"| node_site_shell
node_hugo -->|"generates"| node_published
node_style -->|"styles"| node_published
node_interactions -->|"enhances"| node_published
node_cv -->|"provides downloads"| node_published
node_contact -->|"presents contact"| node_published
node_manage -->|"updates data"| node_profile
node_manage -->|"creates case studies"| node_cases
node_visitor -->|"uses controls"| node_interactions

click node_profile "https://github.com/achrafhasnaoui31/portfolio/blob/main/data/portfolio.yaml"
click node_localized "https://github.com/achrafhasnaoui31/portfolio/tree/main/data"
click node_cases "https://github.com/achrafhasnaoui31/portfolio/tree/main/content/projects"
click node_home "https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/index.html"
click node_sections "https://github.com/achrafhasnaoui31/portfolio/tree/main/layouts/partials/sections"
click node_project_list "https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/projects/list.html"
click node_project_detail "https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/projects/single.html"
click node_site_shell "https://github.com/achrafhasnaoui31/portfolio/tree/main/layouts/partials"
click node_style "https://github.com/achrafhasnaoui31/portfolio/blob/main/static/css/style.css"
click node_interactions "https://github.com/achrafhasnaoui31/portfolio/blob/main/static/js/main.js"
click node_cv "https://github.com/achrafhasnaoui31/portfolio/tree/main/static/cv"
click node_contact "https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/partials/sections/contact.html"
click node_manage "https://github.com/achrafhasnaoui31/portfolio/blob/main/scripts/manage.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_profile,node_localized,node_cases,node_cv toneBlue
class node_hugo,node_home,node_sections,node_project_list,node_project_detail,node_site_shell,node_contact toneAmber
class node_style,node_interactions,node_published toneMint
class node_manage toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio Content

- [Profile Data](https://github.com/achrafhasnaoui31/portfolio/blob/main/data/portfolio.yaml): `data/portfolio.yaml`
- [Localized Data](https://github.com/achrafhasnaoui31/portfolio/tree/main/data): `data`
- [Project Case Studies](https://github.com/achrafhasnaoui31/portfolio/tree/main/content/projects): `content/projects`
- [Role-specific CVs](https://github.com/achrafhasnaoui31/portfolio/tree/main/static/cv): `static/cv`

### Hugo Rendering

- **Hugo Generator**
- [Homepage Layout](https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/index.html): `layouts/index.html`
- [Homepage Sections](https://github.com/achrafhasnaoui31/portfolio/tree/main/layouts/partials/sections): `layouts/partials/sections`
- [Project Listing](https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/projects/list.html): `layouts/projects/list.html`
- [Project Detail](https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/projects/single.html): `layouts/projects/single.html`
- [Shared Site Shell](https://github.com/achrafhasnaoui31/portfolio/tree/main/layouts/partials): `layouts/partials`
- [Contact Section](https://github.com/achrafhasnaoui31/portfolio/blob/main/layouts/partials/sections/contact.html): `layouts/partials/sections/contact.html`

### Visitor Experience

- [Responsive Styling](https://github.com/achrafhasnaoui31/portfolio/blob/main/static/css/style.css): `static/css/style.css`
- [Browser Interactions](https://github.com/achrafhasnaoui31/portfolio/blob/main/static/js/main.js): `static/js/main.js`
- **Static Portfolio**

### Content Authoring

- [Portfolio Management CLI](https://github.com/achrafhasnaoui31/portfolio/blob/main/scripts/manage.py): `scripts/manage.py`

### Other components

- **Portfolio Visitor**

## Connections

- Portfolio Visitor → Static Portfolio: views (evidence: `README.md`)
- Profile Data → Hugo Generator: loads data (evidence: `README.md`)
- Localized Data → Hugo Generator: loads data (evidence: `README.md`)
- Project Case Studies → Hugo Generator: loads content (evidence: `README.md`)
- Hugo Generator → Homepage Layout: renders (evidence: `README.md`)
- Hugo Generator → Project Listing: renders (evidence: `README.md`)
- Hugo Generator → Project Detail: renders (evidence: `README.md`)
- Homepage Layout → Homepage Sections: composes (evidence: `README.md`)
- Homepage Layout → Shared Site Shell: uses templates (evidence: `README.md`)
- Project Listing → Shared Site Shell: uses templates (evidence: `README.md`)
- Project Detail → Shared Site Shell: uses templates (evidence: `README.md`)
- Hugo Generator → Static Portfolio: generates (evidence: `README.md`)
- Responsive Styling → Static Portfolio: styles (evidence: `README.md`)
- Browser Interactions → Static Portfolio: enhances (evidence: `README.md`)
- Role-specific CVs → Static Portfolio: provides downloads (evidence: `README.md`)
- Contact Section → Static Portfolio: presents contact (evidence: `README.md`)
- Portfolio Management CLI → Profile Data: updates data (evidence: `scripts/manage.py`)
- Portfolio Management CLI → Project Case Studies: creates case studies (evidence: `scripts/manage.py`)
- Portfolio Visitor → Browser Interactions: uses controls (evidence: `static/js/main.js`)
