# eduarsene/my-lp architecture

> Architecture diagram of the GitHub repository eduarsene/my-lp, 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/eduarsene/my-lp
- Repository: https://github.com/eduarsene/my-lp

## Overview

##### Tipo y propósito del proyecto (lo que el diagrama debe reflejar)
Este repo es una **Single Page Application (SPA) de portafolio personal** construida con **React + Vite**, estilada con **TailwindCSS** (vía PostCSS) y con animaciones usando **Framer Motion** (y algunos “motion primitives” en `/components/motion-primitives`).
No hay backend propio ni base de datos: es un **sitio estático** que consume **datos locales** (JS/imagenes/pdf) y se despliega (según README) en **GitHub Pages**.

Tu diagrama, por lo tanto, debe priorizar:
- **Pipeline de build/deploy** (Vite → assets estáticos → GitHub Pages)
- **Arquitectura de UI por secciones** (Hero/About/Experience/Projects/Contact)
- **Capa de datos local** (archivos `Data*.js`, íconos, assets en `/src/assets`, `public/cv.pdf`)
- **Integraciones externas “por navegación”** (links a LinkedIn, repos, etc.), más que APIs.

##### Raíz / tooling
- `index.html`: entry HTML de Vite.
- `package.json`, `package-lock.json`: dependencias (React, Tailwind, Framer Motion, etc.).
- `vite.config.js`: configuración de build y base path (importante para GitHub Pages).
- `postcss.config.js`: pipeline CSS (Tailwind/autoprefixer típicamente).
- `eslint.config.js`: linting (no es runtime, pero sí parte de “dev toolchain”).
- `public/cv.pdf`: asset público servido directo (ruta estable).

##### Código app (runtime)
- `src/main.jsx`: entry JS, monta React en el DOM.
- `src/App.jsx` + `src/App.css`: composición principal de la UI.
- `src/index.css`: estilos globales (probable Tailwind directives).
- `src/components/sections/*`: secciones principales de la landing:
- `HeroSection.jsx`, `AboutMeSection.jsx`, `Experience.jsx`, `Projects.jsx`, `ContanctMe.jsx`, `header.jsx`
- `src/components/ui/*`: componentes reutilizables UI:
- `Buttonn.jsx`, `IconItem.jsx`, `puntero.jsx`
- `src/components/Data/*`: “modelo” local / constantes:
- `DataProjects.js`, `IconsProjects.js`, `IconsSvg.js`
- `src/assets/img/...`: imágenes para experience/projects/etc.

##### “components” fuera de src
- `/components/motion-primitives/text-effect.tsx`: componente de animación/efecto (posible import vía alias o copiado). En el diagrama conviene tratarlo como **UI animation primitive** (parte de la capa de presentación).

##### Qué interacciones reales hay (para flechas y flows)
En esta app el “flujo” típico es:
##### `App.jsx` compone Sections; cada sección usa
- **UI components** (`src/components/ui`)
- **Data modules** (`src/components/Data`)
- **Assets** (`src/assets`, `public/cv.pdf`)
- **Animations** (Framer Motion / `motion-primitives`)
##### Interacciones
- Navegación interna (scroll/anchors) entre secciones
- Clicks a links externos (LinkedIn, GitHub, demo, etc.)
- Descarga/visualización de `public/cv.pdf`

No hay llamadas a servicios externos tipo REST (al menos no evidentes por tree/README). Si en código existieran, se añaden como “External APIs”.

##### Diagrama A — System Context (C4 nivel 1)
**Objetivo**: mostrar el sistema y sus dependencias externas.
Incluye:
- **Actor**: “Visitor / Recruiter (Browser)”
- **System**: “Eduardo Portfolio SPA (React)”
- **External systems** (como cajas externas):
- “GitHub Pages (Static Hosting/CDN)”
- “LinkedIn” (solo como destino de enlace)
- “GitHub Repository / Projects links” (destinos de enlace)
- Flechas:
- Browser → GitHub Pages: HTTP GET estáticos
- GitHub Pages → Browser: HTML/CSS/JS/Images/PDF
- Browser → LinkedIn/GitHub: navegación externa (click)

##### Diagrama B — Container / Runtime (C4 nivel 2)
**Objetivo**: descomponer la SPA en contenedores lógicos.
Contenedores sugeridos:
- **Static Hosting**: GitHub Pages
- **SPA Bundle**:
- Entry: `index.html`
- React bootstrap: `src/main.jsx`
- App shell: `src/App.jsx`
- **Presentation layer**:
- Sections (`src/components/sections/*`)
- UI components (`src/components/ui/*`)
- Animation primitives (Framer Motion + `components/motion-primitives/text-effect.tsx`)
- **Content/Data layer (local)**:
- Projects data (`src/components/Data/DataProjects.js`)
- **Static assets**:
- Images (`src/assets/img/...`)
- Public file (`public/cv.pdf`)

