# martincapece/tpo_aplicaciones_interactivas architecture

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

- Interactive diagram: https://gitdiagram.com/martincapece/tpo_aplicaciones_interactivas
- Repository: https://github.com/martincapece/tpo_aplicaciones_interactivas

## Overview

A continuación encontrarás una guía detallada y adaptada a tu proyecto “TPO_Aplicaciones_Interactivas – e-commerce de sneakers” para que puedas dibujar un diagrama de arquitectura claro, preciso y completo.

##### Identificación del proyecto y su propósito
- Es un **full-stack web application** de e-commerce de sneakers.
- Frontend: React (Vite, React Router, Context API, Material-UI).
- Backend: Java 17 + Spring Boot (REST API, Spring Security + JWT).
- Base de datos: PostgreSQL.
- Almacenamiento de imágenes: Cloudinary.
- Correo electrónico: servicio SMTP configurado con Spring.
- Contenerización: Docker + Docker Compose para orquestar frontend, backend y base de datos.

##### Estructura de directorios (visión general)
- Raíz
- docker-compose.yml
- frontend/
- Dockerfile, package.json, src/ (dividido en módulos: auth, Cart, Admin, ecomerce, router, firebase, mocks…)
- backend/
- pom.xml, Dockerfile, src/main/java/com/api/ecommerce/…
– config/ (CloudinaryConfig, SecurityConfig)
– controller/ (AdminController, ProductoController, AuthController…)
– service/ + service/implementation (servicios de negocio)
– repository/ (Spring Data JPA)
– model/ (entidades JPA: Producto, Cliente, Compra…)
– dto/ (objetos de transferencia)
– security/ (JwtFilter, JwtUtil)
– exceptions/ (manejador global)
- src/main/resources/application.properties
- .gitignore, CONVENCIONES.md, README.md

##### Lectura del README
- Confirma tecnologías y objetivos: gestión usuarios, catálogo, carrito, CRUD productos, perfil.
- Menciona Docker y Docker Compose para portabilidad.

##### Pasos para crear el diagrama de arquitectura
a. Componentes principales
1. Cliente (navegador web / React App)
2. Frontend Container (Docker)
3. API Gateway / Backend Container (Spring Boot)
4. PostgreSQL Container (Base de datos)
5. Cloudinary (almacenamiento de imágenes)
6. Servicio de Email (SMTP externo)
7. Docker Compose (orquestador)
b. Relaciones e interacciones
1. El usuario interactúa con la **React App**.
2. La React App consume la **REST API** vía HTTPS, incluyendo endpoints de autenticación (login/register), catálogo (GET productos, FILTER), carrito (POST /compra), administración (CRUD productos).
3. La **API** pasa por el **JwtFilter** y luego por Controllers → Servicios → Repositorios.
4. Los **repositorios** hablan con **PostgreSQL** para persistencia.
5. Para subir imágenes de productos, la API interactúa con **Cloudinary** usando el servicio `CloudinaryService`.
6. Para notificaciones por email (confirmación de compra, registro), la API usa `EmailService` que apunta a un SMTP o proveedor (definido en application.properties).
7. **Docker Compose** levanta simultáneamente los tres contenedores y define redes internas seguras.
c. Patrones y principios arquitectónicos
- Back-end: **Arquitectura por capas** (Controller → Service → Repository).
- Spring Security + **JWT** para autenticación sin estado.
- Front-end: **Component-based** + **Context API** para estado global (AuthContext, CartContext, ProductosContext).
- Modularización clara: carpetas Admin, Cart, Auth, Ecomerce.
- Contenerización para consistencia entre entornos.
d. Tecnologías clave
- React + Vite + React Router + Context API
- Java 17 + Spring Boot + Spring Security + JWT
- PostgreSQL
- Cloudinary
- Docker + Docker Compose

##### Pautas para diagramar según tu caso (full-stack)
- Dibuja dos grandes rectángulos o capas: **Front-end** (lado izquierdo) y **Back-end** (lado derecho).
- En el front-end, muestra subcomponentes principales: AuthModule, EcomerceModule, CartModule, AdminModule.
- Entre front-end y back-end, dibuja flechas que indiquen peticiones HTTP/HTTPS y la inclusión del token JWT en headers.
- En el back-end, detalla la **pipeline** de una petición: JwtFilter → Controller → Service → Repository → PostgreSQL.
- Fuera del contenedor back-end, pinta servicios externos: Cloudinary y Email, con flechas uni- o bidireccionales según corresponda.
- Muestra al final el orquestador Docker Compose y cómo enlaza las redes de los tres contenedores (frontend, backend, db).

##### Elementos de estilo y buenas prácticas
- Etiquetas claras para cada componente (p.ej. “React App (Docker)”, “Spring Boot API (Docker)”, “PostgreSQL”).
- Flechas con textos opcionales: GET /products, POST /login, PUT /admin/producto…
- Colores o formas:
- Verde → Front-end
- Azul  → Back-end
- Naranja → Base de datos
- Morado → Servicios externos
- Leyenda o nota sobre Docker Compose y networking.

