# navarro-n/portfolio-react architecture

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

- Interactive diagram: https://gitdiagram.com/navarro-n/portfolio-react
- Repository: https://github.com/navarro-n/portfolio-react

## Overview

##### Qué tipo de proyecto es y para qué sirve (según árbol + README)

**Tipo:** aplicación **frontend pura** (SPA) hecha con **React + Vite**.
**Propósito:** portfolio personal con una UI tipo “escritorio” (desktop metaphor) con **iconos** y **ventanas** (About, Projects, PDF/CV, Calculator, etc.).
**Backend:** explícitamente **no hay** (“frontend puro, sin backend”).
**Datos:** provienen de ficheros locales en `src/data/*` (no hay API, no hay DB).

Esto determina cómo debe verse un diagrama “preciso”: no es una arquitectura cliente-servidor clásica, sino **una arquitectura de UI por capas** (entrypoint → layout → desktop → window manager/ventanas → componentes) más una capa de **build tooling** (Vite/Tailwind/PostCSS).

##### Cómo leer la estructura del repo (y cómo convertirla en componentes del diagrama)

Tu “mapa” real está prácticamente todo en `portolio-react/src`:

##### Entry / Bootstrap
- `src/main.jsx`: **punto de entrada** React (createRoot, mounting).
- `src/index.css`: estilos globales.
- `src/app/App.jsx` + `src/app/App.css`: **raíz de la app** (componente top-level).

##### Sistema (chrome / UI shell)
- `src/system/Header/*`
- `src/system/Footer/*`
Esto es el “marco” persistente, separado del contenido.

##### “Desktop” (workspace)
- `src/desktop/Desktop.jsx` + `.module.css`: área principal donde viven los iconos y se abren las ventanas.

##### Iconos (launcher)
- `src/data/desktopIcons.js`: **modelo** de iconos (labels, ids, qué ventana abren, etc.).

##### Ventanas (core UX del portfolio)
- `src/windows/Window.jsx` + `.module.css`: **componente genérico** de ventana (título, close, drag, z-index, etc.).
- Ventanas concretas:
- `AboutWindow.jsx`
- `ProjectsWindow.jsx` (+ `.module.css`)
- `PdfWindow.jsx` (abre `public/cv_Irene-Pinillos-Navarro.pdf`)
- `CalculatorWindow.jsx` (+ `.module.css`)
- Componente app dentro de ventana:
- `src/components/Calculator/Calculator.jsx` (+ `.module.css`)

##### Hooks (interacción clave del desktop)
- `src/hooks/useDoubleClick.js`: interacción para abrir iconos con doble click.
- `src/hooks/useDrag.js`: interacción para **arrastrar ventanas** o elementos.

##### Datos estáticos (contenido del portfolio)
- `src/data/projects.js`: listado de proyectos.
- `src/data/themes.js`: temas / estilos.
- `src/data/desktopIcons.js`: iconos del “escritorio”.

##### Build / Tooling / Config (no runtime, pero sí arquitectura de entrega)
- `vite.config.js`: bundling/dev server.
- `tailwind.config.js`, `postcss.config.cjs`: pipeline CSS (aunque usas mucho CSS Modules).
- `eslint.config.js`: calidad/lint.
- `index.html`: template base Vite.
- `public/cv_*.pdf`: asset servido estáticamente (sin import, vía URL).

##### Qué diagramas dibujar para que sea “lo más exacto” (y no quedarte corto)

Para este proyecto conviene **2 niveles** (mínimo) y **3** si quieres máxima precisión:

##### Diagrama “Container / Deployment” (estilo C4 – nivel contenedor)
En este caso “containers” no son microservicios; son **bloques de entrega**:

**Nodos recomendados:**
##### Static Hosting / Web Server (opcional en tu repo, pero real en producción)
- Sirve `index.html`, `assets/*.js/*.css`, y `public/cv_*.pdf`
##### React SPA (Portfolio React)
- Renderiza UI, maneja estado y eventos
##### Build Toolchain (Vite + Node + npm) (como “offline/build-time”)
- Produce el bundle estático

**Flechas clave:**
- User → Browser: interacción (click/doble click/drag).
- Browser → Static Hosting: GET `index.html`, `*.js`, `*.css`, `cv.pdf`.
- Browser ↔ React SPA: render y event loop.
- Dev Machine → Vite Dev Server (en dev): HMR/serving.

> Nota: Como no hay backend ni API, **no dibujes** DB/REST/GraphQL salvo como “none / not present”.

##### Diagrama “Component / Runtime architecture” (lo más importante aquí)
Este es el diagrama donde capturas la arquitectura real: **jerarquía y dependencias** de componentes.