Flechas (direccionales):
- `main.jsx` → `App.jsx`
- `App.jsx` → `sections/*`
- `sections/*` → `ui/*`
- `sections/Projects.jsx` → `DataProjects.js` (y `IconsProjects.js` si aplica)
- `sections/*` → `assets/img/*`
- “Contact/CTA” → `public/cv.pdf` (download/open)
- “Animations” → (usado por) sections/ui (dependencia)

##### Diagrama C — Build & Deploy pipeline (recomendado para este proyecto)
**Objetivo**: mostrar cómo llega el código al hosting.
Nodos:
- Developer machine
- `npm run dev` (Vite dev server) para local
- `npm run build` (Vite build) → output `dist/` (aunque no esté en repo)
- GitHub Actions (si existe; no se ve en tree, pero GitHub Pages suele usarse con action o deploy manual)
- GitHub Pages
Flechas:
- Code → Build → Static artifacts → Deploy → Hosting

Si no hay workflow en repo, dibuja “Deploy (manual o GH Pages pipeline)” como una caja semitransparente/“out of scope” para no inventar.

##### Patrones/decisiones arquitectónicas a resaltar
- **SPA client-side render** (React).
- **Separation of concerns por carpetas**:
- `sections/` = composición de páginas
- `ui/` = componentes reutilizables/presentacionales
- `Data/` = contenido/config local (source of truth)
- `assets/` + `public/` = estáticos
- **Styling utility-first** (TailwindCSS) via PostCSS.
- **Animation layer** (Framer Motion + primitives).

##### Qué etiquetar explícitamente
- Cada caja con: **nombre lógico** + **ruta real** (muy útil para ingeniería):
- “Projects Section (`src/components/sections/Projects.jsx`)"
- “Projects Data (`src/components/Data/DataProjects.js`)"
- Tecnologías en el borde del contenedor:
- “React (Vite bundle)”, “TailwindCSS”, “Framer Motion”

##### Flechas (dataflow/dependencies)
- Usa flechas de **dependencia** dentro del bundle (A “importa” B).
- Usa flechas de **runtime delivery** desde hosting a browser (HTTP).
- Diferencia “navegación externa” (links) con flecha punteada.

##### Nivel de detalle recomendado (para este repo)
- No dibujes cada componente pequeño como caja separada si no aporta; pero aquí “separar en tantos componentes como sea posible” sí aplica: al menos **App → Sections → UI/Data/Assets**.
- Mantén “Framer Motion” como capa transversal (badge o caja lateral) porque afecta varias secciones.

