How eduarsene/my-lp works
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”?