**Backbone recomendado (cajas grandes):**
- `main.jsx` (Bootstrap)
→ `App` (Root)
→ `DesktopLayout`
→ `Header`
→ `Desktop`
→ `DesktopIcon` (N instancias, desde `desktopIcons.js`)
→ `Window` (contenedor común)
→ `AboutWindow` / `ProjectsWindow` / `PdfWindow` / `CalculatorWindow`
→ (en CalculatorWindow) `Calculator`
→ `Footer`

**Módulos de soporte (en cajas laterales):**
- `hooks/useDoubleClick` usado por `DesktopIcon` (o Desktop).
- `hooks/useDrag` usado por `Window` (o ventanas).
- `data/projects`, `data/themes`, `data/desktopIcons` consumidos por ventanas/layout/desktop.
- `public/cv_*.pdf` consumido por `PdfWindow` (URL directa).

**Flechas importantes (dirección = “depende de / usa”):**
- `Desktop` → `desktopIcons.js` (para mapear iconos)
- `DesktopIcon` → `useDoubleClick` (para abrir)
- `Window` → `useDrag` (para mover)
- `ProjectsWindow` → `projects.js`
- `App` o `Desktop` → “Window State” (estado de ventanas abiertas, foco, z-index)

> Aquí es donde debes “separar en tantos componentes como sea posible”: cada carpeta top-level en `src/` es un bloque. Dentro de `windows/` y `system/` conviene detallar cada ventana/componente.

##### Diagrama “State & Event Flow” (muy útil para esta UI)
Este proyecto tiene una interacción tipo desktop; aunque no haya backend, **sí hay flujos**:

**Eventos:**
- Doble click en `DesktopIcon`
- Drag en `Window` (mouse down/move/up)
- Close window

**Estado típico a dibujar (aunque no veamos el código exacto, el diagrama debe reservarlo):**
- `openWindows[]` (qué ventanas están abiertas)
- `activeWindowId` (foco)
- `zIndexMap` (orden de apilado)
- `windowPositions` (x,y por ventana)
- `theme` (si aplica desde `themes.js`)

**Flechas:**
- User action → Component event handler → Hook (si aplica) → setState → re-render → UI update

Esto hace que el diagrama sea “arquitectura real” y no solo un árbol de componentes.

##### Patrones/diseño arquitectónico presentes (y cómo reflejarlos)

- **UI Shell + Workspace pattern:** `Header/Footer` (shell) + `Desktop` (workspace).
- **Window Manager pattern (implícito):** `Window.jsx` como primitive reusable + ventanas concretas como contenido.
- **Presentational vs Data modules:** `src/data/*` como fuente de contenido estático (sin fetch).
- **Custom hooks para interacción avanzada:** `useDrag`, `useDoubleClick` como capa reutilizable de comportamiento.

En el diagrama, marca estos como “primitives” o “shared behavior”.

##### Qué tecnologías etiquetar explícitamente en el diagrama

Como es frontend-only, sí compensa etiquetar:
- **React** (UI runtime)
- **Vite** (build + dev server)
- **CSS Modules** (aparece en muchos `*.module.css`)
- **Tailwind/PostCSS** (por configs; aunque no se vea en el árbol de CSS, existe el pipeline)
- **Static assets** desde `public/` (PDF CV)

##### Convenciones visuales (para que el diagrama sea claro y “engineering-grade”)

- Azul: componentes React (App/Layout/Desktop/Windows)
- Gris: módulos de soporte (hooks, data)
- Verde: assets estáticos (`public/cv...pdf`)
- Naranja: tooling/build (Vite, PostCSS, Tailwind, ESLint)
- (Opcional) Borde punteado para “build-time only” vs borde sólido “runtime”.

**Etiquetado mínimo por caja:**
- Nombre del módulo (`Window.jsx`)
- Rol (“Generic window container”, “Static data source”)
- Inputs/outputs si aplica (ej: `projects.js` → `ProjectsWindow`)

**Flechas:**
- Sólida: “import/uses”
- Discontinua: “served as asset” o “builds into”
- Flechas con texto para eventos: “double click”, “drag”, “close”.

##### En `windows/`, separa
- `Window` (primitiva)
- ventanas específicas (About/Projects/Pdf/Calculator)
##### Añade un bloque “State (Window Manager)” aunque no haya store dedicado
- dónde vive el estado (App o Desktop) y qué gestiona.
##### Añade “Toolchain” (Vite/Tailwind/PostCSS) como capa build-time.
7. Verifica que **no aparece ninguna** caja de API/DB (porque el README dice que no hay backend).

##### Plantilla rápida (estructura final sugerida del diagrama)

**Nivel 1:**
- User → Browser
- Browser → Static Hosting (serves SPA + PDF)
- Browser runs React SPA