##### Checklist final (para validar exactitud)
- ¿Aparecen **Vite + GitHub Pages** como cadena de entrega?
- ¿`main.jsx` y `App.jsx` están en el centro del runtime?
- ¿Las secciones del portafolio están representadas como módulos?
- ¿Los datos (`DataProjects.js`) y assets (imágenes, `cv.pdf`) están como fuentes locales?
- ¿No inventaste backend, DB o APIs inexistentes?
- ¿Las flechas distinguen “import” vs “HTTP delivery” vs “external links”?

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =======================
  %% System Context (C4 L1)
  %% =======================
  subgraph "System Context (Runtime Delivery & Navigation)"
    U["Visitor / Recruiter (Browser)"]:::actor

    GH["GitHub Pages (Static Hosting/CDN)"]:::external
    SYS["Eduardo Portfolio SPA (React + Vite)"]:::spa

    LI["LinkedIn (External Destination)"]:::external
    GIT["GitHub / Project Links (External Destinations)"]:::external

    U -->|"HTTP_GET_static_files"| GH
    GH -->|"Serve_HTML_CSS_JS_Images_PDF"| U

    U -.->|"external_link_click"| LI
    U -.->|"external_link_click"| GIT

    GH -->|"hosts"| SYS
  end

  %% =======================
  %% Container / Runtime (C4 L2)
  %% =======================
  subgraph "Container / Runtime (SPA Composition)"
    direction TB

    subgraph "Static Hosting"
      GH2["GitHub Pages (Static Hosting)"]:::external
    end

    subgraph "SPA Bundle (Vite output executed in Browser)"
      direction TB
      HTML["Vite HTML Entry (index.html)"]:::spa
      MAIN["React Bootstrap (src/main.jsx)"]:::spa
      APP["Root App Shell (src/App.jsx)"]:::spa

      CSSAPP["App Styling (src/App.css)"]:::sty
      CSSGLOBAL["Global Styles (src/index.css)"]:::sty

      HTML -->|"loads_bundle"| MAIN
      MAIN -->|"mounts"| APP
      APP -->|"imports"| CSSAPP
      MAIN -->|"imports"| CSSGLOBAL

      subgraph "Presentation Layer"
        direction TB

        subgraph "Sections (src/components/sections/*)"
          direction TB
          HDR["Header / Navigation (header.jsx)"]:::section
          HERO["Hero Section (HeroSection.jsx)"]:::section
          ABOUT["About Me (AboutMeSection.jsx)"]:::section
          EXP["Experience (Experience.jsx)"]:::section
          PROJ["Projects (Projects.jsx)"]:::section
          CONTACT["Contact Me (ContanctMe.jsx)"]:::section
        end

        subgraph "Reusable UI Components (src/components/ui/*)"
          direction TB
          UIROOT["UI Components (Directory)"]:::ui
          BTN["Button Component (Buttonn.jsx)"]:::ui
          ICONITEM["Icon Item (IconItem.jsx)"]:::ui
          POINTER["Pointer/Cursor (puntero.jsx)"]:::ui
          UIROOT --> BTN
          UIROOT --> ICONITEM
          UIROOT --> POINTER
        end

        subgraph "Animation Layer"
          direction TB
          FM["Framer Motion (Library)"]:::anim
          PRIM["Motion Primitive (text-effect.tsx)"]:::anim
          FM -->|"provides_motion_api"| PRIM
        end
      end

      APP -->|"composes"| HDR
      APP -->|"composes"| HERO
      APP -->|"composes"| ABOUT
      APP -->|"composes"| EXP
      APP -->|"composes"| PROJ
      APP -->|"composes"| CONTACT

      HDR -->|"uses"| UIROOT
      HERO -->|"uses"| UIROOT
      ABOUT -->|"uses"| UIROOT
      EXP -->|"uses"| UIROOT
      PROJ -->|"uses"| UIROOT
      CONTACT -->|"uses"| UIROOT

      PRIM -.->|"used_by"| HERO
      PRIM -.->|"used_by"| ABOUT
      PRIM -.->|"used_by"| EXP
      PRIM -.->|"used_by"| PROJ
      PRIM -.->|"used_by"| CONTACT
    end

    subgraph "Local Content/Data Layer (src/components/Data/*)"
      direction TB
      DROOT["Data Modules (Directory)"]:::data
      DPROJ["Projects Data (DataProjects.js)"]:::data
      DICONPROJ["Project Icons (IconsProjects.js)"]:::data
      DICONS["SVG Icons (IconsSvg.js)"]:::data
      DROOT --> DPROJ
      DROOT --> DICONPROJ
      DROOT --> DICONS
    end

    subgraph "Static Assets"
      direction TB
      AIMG["Images (src/assets/img/*)"]:::asset
      AEXP["Experience Images (src/assets/img/experience/*)"]:::asset
      APROJ["Projects Images (src/assets/img/projects/*)"]:::asset
      PDF["Public CV (public/cv.pdf)"]:::asset

      AIMG --> AEXP
      AIMG --> APROJ
    end

    PROJ -->|"imports"| DPROJ
    PROJ -->|"imports"| DICONPROJ
    HDR -->|"imports"| DICONS
    HERO -->|"imports"| DICONS
    CONTACT -->|"imports"| DICONS

    HERO -->|"loads"| AIMG
    ABOUT -->|"loads"| AIMG
    EXP -->|"loads"| AEXP
    PROJ -->|"loads"| APROJ
    CONTACT -->|"opens_or_downloads"| PDF

    GH2 -->|"serves"| HTML
    GH2 -->|"serves"| AIMG
    GH2 -->|"serves"| PDF
  end

  %% =======================
  %% Build & Deploy Pipeline
  %% =======================
  subgraph "Build & Deploy Pipeline (Tooling)"
    direction TB

    DEV["Developer Machine"]:::tool
    PKG["Dependencies & Scripts (package.json)"]:::tool
    VCFG["Vite Config (vite.config.js)"]:::tool
    PCFG["PostCSS/Tailwind Config (postcss.config.js)"]:::tool
    ESL["ESLint Config (eslint.config.js)"]:::tool
    DOC["README (Deploy Notes)"]:::tool

    VDEV["Vite Dev Server (npm_run_dev)"]:::tool
    VBUILD["Vite Build (npm_run_build)"]:::tool
    DIST[("dist/ (Static Artifacts)")]:::artifact
    DEPLOY["Deploy to GitHub Pages (Manual_or_GH_Pages_Pipeline)"]:::tool

    DEV -->|"edit_code"| PKG
    DEV -->|"configure"| VCFG
    DEV -->|"configure"| PCFG
    DEV -->|"lint_rules"| ESL
    DEV -->|"read_docs"| DOC

    DEV -->|"run"| VDEV
    DEV -->|"run"| VBUILD
    PKG -->|"drives"| VDEV
    PKG -->|"drives"| VBUILD
    VCFG -->|"configures"| VDEV
    VCFG -->|"configures"| VBUILD
    PCFG -->|"processes_css"| VBUILD
    ESL -.->|"checks"| DEV

    VBUILD -->|"outputs"| DIST
    DIST -->|"deployed_via"| DEPLOY
    DEPLOY -->|"publishes"| GH2
  end

  %% =======================
  %% Click Events (paths only)
  %% =======================
  click HTML "https://github.com/eduarsene/my-lp/blob/main/index.html"
  click MAIN "https://github.com/eduarsene/my-lp/blob/main/src/main.jsx"
  click APP "https://github.com/eduarsene/my-lp/blob/main/src/App.jsx"
  click CSSAPP "https://github.com/eduarsene/my-lp/blob/main/src/App.css"
  click CSSGLOBAL "https://github.com/eduarsene/my-lp/blob/main/src/index.css"

  click HDR "https://github.com/eduarsene/my-lp/blob/main/src/components/sections/header.jsx"
  click HERO "https://github.com/eduarsene/my-lp/blob/main/src/components/sections/HeroSection.jsx"
  click ABOUT "https://github.com/eduarsene/my-lp/blob/main/src/components/sections/AboutMeSection.jsx"
  click EXP "https://github.com/eduarsene/my-lp/blob/main/src/components/sections/Experience.jsx"
  click PROJ "https://github.com/eduarsene/my-lp/blob/main/src/components/sections/Projects.jsx"
  click CONTACT "https://github.com/eduarsene/my-lp/blob/main/src/components/sections/ContanctMe.jsx"
  click UIROOT "https://github.com/eduarsene/my-lp/tree/main/src/components/ui/"
  click BTN "https://github.com/eduarsene/my-lp/blob/main/src/components/ui/Buttonn.jsx"
  click ICONITEM "https://github.com/eduarsene/my-lp/blob/main/src/components/ui/IconItem.jsx"
  click POINTER "https://github.com/eduarsene/my-lp/blob/main/src/components/ui/puntero.jsx"

  click DROOT "https://github.com/eduarsene/my-lp/tree/main/src/components/Data/"
  click DPROJ "https://github.com/eduarsene/my-lp/blob/main/src/components/Data/DataProjects.js"
  click DICONPROJ "https://github.com/eduarsene/my-lp/blob/main/src/components/Data/IconsProjects.js"
  click DICONS "https://github.com/eduarsene/my-lp/blob/main/src/components/Data/IconsSvg.js"

  click AIMG "https://github.com/eduarsene/my-lp/tree/main/src/assets/img/"
  click AEXP "https://github.com/eduarsene/my-lp/tree/main/src/assets/img/experience/"
  click APROJ "https://github.com/eduarsene/my-lp/tree/main/src/assets/img/projects/"
  click PDF "https://github.com/eduarsene/my-lp/blob/main/public/cv.pdf"

  click PRIM "https://github.com/eduarsene/my-lp/blob/main/components/motion-primitives/text-effect.tsx"

  click VCFG "https://github.com/eduarsene/my-lp/blob/main/vite.config.js"
  click PCFG "https://github.com/eduarsene/my-lp/blob/main/postcss.config.js"
  click ESL "https://github.com/eduarsene/my-lp/blob/main/eslint.config.js"
  click PKG "https://github.com/eduarsene/my-lp/blob/main/package.json"
  click DOC "https://github.com/eduarsene/my-lp/blob/main/README.md"

  %% =======================
  %% Styles
  %% =======================
  classDef actor fill:#111827,stroke:#0b1220,color:#ffffff,stroke-width:1.5px
  classDef external fill:#6d28d9,stroke:#4c1d95,color:#ffffff,stroke-width:1.5px
  classDef spa fill:#2563eb,stroke:#1e3a8a,color:#ffffff,stroke-width:1.5px
  classDef section fill:#1d4ed8,stroke:#1e40af,color:#ffffff,stroke-width:1.5px
  classDef ui fill:#0ea5e9,stroke:#075985,color:#ffffff,stroke-width:1.5px
  classDef anim fill:#a855f7,stroke:#581c87,color:#ffffff,stroke-width:1.5px
  classDef data fill:#16a34a,stroke:#14532d,color:#ffffff,stroke-width:1.5px
  classDef asset fill:#f59e0b,stroke:#92400e,color:#111827,stroke-width:1.5px
  classDef tool fill:#6b7280,stroke:#374151,color:#ffffff,stroke-width:1.5px
  classDef sty fill:#0f766e,stroke:#134e4a,color:#ffffff,stroke-width:1.5px
  classDef artifact fill:#9ca3af,stroke:#4b5563,color:#111827,stroke-width:1.5px
```
