How martincapece/tpo_aplicaciones_interactivas works
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.