How jmena007/nova-website works
1. Tipo de aplicación
- Es un sitio estático de portafolio/CV personal, no una app con backend propio.
- La arquitectura gira alrededor del navegador: HTML para estructura, CSS para presentación y JavaScript para interacción.
2. Punto de entrada principal
- index.html es la landing page principal del curriculum web.
- Desde ahí se presentan las secciones del CV: perfil, experiencia, formación y navegación interna por anclas.
3. Página separada de contacto
- contact.html funciona como subsitio o vista independiente para el formulario de contacto.
- Esto separa claramente la experiencia informativa del CV del flujo de captura de datos del usuario.
4. Capa de presentación
- estilos.css y contact.css contienen los estilos.
- La separación sugiere dos contextos visuales: uno para la página principal y otro para el formulario de contacto.
- El diseño parece orientado a una presentación limpia y semántica, no a un framework de componentes.
5. Capa de comportamiento
- funciones.js, event.js y contact.js encapsulan la lógica de interacción.
- Por los nombres y el README, funciones.js probablemente concentra utilidades generales, mientras que event.js y contact.js manejan eventos y validación/envío del formulario.
- El uso de JavaScript es de enhancement progresivo: mejora navegación y formularios sin depender de un servidor propio.
6. Flujo de navegación
- El usuario entra por index.html.
- Desde ahí navega internamente entre secciones del CV mediante enlaces ancla.
- Si desea contactar, pasa a contact.html, donde el flujo cambia de “consulta de información” a “captura de datos”.
7. Flujo de datos del formulario
- En el formulario se recolectan datos como nombre, fecha, correo y teléfono.
- Esos datos no parecen enviarse a una API propia; el README indica dos opciones: mailto: o servicios externos como Formspree / Netlify Forms.
- Esto implica que la validación puede ocurrir en el cliente y la entrega final depende de un servicio de correo o formulario de terceros.
8. Límites del sistema
- No hay evidencia de backend, base de datos ni autenticación.
- El sistema está compuesto por:
- Cliente web: HTML/CSS/JS
- Hosting estático: GitHub Pages
- Servicio externo opcional: correo/form handling
- Esa frontera es importante para el diagrama: el proyecto termina en el navegador y, opcionalmente, delega el envío a un proveedor externo.
9. Tecnologías e infraestructura relevantes
- Tecnologías base: HTML5, CSS3 y JavaScript.
- Infraestructura de despliegue: GitHub Pages, lo que refuerza que todo es estático y accesible desde un repositorio Git.
- El README también menciona async/await, así que alguna lógica JS probablemente simule o prepare flujos asíncronos, aunque no haya backend local.
10. Organización funcional del repositorio
- Hay una división clara entre:
- Presentación del CV: index.html, estilos globales y scripts generales
- Contacto: contact.html, contact.css, contact.js
- Ese corte por páginas permite diagramar dos entradas principales dentro del mismo sitio.
11. Observación de consistencia
- El README menciona estilo.css y evento.js, pero el árbol de archivos muestra estilos.css y event.js.
- Para el análisis arquitectónico conviene tomar el file tree como fuente más confiable y considerar el README como descriptivo, no exacto en nombres.
12. Resumen arquitectónico
- En términos de diagramación, este repo es un sitio web estático multipágina con una página principal de CV, una página de contacto, estilos separados por contexto y scripts JavaScript específicos por funcionalidad.
- Su única integración externa relevante es el mecanismo de envío del formulario, que puede resolverse con mailto: o con un servicio SaaS de formularios.
Main entry points: index.html Home page · contact.html Contact page · event.js UI events · funciones.js Utilities
Components 11
Static site
Core pages and navigation of the personal CV website.
- Home page · Main landing page for the CV/portfolio content.
index.html - Contact page · Separate page for the contact form flow.
contact.html - CV sections · Profile, experience, education and other anchored sections within the main page.
Presentation
CSS layers that shape the main CV and contact page.
- Main styles · Presentation layer for the primary CV page.
estilos.css - Contact styles · Presentation layer for the contact page and form.
contact.css
Behavior
Client-side JavaScript that adds interaction and form handling.
- Utilities · Shared client-side helper logic for the site.
funciones.js - UI events · Event-driven behavior for navigation or page interactions.
event.js - Form logic · Contact form behavior, validation, and submission flow.
contact.js
External services
Hosting and third-party delivery for contact submissions.
- GitHub Pages · Static deployment target for the repository site.
- Mail/form service · Optional third-party destination for contact submissions via mailto or form services.
Other components
- Browser · Where the site is rendered and interactions happen.
Connections 18
- Browser → Home page: opens · The browser loads the main landing page.
- Browser → Contact page: navigates · Users can move to the dedicated contact page.
- Home page → CV sections: contains · The homepage exposes internal section links.
- Home page → Main styles: styles · Main page presentation comes from the global stylesheet.
- Home page → Utilities: uses · The homepage can rely on shared helper functions.
- Home page → UI events: enhanced by · Interaction and navigation behavior is added client-side.
- Contact page → Contact styles: styles · The contact page uses its own visual layer.
- Contact page → Form logic: handles · Form validation and submission logic live here.
- Contact page → Utilities: shares · Common helpers may be reused on the contact page.
- Contact page → Mail/form service: submits to · Contact data is delivered through mailto or an external form provider.
- UI events → Form logic: coordinates · General UI behavior may trigger form-specific actions.
- GitHub Pages → Home page: hosts · The static site is deployed from GitHub Pages.
- GitHub Pages → Contact page: hosts · The contact page is served as part of the static site.
- GitHub Pages → Main styles: serves · Static assets are delivered directly from the hosting platform.
- GitHub Pages → Contact styles: serves · Static assets are delivered directly from the hosting platform.
- GitHub Pages → Utilities: serves · Static assets are delivered directly from the hosting platform.
- GitHub Pages → UI events: serves · Static assets are delivered directly from the hosting platform.
- GitHub Pages → Form logic: serves · Static assets are delivered directly from the hosting platform.