How dazanez/dgang works
Para crear un diagrama de arquitectura preciso y completo de “Dgang! for Friends”, sigue estos pasos adaptados a su estructura de microservicios.
Identificación del tipo de proyecto y su propósito
• Proyecto: aplicación “BeReal” privada basada en microservicios.
• Propósito: permitir a grupos privados de amigos compartir fotos diarias mediante un sistema de alertas y validaciones.
Análisis de la estructura de archivos
• Existen carpetas independientes:
• auth-service/ (autenticación JWT)
• user-group-service/ (gestión de grupos y miembros)
• El README menciona además gateway/, validation-service/, media-feed-service/, notification-service/ y docker-compose.yml.
• Cada microservicio tiene su propio Dockerfile, requirements.txt (Python/Node.js o Java), y carpeta src con código de rutas, modelos y configuración.
Componentes principales a representar
a. Cliente (app móvil o web)
b. API Gateway (puerta de enlace única)
c. Auth Service (registro, login, JWT)
d. User Group Service (creación y gestión de grupos, preguntas secretas)
e. Validation Service (verifica respuestas de reglas de ingreso)
f. Media Feed Service (subida y consulta de fotos)
g. Notification Service (cron de alertas diarias)
h. Bases de datos independientes por servicio (PostgreSQL o MongoDB)
i. Orquestación con Docker Compose
Relaciones e interacciones
• Cliente → API Gateway (HTTPS REST)
• API Gateway → cada microservicio (endpoints bien definidos)
• Microservicios ↔ sus propias bases de datos
• User Group Service ↔ Validation Service (REST sync para verificar respuestas)
• Notification Service → Media Feed Service o Gateway (para disparar alertas o notificaciones)
Patrones arquitectónicos y principios
• Microservicios desacoplados: cada servicio tiene su CI/CD y DB propia.
• API Gateway centraliza la autenticación y el ruteo.
• Comunicación via REST (HTTP/JSON).
• Contenerización con Docker y orquestación local con Docker Compose.
Tecnologías relevantes
• Node.js (Express) o Spring Boot para servicios
• Python o Java en algunos microservicios (según carpetas)
• PostgreSQL / MongoDB por servicio
• Dockerfile + docker-compose.yml
• JWT para auth
• CI/CD (no detallado, pero implícito)
Guía para elaborar el diagrama
a. Dibuja rectángulos grandes para cada microservicio y base de datos asociada debajo de cada uno.
b. Sitúa el API Gateway en la capa frontal entre Cliente y Microservicios.
c. Conecta:
• Flechas unidireccionales Cliente → Gateway → {Auth, User Group, Validation, Media Feed, Notification}
• Flechas internas (por ejemplo, User Group → Validation Service)
• Flechas de cada servicio hacia su propia base de datos.
d. Agrega un rectángulo o icono de Docker Compose/Orquestador en un nivel lateral para indicar el despliegue.
• Azul para servicios de dominio (Auth, User Group, etc.)
• Verde para bases de datos
• Naranja para infraestructura (API Gateway, Docker Compose)
• Flechas negras para llamadas REST, flechas punteadas para dependencias secundarias (por ejemplo, Notification → Media Feed).
f. Etiqueta cada componente con nombre y tecnología principal (p. ej. “Auth Service (Node.js/Express, JWT)”).
Elementos imprescindibles
• Títulos claros y leyenda de colores/estilos.
• Flechas direccionales con notas de protocolo (REST/HTTP).
• Agrupación visual (por ejemplo, “Capa de Servicios”, “Capa de Datos”, “Infraestructura”).
• Notas breves junto a conexiones críticas (p. ej. “Validation Service valida respuestas secretas”).
Con este enfoque tendrás un diagrama expuesto, modular y alineado a la arquitectura de microservicios de “Dgang! for Friends”.