# dazanez/dgang architecture

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

- Interactive diagram: https://gitdiagram.com/dazanez/dgang
- Repository: https://github.com/dazanez/dgang

## Overview

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”.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Infrastructure Layer"
        Client["Client App (Mobile/Web)"]:::infra
        Gateway["API Gateway (Node.js/Express)"]:::infra
        Compose["Docker Compose Orchestrator"]:::infra
    end

    subgraph "Service Layer"
        Auth["Auth Service (Node.js/Express, JWT)"]:::domain
        UserGroup["User Group Service (Python, Flask)"]:::domain
        Validation["Validation Service (Python, Flask)"]:::domain
        MediaFeed["Media Feed Service (Python, Flask)"]:::domain
        Notification["Notification Service (Python, Celery)"]:::domain
    end

    subgraph "Data Layer"
        AuthDB["Auth DB (PostgreSQL)"]:::db
        UGDB["User Group DB (MongoDB)"]:::db
        ValDB["Validation DB (PostgreSQL)"]:::db
        MediaDB["Media Feed DB (MongoDB)"]:::db
        NotifDB["Notification DB (PostgreSQL)"]:::db
    end

    Client -->|"REST/HTTP"| Gateway
    Gateway -->|"JWT Auth"| Auth
    Gateway -->|"Group Management"| UserGroup
    Gateway -->|"Validation Endpoint"| Validation
    Gateway -->|"Media Feed"| MediaFeed
    Gateway -->|"Schedule Alerts"| Notification

    Auth --> AuthDB
    UserGroup --> UGDB
    Validation --> ValDB
    MediaFeed --> MediaDB
    Notification --> NotifDB

    UserGroup -->|"sync REST"| Validation
    Notification -.->|"triggers"| MediaFeed

    Compose --> Client
    Compose --> Gateway
    Compose --> Auth
    Compose --> UserGroup
    Compose --> Validation
    Compose --> MediaFeed
    Compose --> Notification

    click Auth "https://github.com/dazanez/dgang/tree/main/auth-service/"
    click UserGroup "https://github.com/dazanez/dgang/tree/main/user-group-service/"

    classDef domain fill:#cce5ff,stroke:#66b0ff,color:#004085
    classDef db fill:#d4edda,stroke:#28a745,color:#155724
    classDef infra fill:#ffe5b4,stroke:#ffb84d,color:#8a6d3b
```
