# cristianpvp/ods-13_webpage architecture

> Architecture diagram of the GitHub repository cristianpvp/ods-13_webpage, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cristianpvp/ods-13_webpage
- Repository: https://github.com/cristianpvp/ods-13_webpage

## Overview

A continuación se explica paso a paso cómo elaborar un diagrama de arquitectura preciso y completo para el proyecto “ODS 13: Desarrollo sostenible”, teniendo en cuenta la estructura de archivos y los detalles proporcionados en el README.

##### Identificación del proyecto
- Tipo y propósito: Se trata de una aplicación web de pila completa (full-stack) desarrollada con Next.js, utilizando React con TypeScript, TailwindCSS para el estilo y MongoDB (accesible a través de Prisma) como base de datos.
- Aspectos importantes: Soporte para internacionalización (i18n), API routes incorporadas en Next.js, y componentes reutilizables de React.

##### Análisis de la estructura de archivos
- Directorios clave:
- “src/app/[locale]/”: Contiene las páginas de la aplicación con soporte de internacionalización. Aquí se definen las rutas para páginas comunes como “about”, “news”, “comments”, “ods”, etc.
- “src/app/api/”: Almacena las rutas de la API para funcionalidades como comentarios, envío de correos y noticias. Estas rutas funcionan como endpoints backend bajo el esquema de Next.js.
- “prisma/”: Contiene el esquema de conexión y definición de la base de datos MongoDB, gestionado mediante Prisma.
- “src/components/”: Componentes de React reutilizables (como NavBar, Carrousel, SpotlightCard, etc.) utilizados para componer la interfaz de usuario.
- “public/”: Almacena los recursos estáticos como imágenes, gifs y videos.
- Otros directorios de configuración (“.github”, “eslint.config.mjs”, etc.) que apoyan el desarrollo, la integración continua y el mantenimiento de la calidad del código.
- Patrones o principios: La aplicación sigue un patrón de enrutamiento basado en Next.js, con separación de capas en el directorio “app”. Además, se aprovecha el sistema de rutas API de Next.js para operaciones de backend y el middleware para ruteo lógico.

##### Componentes principales y relaciones
- Cliente/Frontend:
- Representado por la interfaz de usuario creada con React, ubicada en “src/app/[locale]” y “src/components”. Aquí se incluyen componentes específicos con soporte de internacionalización.
- El navegador del usuario interactúa con estas páginas y componentes.

- Servidor Next.js:
- Maneja el renderizado de páginas y la lógica de ruteo (incluyendo middleware en “src/middleware.ts”).
- Incorpora API routes (en “src/app/api/”) que sirven de endpoints para operaciones del lado del servidor como el manejo de comentarios, noticias y validación de correos.

- Base de datos:
- MongoDB, definida y gestionada vía Prisma (directorio “prisma/schema.prisma”).
- La comunicación entre las API routes y la base de datos se realiza a través de Prisma.

- Internacionalización (i18n):
- Configurada en “src/i18n” y soportada mediante archivos de traducción ubicados en “messages/”.
- Permite que la misma estructura de páginas pueda servir contenidos en distintos idiomas.

- Recursos estáticos y diseño:
- Elementos en “public/”, incluidos imágenes y videos, sirven para contenido visual.
- TailwindCSS se utiliza (con configuración probable en “postcss.config.mjs” y otros archivos de configuración) para los estilos.

