# san7ilo/products-fullstack architecture

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

- Interactive diagram: https://gitdiagram.com/san7ilo/products-fullstack
- Repository: https://github.com/san7ilo/products-fullstack

## Overview

A continuación se detalla cómo elaborar un diagrama de arquitectura detallado y fiel a la estructura y propósito de este proyecto Full Stack que combina Spring Boot + Next.js, integrado en un flujo CI/CD con Docker, Kubernetes y Jenkins:

##### Identifica los componentes principales
- Backend: El código ubicado en la carpeta "products" que contiene la aplicación Spring Boot. Este componente expone una API RESTful en el endpoint (p.ej., /api/productos) y cuenta con capas diferenciadas (aplicación, dominio, infraestructura). Incluye servicios, controladores, mappers, repositorios, etc.
- Frontend: El código en "frontend-products" (que cumple el rol de Next.js) que ofrece la interfaz de usuario para la administración de productos. Se apoya en React, Next.js, TailwindCSS, React Query y Axios para interactuar con el backend.
- Base de Datos: Aunque en pruebas se utiliza una base de datos en memoria (H2), ésta es parte de la arquitectura del backend.
- CI/CD Pipeline: Con Jenkins (configurado mediante el Jenkinsfile) se orquesta la clonación del repositorio, compilación, construcción de imágenes Docker, y despliegue en Kubernetes.
- Contenedores Docker: Los Dockerfiles existentes para frontend y backend configuran la creación de contenedores para cada uno.
- Orquestación en Kubernetes: Los archivos YAML (deployment, service, ingress) ubicados en la carpeta "k8s" configuran el despliegue de ambos servicios (backend y frontend) en un clúster Kubernetes.

##### Las relaciones e interacciones
- El Frontend se comunica con el Backend mediante peticiones HTTP (usualmente REST), utilizando Axios y gestionado por React Query, lo que permite un flujo de datos en tiempo real.
- El Backend gestiona las operaciones CRUD y, a su vez, interactúa con la base de datos H2.
- Jenkins automatiza la integración, orquestando la compilación, creación de imágenes y el despliegue en Kubernetes. Las imágenes de Docker resultantes se almacenan (y potencialmente se suben a Docker Hub).
- Kubernetes, mediante sus archivos YAML, expone tanto el frontend como el backend a través de servicios e ingresses, permitiendo el acceso a la aplicación mediante direcciones (ejemplo localhost).

##### Destaca patrones y principios arquitectónicos
- Separación de responsabilidades entre frontend y backend (arquitectura de microservicios o desacoplados).
- Uso de patrones comunes en Spring Boot, tales como capas (Controlador, Servicio, Repositorio) para estructurar el código.
- Uso de CI/CD para automatización y despliegue continuo.
- Contenedorización y orquestación para entornos de despliegue escalables y reproducibles.

##### Tecnologías y herramientas relevantes
- Backend: Java 17, Spring Boot, Spring Data JPA, H2, Maven.
- Frontend: Next.js, React, React Query, TailwindCSS, Node/NPM.
- DevOps: Docker, Kubernetes (Minikube para pruebas locales), Jenkins.

##### Guías para adaptar el diagrama a este proyecto
- Enfatiza la separación del frontend y backend, mostrando el flujo de datos desde la interfaz (React/Next.js) hacia el backend (Spring Boot) y la base de datos.
- Añade un componente para el Pipeline CI/CD (Jenkins), representando el proceso de clonación, construcción, packaging y despliegue.
- Representa los contenedores Docker como nodos individuales para frontend y backend, y conéctalos al clúster Kubernetes, mostrando los objetos de tipo Deployment, Service e Ingress.
- Muestra la interacción entre estos componentes utilizando flechas direccionales: por ejemplo, indica que el frontend realiza solicitudes HTTP al backend y que Jenkins impulsa el proceso de despliegue en Kubernetes.