##### Recomendación final
- Sé lo más detallado posible: incluye cada submódulo clave sin sobrecargar el diagrama.
- Asegúrate de capturar todos los flujos críticos (autenticación, subida de imágenes, checkout).
- Este diagrama servirá como guía para nuevos desarrolladores y para la evolución arquitectónica del proyecto.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Front-end"
        direction TB
        Client["React App (Docker)"]:::frontend
        subgraph "Modules"
            direction TB
            AuthMod["Auth Module"]:::frontend
            EcomMod["E-commerce Module"]:::frontend
            CartMod["Cart Module"]:::frontend
            AdminMod["Admin Module"]:::frontend
        end
        subgraph "Routing & Context"
            direction TB
            Router["App Router"]:::frontend
            AuthCtx["Auth Context Provider"]:::frontend
            CartCtx["Cart Context Provider"]:::frontend
            ProdCtx["Productos Context Provider"]:::frontend
        end
    end

    subgraph "Back-end"
        direction TB
        API["Spring Boot API (Docker)"]:::backend
        SecurityCfg["SecurityConfig"]:::backend
        JwtFil["JwtFilter"]:::backend
        JwtU["JwtUtil"]:::backend
        subgraph "Controllers"
            direction TB
            Controllers["REST Controllers"]:::backend
        end
        subgraph "Service Layer"
            direction TB
            SvcInt["Service Interfaces"]:::backend
            SvcImpl["Service Implementations"]:::backend
            CloudSrv["Cloudinary Service"]:::external
            EmailSrv["Email Service"]:::external
        end
        subgraph "Persistence"
            direction TB
            Repos["Spring Data Repositories"]:::backend
            Models["JPA Entities (Models)"]:::backend
            DTOs["Data Transfer Objects (DTOs)"]:::backend
        end
        Exceptions["GlobalExceptionHandler"]:::backend
        Config["CloudinaryConfig"]:::backend
    end

    Db["PostgreSQL"]:::database
    CloudinaryExt["Cloudinary"]:::external
    EmailExt["SMTP Email Service"]:::external
    Orchestration["Docker Compose"]:::orchestration

    %% Interactions
    Client -->|HTTPS + JWT| API
    AuthMod -->|uses| Router
    EcomMod -->|uses| Router
    CartMod -->|uses| Router
    AdminMod -->|uses| Router
    Router -->|context| AuthCtx
    Router -->|context| CartCtx
    Router -->|context| ProdCtx

    API --> SecurityCfg
    API --> JwtFil
    API --> JwtU
    API --> Controllers
    SecurityCfg --> JwtFil
    JwtFil --> Controllers
    Controllers --> SvcInt
    SvcInt --> SvcImpl
    SvcImpl --> Repos
    Repos --> Db

    SvcImpl --> CloudSrv
    CloudSrv --> CloudinaryExt
    SvcImpl --> EmailSrv
    EmailSrv --> EmailExt

    Orchestration --> Client
    Orchestration --> API
    Orchestration --> Db

    %% Click Events
    click Client "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/frontend/src"
    click AuthMod "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/frontend/src/auth"
    click EcomMod "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/frontend/src/ecomerce"
    click CartMod "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/frontend/src/Cart"
    click AdminMod "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/frontend/src/Admin"
    click Router "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/frontend/src/router/AppRouter.jsx"
    click AuthCtx "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/frontend/src/auth/context/AuthContext.jsx"
    click CartCtx "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/frontend/src/Cart/context/CartContext.jsx"
    click ProdCtx "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/frontend/src/ecomerce/context/ProductosContext.jsx"
    click API "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/backend/src/main/java/com/api/ecommerce/EcommerceApplication.java"
    click SecurityCfg "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/backend/src/main/java/com/api/ecommerce/security/SecurityConfig.java"
    click JwtFil "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/backend/src/main/java/com/api/ecommerce/security/JwtFilter.java"
    click JwtU "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/backend/src/main/java/com/api/ecommerce/security/JwtUtil.java"
    click Controllers "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/backend/src/main/java/com/api/ecommerce/controller"
    click SvcInt "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/backend/src/main/java/com/api/ecommerce/service"
    click SvcImpl "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/backend/src/main/java/com/api/ecommerce/service/implementation"
    click Repos "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/backend/src/main/java/com/api/ecommerce/repository"
    click Models "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/backend/src/main/java/com/api/ecommerce/model"
    click DTOs "https://github.com/martincapece/tpo_aplicaciones_interactivas/tree/main/backend/src/main/java/com/api/ecommerce/dto"
    click Exceptions "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/backend/src/main/java/com/api/ecommerce/exceptions/GlobalExceptionHandler.java"
    click Config "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/backend/src/main/java/com/api/ecommerce/config/CloudinaryConfig.java"
    click Orchestration "https://github.com/martincapece/tpo_aplicaciones_interactivas/blob/main/docker-compose.yml"

    %% Styles
    classDef frontend fill:#ccffcc,stroke:#339933,color:#000000
    classDef backend fill:#cceeff,stroke:#333399,color:#000000
    classDef database fill:#ffcc99,stroke:#994d00,color:#000000
    classDef external fill:#e5ccff,stroke:#800080,color:#000000
    classDef orchestration fill:#ffeecc,stroke:#cc8400,color:#000000
```