##### Guías para el diagrama de arquitectura
a. Componentes a incluir:
- Navegador/Cliente
- Servidor Next.js (diferenciando entre la capa de páginas y la capa de API endpoints)
- API Endpoints (subdivisión dentro del servidor para manejo de datos – “src/app/api/”)
- Base de datos MongoDB (accedida mediante Prisma)
- Sistema de Internacionalización (i18n) y archivos de traducción
- Componentes Reutilizables y UI (directorios “src/components/” y “src/app/*”)
- Recursos estáticos (carpeta “public”)

b. Relaciones e interacciones:
- Flechas que muestren la interacción del cliente con el servidor Next.js (solicitando páginas con soporte i18n).
- Conexión entre los API Endpoints y la base de datos, mostrando la integración de Prisma.
- Indicar que el sistema i18n interactúa con la presentación de contenidos (extras: flechas que muestren que los archivos de traducción situados en “messages/” son solicitados por la capa de enrutamiento/internacionalización).
- Incluir conexiones indirectas con herramientas de integración y despliegue (por ejemplo, Netlify y GitHub Actions, repositorios dentro de “.github/”) aunque son periféricas al núcleo de la arquitectura.

c. Patrones y principios:
- Uso de enrutamiento basado en archivos (App directory de Next.js) y estructura de API routes.
- Separación de lógica de presentación (páginas y componentes) y lógica del backend (API y prisma).
- Enfoque modular y escalable al disponer de componentes UI reutilizables.

d. Tecnologías relevantes:
- Next.js y React con TypeScript.
- TailwindCSS para los estilos.
- Prisma como ORM para MongoDB.
- Herramientas de CI/CD y control de calidad integradas (configuraciones en .github y ESLint).

##### Instrucciones para dibujar el diagrama
- Etiqueta claramente cada componente (ej. “Cliente Web”, “Servidor Next.js”, “API Endpoints”, “Base de Datos – MongoDB/Prisma”, “i18n”).
- Usa flechas direccionales para indicar:
- Flujo de datos del navegador al servidor y viceversa.
- Conexión de los API Endpoints con la base de datos.
- Relación entre los componentes de internacionalización y las vistas (páginas) que consumen esas traducciones.
- Emplea formas o colores diferentes para distinguir:
- Componentes de presentación (por ejemplo, rectángulos para UI y páginas).
- Servicios externos como la base de datos (puede ser ilustrado como cilindro) y la conexión de despliegue (por ejemplo, GitHub Actions / Netlify).
- Añade notas o etiquetas en elementos claves para explicar el propósito, como “Soporte i18n”, “Renderizado en server-side”, “ORM Prisma”, etc.
- Si es útil, incluir una sección en el diagrama que resalte el proceso de despliegue y CI/CD (aunque no sea el núcleo, sirve para una visión completa).

##### Conclusión
Se recomienda separar el proyecto en sus componentes esenciales (cliente, servidor, base de datos, interconexiones) y atender a los detalles de la internacionalización y la integración de API. Este diagrama servirá no solo para documentar la arquitectura actual sino para ayudar a identificar áreas potenciales de mejora y facilitar la colaboración en el desarrollo y escalabilidad de la aplicación.

Este enfoque detallado garantiza que el diagrama capture todas las piezas esenciales de la arquitectura y facilite la orientación a nuevos desarrolladores o equipos de mantenimiento.

## Diagram (Mermaid)

```mermaid
graph TD
    NW["Cliente (Navegador)"]:::frontend

    subgraph "Frontend"
        FE1["Pages (i18n)"]:::frontend
        FE2["UI Components"]:::frontend
    end

    subgraph "Servidor Next.js"
        S1["Renderizado de Páginas"]:::server
        S2["Middleware"]:::server
        S3["API Endpoints"]:::api
    end

    DB["Base de Datos – MongoDB/Prisma"]:::db

    subgraph "Internacionalización"
        I1["i18n Configuración"]:::i18n
        I2["Archivos de Traducción"]:::i18n
    end

    RS["Recursos Estáticos"]:::static
    CICD["CI/CD & Deploy"]:::cicd

    %% Relaciones de Cliente con Frontend
    NW -->|"accede páginas"| FE1
    NW -->|"usa UI"| FE2

    %% Relaciones entre Frontend y Servidor Next.js
    FE1 -->|"solicita páginas"| S1

    %% Relación de internacionalización con Frontend
    FE1 -->|"usa_i18n"| I1
    I1 -->|"traduce"| I2

    %% Relación de UI Components con Recursos Estáticos
    FE2 -->|"usa_recursos"| RS

    %% Relaciones internas de Servidor Next.js
    S1 -->|"llama_APIs"| S3

    %% Conexión de API Endpoints con Base de Datos
    S3 -->|"ORM_Prisma"| DB

    %% Integración de CI/CD y despliegue con Servidor Next.js
    CICD -->|"integra"| S1

    %% Estilos
    classDef frontend fill:#AED6F1,stroke:#2874A6,stroke-width:2px;
    classDef server fill:#F9E79F,stroke:#B7950B,stroke-width:2px;
    classDef api fill:#FADBD8,stroke:#C0392B,stroke-width:2px;
    classDef db fill:#D5F5E3,stroke:#27AE60,stroke-width:2px;
    classDef i18n fill:#E8DAEF,stroke:#8E44AD,stroke-width:2px;
    classDef static fill:#D6EAF8,stroke:#2471A3,stroke-width:2px;
    classDef cicd fill:#F5B7B1,stroke:#922B21,stroke-width:2px;

    %% Click Events
    click FE1 "https://github.com/cristianpvp/ods-13_webpage/tree/main/src/app/[locale]"
    click FE2 "https://github.com/cristianpvp/ods-13_webpage/tree/main/src/components"
    click S1 "https://github.com/cristianpvp/ods-13_webpage/tree/main/src/app"
    click S2 "https://github.com/cristianpvp/ods-13_webpage/blob/main/src/middleware.ts"
    click S3 "https://github.com/cristianpvp/ods-13_webpage/tree/main/src/app/api"
    click DB "https://github.com/cristianpvp/ods-13_webpage/blob/main/prisma/schema.prisma"
    click I1 "https://github.com/cristianpvp/ods-13_webpage/tree/main/src/i18n"
    click I2 "https://github.com/cristianpvp/ods-13_webpage/tree/main/messages"
    click RS "https://github.com/cristianpvp/ods-13_webpage/tree/main/public"
    click CICD "https://github.com/cristianpvp/ods-13_webpage/blob/main/.github"
```