##### Instrucciones específicas para el diagrama
- Usa formas (por ejemplo, rectángulos o bloques) para representar cada componente clave: Frontend, Backend, Base de Datos, Jenkins, Docker y Kubernetes.
- Etiqueta claramente cada componente, incluyendo las tecnologías (por ejemplo, “Spring Boot (Java 17)” para el backend, “Next.js/React” para el frontend).
- Dibuja flechas de flujo de datos entre el Frontend y el Backend, y desde Jenkins hacia Kubernetes.
- Asegúrate de incluir los detalles de CI/CD, indicando el paso de compilación, generación de imágenes Docker y despliegue en el clúster.
- Considera agregar anotaciones o notas para explicar la migración de los desarrollos locales (ejecución directa de maven o npm run) a la ejecución orquestada por Docker/Kubernetes.

##### Resumen del diagrama propuesto
- Componente “Frontend” (Next.js/React):
- Contenedor Docker configurado en "frontend-products/Dockerfile".
- Interacción con el Backend mediante peticiones HTTP.
- Componente “Backend” (Spring Boot):
- Código en la carpeta "products".
- Exposición de API RESTful, integración con base de datos H2.
- Conexión “Base de Datos”: Representa la base de datos H2 como parte del backend (aunque solo para pruebas).
- Pipeline CI/CD (Jenkins):
- Proceso descrito en el Jenkinsfile, que automatiza las construcciones y despliegue.
- Orquestación Docker/Kubernetes:
- Los archivos en "k8s/" definen deployments, services e ingress para ambos servicios.
- Flechas que muestran cómo las imágenes Docker se despliegan en el clúster Kubernetes.

Siguiendo estas indicaciones, el diagrama resultante mostrará con claridad todos los elementos esenciales de la arquitectura del proyecto, permitiendo una visualización precisa de sus interacciones y dependencias. Esto ayudará a cualquier miembro del equipo (especialmente a un principal software engineer) a comprender tanto la estructura técnica como el flujo operativo completo de la aplicación Full Stack.

## Diagram (Mermaid)

```mermaid
flowchart TD
    jenkins["CI/CD: Jenkins Pipeline"]:::ci
    docker_backend["Docker Container (Backend)"]:::docker
    docker_frontend["Docker Container (Frontend)"]:::docker
    k8s_backend["Kubernetes Deployment (Backend Service)"]:::k8s
    k8s_frontend["Kubernetes Deployment (Frontend Service)"]:::k8s
    backend["Backend: Spring Boot (Java 17)"]:::app
    frontend["Frontend: Next.js/React"]:::app
    database["H2 Database (For Testing)"]:::db

    jenkins --> docker_backend
    jenkins --> docker_frontend
    docker_backend --> k8s_backend
    docker_frontend --> k8s_frontend
    k8s_backend --> backend
    k8s_frontend --> frontend
    backend --> database
    frontend -->|"HTTPcalls"| backend

    click jenkins "https://github.com/san7ilo/products-fullstack/tree/main/Jenkinsfile"
    click docker_backend "https://github.com/san7ilo/products-fullstack/tree/main/products/Dockerfile"
    click docker_frontend "https://github.com/san7ilo/products-fullstack/tree/main/frontend-products/Dockerfile"
    click backend "https://github.com/san7ilo/products-fullstack/tree/main/products/"
    click frontend "https://github.com/san7ilo/products-fullstack/tree/main/frontend-products/"
    click database "https://github.com/san7ilo/products-fullstack/blob/main/products/src/main/resources/application.properties"
    click k8s_backend "https://github.com/san7ilo/products-fullstack/tree/main/k8s/"
    click k8s_frontend "https://github.com/san7ilo/products-fullstack/tree/main/k8s/"

    classDef ci fill:#f9c74f,stroke:#333,stroke-width:2px;
    classDef docker fill:#90be6d,stroke:#333,stroke-width:2px;
    classDef k8s fill:#f94144,stroke:#333,stroke-width:2px;
    classDef app fill:#577590,stroke:#333,stroke-width:2px,color:#fff;
    classDef db fill:#43aa8b,stroke:#333,stroke-width:2px,color:#fff;
```
