SubastApp - Arquitectura del Sistema

🏗️ Visión General de la Arquitectura

SubastApp es una aplicación de subastas en tiempo real que utiliza una arquitectura de microservicios containerizada con comunicación en tiempo real mediante WebSockets.

📊 Diagrama de Arquitectura

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Cliente Web │ │ Cliente Web │ │ Cliente Web │ │ (React App) │ │ (React App) │ │ (React App) │ └─────────┬───────┘ └─────────┬───────┘ └─────────┬───────┘ │ │ │ └──────────────────────┼──────────────────────┘ │ ┌─────────────▼─────────────┐ │ Nginx (80/443) │ │ (Proxy + Static Files) │ └─────────────┬─────────────┘ │ ┌─────────────▼─────────────┐ │ Backend (3001) │ │ (Node.js + Socket.IO) │ └─────────────┬─────────────┘ │ ┌─────────────▼─────────────┐ │ MySQL (3306) │ │ (Base de Datos) │ └───────────────────────────┘

🐳 Arquitectura de Contenedores

La aplicación utiliza Docker Compose para orquestar los siguientes servicios:

mysql: Base de datos MySQL 8.0
backend: API Node.js con Socket.IO
nginx: Proxy reverso y servidor web

🔧 Componentes del Sistema

1. Frontend (React + TypeScript)

Tecnologías:

React 18.2.0
TypeScript 5.0.2
Vite 4.4.5 (build tool)
Tailwind CSS 3.3.3
Zustand 4.4.1 (state management)
Socket.IO Client 4.7.2

2. Backend (Node.js + TypeScript)

Tecnologías:

Node.js 18
TypeScript 5.9.2
Express 5.1.0
Socket.IO 4.8.1
Prisma 6.14.0 (ORM)
MySQL2 3.14.3

3. Base de Datos (MySQL)

Esquema de base de datos:

Usuario: id, email, nombre, creditos, orden, salioDePuja, createdAt, updatedAt
Item: id, rapidapiId, nombre, pais, equipo, posicion, subastado, precioInicial, imagen, ganadorId, createdAt, updatedAt
Puja: id, monto, itemId, usuarioId, createdAt
Configuracion: id, clave, valor, descripcion
EstadoSubasta: id, subastaActiva, turnoActual, tiempoRestante, createdAt, updatedAt

4. Proxy/Web Server (Nginx)

Nginx actúa como:

Servidor de archivos estáticos del frontend
Proxy reverso para la API del backend
Proxy para WebSockets de Socket.IO

🔄 Flujo de Datos

1. Autenticación

Cliente → Nginx → Backend → MySQL → Respuesta JSON

2. Subasta en Tiempo Real

Cliente A → Socket.IO → Backend → MySQL → Broadcast → Cliente B, C, D...

3. Pujas

Cliente → HTTP POST → Backend → MySQL → Broadcast → Todos los clientes

🔒 Seguridad

Configuraciones de Seguridad Implementadas:

Docker Security: Contenedores ejecutándose como usuario no-root
Network Security: Solo puertos necesarios expuestos (80, 443, 3001, 3306)
Application Security: CORS configurado para IPs específicas
Data Security: Credenciales de base de datos específicas

📈 Escalabilidad

Estrategias de Escalabilidad:

Horizontal Scaling: Backend puede escalar horizontalmente
Vertical Scaling: Droplet puede aumentar recursos
Caching: Redis puede agregarse para cache

🔍 Monitoreo y Logs

Logs Disponibles:

Application Logs: Logs de Node.js en contenedor backend
Infrastructure Logs: Logs de Docker Compose, Nginx, MySQL
System Logs: Logs del sistema operativo, Docker daemon

🚀 Deployment

Infraestructura como Código:

Terraform: Definición de recursos Digital Ocean
GitHub Actions: CI/CD pipeline
Docker: Imágenes optimizadas, multi-stage builds

📊 Métricas y KPIs

Métricas de Rendimiento:

Application Metrics: Tiempo de respuesta de API, conexiones WebSocket
Infrastructure Metrics: Uso de CPU y memoria, espacio en disco
Business Metrics: Número de usuarios activos, pujas por minuto

Conclusión

Esta arquitectura está diseñada para ser escalable, mantenible y segura, permitiendo futuras mejoras y optimizaciones según las necesidades del negocio.