**Nivel 2 (dentro de “React SPA”):**
- main.jsx → App → DesktopLayout
- Header
- Desktop
- DesktopIcon (uses useDoubleClick, reads desktopIcons)
- Window (uses useDrag)
- AboutWindow
- ProjectsWindow (reads projects)
- PdfWindow (opens /cv.pdf)
- CalculatorWindow → Calculator
- Footer
- Side modules: data/*, hooks/*, styles (CSS Modules/global)

Con esto capturas el 95% de la arquitectura real del repo, sin inventarte backend, y separando el sistema en la máxima cantidad de componentes útiles.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% ============== Level A: Container / Delivery ==============
  subgraph "Deployment / Delivery (Frontend-only)"
    U["User"]:::external
    B["Browser"]:::external
    H["Static Hosting / Web Server"]:::infra
    SPA["React SPA (Runtime)"]:::runtime
    PDF["Static Asset: CV (PDF)"]:::asset

    U -->|"interacts (click / doubleclick / drag)"| B
    B -->|"GET index.html + assets (js/css)"| H
    H -->|"serves SPA"| B
    H -.->|"serves /cv_Irene-Pinillos-Navarro.pdf"| PDF
    B -->|"opens PDF (url)"| PDF
    B <-->|"renders + event loop"| SPA
  end

  %% ============== Level B: Build / Tooling ==============
  subgraph "Build-time Toolchain (no runtime backend)"
    DEV["Dev Machine / CI"]:::external
    VITE["Vite (dev + build)"]:::tooling
    HTML["Vite Template: index.html"]:::tooling
    VCFG["vite.config.js"]:::tooling
    TW["tailwind.config.js"]:::tooling
    PC["postcss.config.cjs"]:::tooling
    ESL["eslint.config.js"]:::tooling

    DEV -->|"npm run (dev / build / lint)"| VITE
    VITE -->|"uses"| HTML
    VITE -->|"reads"| VCFG
    VITE -->|"css pipeline"| TW
    VITE -->|"css pipeline"| PC
    DEV -->|"lint"| ESL
    VITE -.->|"builds to static assets"| H
  end

  %% ============== Level C: Runtime Component Architecture ==============
  subgraph "React Component Runtime (UI layers)"
    MAIN["main.jsx (Bootstrap: createRoot)"]:::runtime
    GSTYLE["index.css (Global Styles)"]:::cssStyle
    APP["App.jsx (App Root)"]:::react
    APPCSS["App.css (Root Styles)"]:::cssStyle

    MAIN -->|"mounts"| APP
    GSTYLE -->|"global styles"| APP
    APPCSS -->|"styles"| APP

    subgraph "UI Shell + Workspace Pattern"
      LAYOUT["DesktopLayout.jsx (UI Frame / Layout)"]:::react
      LAYOUTCSS["DesktopLayout.module.css"]:::cssStyle

      HEADER["Header.jsx (UI Shell)"]:::react
      HEADERCSS["Header.module.css"]:::cssStyle
      FOOTER["Footer.jsx (UI Shell)"]:::react
      FOOTERCSS["Footer.module.css"]:::cssStyle

      DESKTOP["Desktop.jsx (Workspace)"]:::react
      DESKTOPCSS["Desktop.module.css"]:::cssStyle

      APP -->|"renders"| LAYOUT
      LAYOUTCSS -->|"styles"| LAYOUT

      LAYOUT -->|"contains"| HEADER
      LAYOUT -->|"contains"| DESKTOP
      LAYOUT -->|"contains"| FOOTER

      HEADERCSS -->|"styles"| HEADER
      FOOTERCSS -->|"styles"| FOOTER
      DESKTOPCSS -->|"styles"| DESKTOP
    end

    subgraph "Launcher: Desktop Icons"
      ICON["DesktopIcon.jsx (Launcher Icon)"]:::react
      ICONCSS["DesktopIcon.module.css"]:::cssStyle
      ICONS_DATA["desktopIcons.js (Static Model)"]:::data
      DCLICK["useDoubleClick.js (Hook)"]:::hook

      DESKTOP -->|"maps from"| ICONS_DATA
      DESKTOP -->|"renders (N)"| ICON
      ICONCSS -->|"styles"| ICON
      ICON -->|"uses"| DCLICK
      ICON -->|"double click -> open window"| WM
    end

    subgraph "Window Manager + Windows (Core UX)"
      WM["Window State (Manager: openWindows + zIndex + positions + activeId)"]:::state

      WIN["Window.jsx (Generic Window Primitive)"]:::react
      WINCSS["Window.module.css"]:::cssStyle
      DRAG["useDrag.js (Hook)"]:::hook

      ABOUT["AboutWindow.jsx"]:::react
      ABOUTCSS["AboutWindow.module.css"]:::cssStyle

      PROJ["ProjectsWindow.jsx"]:::react
      PROJCSS["ProjectsWindow.module.css"]:::cssStyle
      PROJDATA["projects.js (Static Data)"]:::data

      PDFW["PdfWindow.jsx"]:::react

      CALCW["CalculatorWindow.jsx"]:::react
      CALCWCSS["CalculatorWindow.module.css"]:::cssStyle
      CALC["Calculator.jsx (App Inside Window)"]:::react
      CALCCSS["Calculator.module.css"]:::cssStyle

      APP -->|"owns / provides state"| WM
      DESKTOP -->|"reads / writes"| WM

      WM -->|"renders windows"| WIN
      WINCSS -->|"styles"| WIN
      WIN -->|"uses"| DRAG
      WIN -->|"drag -> update positions"| WM
      WIN -->|"focus -> update active + zIndex"| WM
      WIN -->|"close -> remove from openWindows"| WM

      WIN -->|"hosts"| ABOUT
      ABOUTCSS -->|"styles"| ABOUT

      WIN -->|"hosts"| PROJ
      PROJCSS -->|"styles"| PROJ
      PROJ -->|"reads"| PROJDATA

      WIN -->|"hosts"| PDFW
      PDFW -.->|"opens static asset"| PDF

      WIN -->|"hosts"| CALCW
      CALCWCSS -->|"styles"| CALCW
      CALCW -->|"contains"| CALC
      CALCCSS -->|"styles"| CALC
    end

    subgraph "Static Content Modules (No API / No DB)"
      THEMES["themes.js (Themes)"]:::data
      THEMES -->|"theme tokens"| APP
    end
  end

  %% ============== Click events from component_mapping ==============
  click MAIN "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/main.jsx"
  click GSTYLE "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/index.css"
  click APP "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/app/App.jsx"
  click APPCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/app/App.css"

  click LAYOUT "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/layouts/DesktopLayout.jsx"
  click LAYOUTCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/layouts/DesktopLayout.module.css"

  click HEADER "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/system/Header/Header.jsx"
  click HEADERCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/system/Header/Header.module.css"
  click FOOTER "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/system/Footer/Footer.jsx"
  click FOOTERCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/system/Footer/Footer.module.css"

  click DESKTOP "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/desktop/Desktop.jsx"
  click DESKTOPCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/desktop/Desktop.module.css"

  click ICON "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/icons/DesktopIcon.jsx"
  click ICONCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/icons/DesktopIcon.module.css"
  click ICONS_DATA "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/data/desktopIcons.js"

  click WIN "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/Window.jsx"
  click WINCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/Window.module.css"

  click ABOUT "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/AboutWindow.jsx"
  click ABOUTCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/AboutWindow.module.css"
  click PROJ "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/ProjectsWindow.jsx"
  click PROJCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/ProjectsWindow.module.css"
  click PDFW "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/PdfWindow.jsx"
  click CALCW "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/CalculatorWindow.jsx"
  click CALCWCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/windows/CalculatorWindow.module.css"

  click CALC "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/components/Calculator/Calculator.jsx"
  click CALCCSS "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/components/Calculator/Calculator.module.css"

  click DCLICK "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/hooks/useDoubleClick.js"
  click DRAG "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/hooks/useDrag.js"

  click PROJDATA "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/data/projects.js"
  click THEMES "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/src/data/themes.js"

  click PDF "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/public/cv_Irene-Pinillos-Navarro.pdf"

  click HTML "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/index.html"
  click VCFG "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/vite.config.js"
  click TW "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/tailwind.config.js"
  click PC "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/postcss.config.cjs"
  click ESL "https://github.com/navarro-n/portfolio-react/blob/main/portolio-react/eslint.config.js"

  %% ============== Styles ==============
  classDef external fill:#ffffff,stroke:#111827,stroke-width:1px,color:#111827
  classDef infra fill:#eef2ff,stroke:#3730a3,stroke-width:1px,color:#111827
  classDef runtime fill:#dbeafe,stroke:#1d4ed8,stroke-width:1.2px,color:#0b1220
  classDef react fill:#bfdbfe,stroke:#1d4ed8,stroke-width:1.2px,color:#0b1220
  classDef state fill:#fde68a,stroke:#b45309,stroke-width:1.2px,color:#111827
  classDef hook fill:#e5e7eb,stroke:#374151,stroke-width:1px,color:#111827
  classDef data fill:#e5e7eb,stroke:#374151,stroke-width:1px,color:#111827
  classDef asset fill:#bbf7d0,stroke:#166534,stroke-width:1.2px,color:#052e16
  classDef tooling fill:#fed7aa,stroke:#c2410c,stroke-width:1.1px,color:#111827
  classDef cssStyle fill:#f3f4f6,stroke:#6b7280,stroke-width:1px,color:#111827
```
