# jmena007/nova-website architecture

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

- Interactive diagram: https://gitdiagram.com/jmena007/nova-website
- Repository: https://github.com/jmena007/nova-website

## Overview

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`](https://github.com/jmena007/nova-website/blob/main/index.html) (Home page), [`contact.html`](https://github.com/jmena007/nova-website/blob/main/contact.html) (Contact page), [`event.js`](https://github.com/jmena007/nova-website/blob/main/event.js) (UI events), [`funciones.js`](https://github.com/jmena007/nova-website/blob/main/funciones.js) (Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Static site"]
  node_index["Home page<br/>html entry<br/>[index.html]"]
  node_contact_page["Contact page<br/>html form page<br/>[contact.html]"]
  node_anchors["CV sections<br/>in-page navigation"]
end

subgraph group_presentation["Presentation"]
  node_estilos["Main styles<br/>css theme<br/>[estilos.css]"]
  node_contact_css["Contact styles<br/>css form theme<br/>[contact.css]"]
end

subgraph group_behavior["Behavior"]
  node_funciones["Utilities<br/>js helpers<br/>[funciones.js]"]
  node_event_js["UI events<br/>js interaction<br/>[event.js]"]
  node_contact_js["Form logic<br/>js form handling<br/>[contact.js]"]
end

subgraph group_external["External services"]
  node_gh_pages[("GitHub Pages<br/>static hosting")]
  node_delivery[("Mail/form service<br/>external delivery")]
end

node_browser(("Browser<br/>client runtime"))

node_browser -->|"opens"| node_index
node_browser -->|"navigates"| node_contact_page
node_index -->|"contains"| node_anchors
node_index -->|"styles"| node_estilos
node_index -->|"uses"| node_funciones
node_index -->|"enhanced by"| node_event_js
node_contact_page -->|"styles"| node_contact_css
node_contact_page -->|"handles"| node_contact_js
node_contact_page -->|"shares"| node_funciones
node_contact_page -->|"submits to"| node_delivery
node_event_js -.->|"coordinates"| node_contact_js
node_gh_pages -->|"hosts"| node_index
node_gh_pages -->|"hosts"| node_contact_page
node_gh_pages -->|"serves"| node_estilos
node_gh_pages -->|"serves"| node_contact_css
node_gh_pages -->|"serves"| node_funciones
node_gh_pages -->|"serves"| node_event_js
node_gh_pages -->|"serves"| node_contact_js

click node_index "https://github.com/jmena007/nova-website/blob/main/index.html"
click node_contact_page "https://github.com/jmena007/nova-website/blob/main/contact.html"
click node_estilos "https://github.com/jmena007/nova-website/blob/main/estilos.css"
click node_contact_css "https://github.com/jmena007/nova-website/blob/main/contact.css"
click node_funciones "https://github.com/jmena007/nova-website/blob/main/funciones.js"
click node_event_js "https://github.com/jmena007/nova-website/blob/main/event.js"
click node_contact_js "https://github.com/jmena007/nova-website/blob/main/contact.js"

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_index,node_contact_page,node_anchors toneBlue
class node_estilos,node_contact_css toneAmber
class node_funciones,node_event_js,node_contact_js toneMint
class node_gh_pages,node_delivery toneRose
class node_browser toneNeutral
```

## Components

### Static site

Core pages and navigation of the personal CV website.

- [Home page](https://github.com/jmena007/nova-website/blob/main/index.html): html entry · Main landing page for the CV/portfolio content. · `index.html`
- [Contact page](https://github.com/jmena007/nova-website/blob/main/contact.html): html form page · Separate page for the contact form flow. · `contact.html`
- **CV sections**: in-page navigation · Profile, experience, education and other anchored sections within the main page.

### Presentation

CSS layers that shape the main CV and contact page.

- [Main styles](https://github.com/jmena007/nova-website/blob/main/estilos.css): css theme · Presentation layer for the primary CV page. · `estilos.css`
- [Contact styles](https://github.com/jmena007/nova-website/blob/main/contact.css): css form theme · Presentation layer for the contact page and form. · `contact.css`

### Behavior

Client-side JavaScript that adds interaction and form handling.

- [Utilities](https://github.com/jmena007/nova-website/blob/main/funciones.js): js helpers · Shared client-side helper logic for the site. · `funciones.js`
- [UI events](https://github.com/jmena007/nova-website/blob/main/event.js): js interaction · Event-driven behavior for navigation or page interactions. · `event.js`
- [Form logic](https://github.com/jmena007/nova-website/blob/main/contact.js): js form handling · Contact form behavior, validation, and submission flow. · `contact.js`

### External services

Hosting and third-party delivery for contact submissions.

- **GitHub Pages**: static hosting · Static deployment target for the repository site.
- **Mail/form service**: external delivery · Optional third-party destination for contact submissions via mailto or form services.

### Other components

- **Browser**: client runtime · Where the site is rendered and interactions happen.

## Connections

- 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.
