# reyer3/taskmaster-todo-app architecture

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

- Interactive diagram: https://gitdiagram.com/reyer3/taskmaster-todo-app
- Repository: https://github.com/reyer3/taskmaster-todo-app

## Overview

A continuación, se detalla cómo elaborar un diagrama de arquitectura que capture con precisión la estructura y el funcionamiento de TaskMaster, una aplicación full-stack de gestión de tareas construida sobre principios DDD-Light y Clean Architecture.

##### Proyecto y propósito
- Se trata de una aplicación de gestión de tareas con autenticación y manejo de notificaciones. La solución integra un frontend en React y un backend en Node.js/Express utilizando Prisma ORM para interactuar con una base de datos PostgreSQL.
- Además, se incorporan metodologías ágiles (Scrum, Git Flow) y se aprovecha la IA generativa para optimización y generación de código.

##### Componentes principales del sistema
a. Frontend:
- Interfaz de usuario desarrollada con React y Tailwind CSS.
- Gestión de rutas (React Router) y solicitud de datos via Axios.
- Contextos de estado (AuthContext, TasksContext, ToastContext) que encapsulan la lógica de autenticación, manejo de tareas y notificaciones.

b. Backend:
- Capa de API (endpoints REST) organizada en módulos (auth, tasks, notifications, realtime). Cada módulo posee su respectivo controller.
- Capa de dominio: Modelos de negocio (por ejemplo, User, Task, Notification y NotificationPreference) que encapsulan la lógica y las reglas del negocio.
- Capa de infraestructura:
- Gestión de la base de datos mediante Prisma, incluyendo migraciones y modelo en schema.prisma.
- Repositorios que abstractan operaciones de datos (user.repository, task.repository, etc.).
- Comunicación mediante eventos con publicadores/subscribers (por ejemplo, para notificaciones via email y websockets).
- Middlewares para autenticación, logging y manejo de errores.
- Configuración de websockets para notificaciones en tiempo real.
- Capa de servicios: Lógica de negocio encapsulada en servicios (auth.service, task.service, notification.service, email.service) que orquesta las operaciones entre la API, dominio e infraestructura.
- Bootstrap y utilidades para inicialización y manejo centralizado de errores.

c. Base de datos:
- PostgreSQL, configurada a través de Prisma ORM.
- Conjunto de migraciones para definir la estructura y cambios en esquemas.

d. DevOps y flujo de trabajo:
- Git Flow documentado para el desarrollo con ramas feature, release y hotfix.
- Scripts (por ejemplo, git-flow-helper.sh) para facilitar el uso de Git Flow.
- Integración y despliegue continuo usando GitHub Actions, Railway y Vercel.

##### Relaciones e Interacciones
- El frontend hace llamadas HTTP (utilizando Axios) a la API del backend mediante endpoints REST bien definidos.
- La capa API del backend sirve de interfaz que recibe las peticiones, las manda a los servicios y retorna respuestas.
- Los servicios encapsulan la lógica de negocio y se comunican con la capa de dominio y la infraestructura (repositorios y eventos).
- Los repositorios gestionan la persistencia de datos en la base de datos, mientras que la capa de eventos se encarga de la notificación y comunicación en tiempo real.
- Los middlewares interceptan las solicitudes para la autenticación, logging y manejo de errores, garantizando robustez en el sistema.

##### Principios arquitecturales y patrones relevantes
- Se adopta una aproximación DDD-Light combinada con Clean Architecture, dividiendo la aplicación en capas (API, servicios, dominio, infraestructura) para facilitar la separación de preocupaciones.
- Uso de patrones de repositorio y eventos para desacoplar la lógica de negocio de la persistencia y la comunicación.
- En el frontend, se utiliza Context API para la gestión del estado global, complementado con componentes de React para dividir la responsabilidad en vistas y servicios específicos.

##### Directrices para diseñar el diagrama
a. Dividir el diagrama en dos secciones principales: Frontend y Backend.
- Para el Frontend, incluir componentes como: “Interfaz de Usuario (React App)”, “Contexts” (Auth, Tasks, Toast), y “Servicios (Axios, API Gateway)”.
- Para el Backend, representar las siguientes capas:
1) API Layer: Dividida en módulos (auth, tasks, notifications, realtime) con sus respectivos controllers.
2) Application/Services Layer: Componentes de lógica de negocio.
3) Domain Layer: Modelos de negocio (User, Task, Notification, etc.).
4) Infrastructure Layer: Repositorios, eventos (publicadores y suscriptores), middlewares, base de datos (Prisma + PostgreSQL) y websockets.
b. Mostrar la interacción entre las capas:
- Flechas direccionales que indiquen cómo el Frontend se comunica con la API, y cómo la API interactúa internamente con los servicios, que a su vez acceden al dominio e infraestructura.
- Incluir conexiones de eventos y subsistemas de notificaciones (por ejemplo, las notificaciones en tiempo real y emails).
c. Incluir elementos visuales:
- Etiquetas claras para cada componente.
- Flechas ´orientadas´ que indiquen el flujo de datos y dependencias entre componentes.
- Usar colores o formas diferentes para distinguir entre componentes de frontend, backend, base de datos y servicios externos.
- Representar los scripts y flujos de trabajo devops (Git Flow) en una sección complementaria que evidencie la integración y despliegue del proyecto.

##### Aspectos específicos para este proyecto
- Enfatizar la separación entre el frontend (React) y el backend (Node.js/Express + Prisma) para resaltar el modelo full-stack.
- Mostrar la lógica modularizada en el backend en relación a DDD-Light, con énfasis en la separación de la lógica de negocio (Domain) y las operaciones de infraestructura.
- Destacar el uso de eventos para lograr una comunicación asíncrona (entre repositorios, notificaciones y websockets).
- Incluir un pequeño apartado que muestre el diseño del flujo de Git y los procesos de integración/deployment (principalmente para comprender la gobernanza del código).

Esta aproximación al diagrama capturará de forma detallada la arquitectura integral del sistema, destacando cada capa y su interacción, lo que facilitará futuras expansiones, mantenimientos y la participación de nuevos desarrolladores en el proyecto.

En resumen, el diagrama debe reflejar:
- Frontend en React con Context API y servicios de API
- Backend modularizado en capas: API, Servicios, Dominio, Infraestructura (incluyendo bases de datos, repositorios, eventos, y middlewares)
- Flujo de datos desde la petición HTTP hasta la persistencia en PostgreSQL y respuestas vía notificaciones en tiempo real.
- Elementos de DevOps y Git Flow, enfatizando en la cultura del desarrollo colaborativo y automatización de despliegue.

¡Esta representación ayudará a visualizar claramente la arquitectura del proyecto TaskMaster y servirá como una excelente herramienta de comunicación para el equipo de ingeniería!

## Diagram (Mermaid)

```mermaid
flowchart TD

    subgraph "Frontend"
        F1("Interfaz de Usuario (React App)"):::frontend
        F2("Contexts (Auth,Tasks,Toast)"):::frontend
        F3("Servicios API (Axios & Token)"):::frontend
    end

    subgraph "Backend"
        subgraph "API Layer"
            B1("Auth Controller"):::backend
            B2("Task Controller"):::backend
            B3("Notification Controller"):::backend
            B4("Realtime Controller"):::backend
        end
        subgraph "Services Layer"
            S1("Auth Service"):::service
            S2("Task Service"):::service
            S3("Notification Service"):::service
            S4("Email Service"):::service
        end
        subgraph "Domain Layer"
            D1("User Model"):::domain
            D2("Task Model"):::domain
            D3("Notification Models"):::domain
        end
        subgraph "Infrastructure Layer"
            I1("Database (Prisma & PostgreSQL)"):::infra
            I2("Repositories"):::infra
            I3("Events (Publisher/Logger)"):::infra
            I4("Subscribers (Email & Notification)"):::infra
            I5("Websockets"):::infra
            I6("Middlewares"):::infra
        end
    end

    subgraph "DevOps & Workflow"
        DEV1("Git Flow Scripts"):::devops
        DEV2("Workflow & Architecture Docs"):::devops
    end

    %% Frontend interactions
    F1 --> F2
    F1 --> F3
    F3 -->|"RESTCalls"| B1
    F3 -->|"RESTCalls"| B2
    F3 -->|"RESTCalls"| B3
    F3 -->|"RESTCalls"| B4

    %% Backend Layer interactions
    B1 -->|"calls"| S1
    B2 -->|"calls"| S2
    B3 -->|"calls"| S3
    B4 -->|"calls"| S4

    S1 -->|"business"| D1
    S2 -->|"business"| D2
    S3 -->|"business"| D3
    S3 -->|"triggers"| I3
    S4 -->|"triggers"| I4

    I2 -->|"persistsTo"| I1
    I3 -->|"notifies"| I5

    %% DevOps connections (indicative)
    DEV1 -->|"integrates"| F1
    DEV1 -->|"integrates"| B1
    DEV2 -->|"documents"| B1

    %% Click Events for Frontend
    click F1 "https://github.com/reyer3/taskmaster-todo-app/tree/main/frontend/"
    click F2 "https://github.com/reyer3/taskmaster-todo-app/tree/main/frontend/src/context/"
    click F3 "https://github.com/reyer3/taskmaster-todo-app/blob/main/frontend/src/services/api.js"
    click F3 "https://github.com/reyer3/taskmaster-todo-app/blob/main/frontend/src/services/token.service.js"

    %% Click Events for Backend API Layer
    click B1 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/api/auth/"
    click B2 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/api/tasks/"
    click B3 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/api/notifications/"
    click B4 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/api/realtime/"

    %% Click Events for Services Layer
    click S1 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/services/auth.service.js"
    click S2 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/services/task.service.js"
    click S3 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/services/notification.service.js"
    click S4 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/services/email.service.js"

    %% Click Events for Domain Layer
    click D1 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/domain/auth/user.model.js"
    click D2 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/domain/tasks/task.model.js"
    click D3 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/domain/notifications/"

    %% Click Events for Infrastructure Layer
    click I1 "https://github.com/reyer3/taskmaster-todo-app/blob/main/backend/src/infrastructure/database/prisma/schema.prisma"
    click I1 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/infrastructure/database/prisma/migrations/"
    click I2 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/infrastructure/repositories/"
    click I3 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/infrastructure/events/"
    click I4 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/infrastructure/events/subscribers/"
    click I5 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/infrastructure/websockets/"
    click I6 "https://github.com/reyer3/taskmaster-todo-app/tree/main/backend/src/infrastructure/middlewares/"

    %% Click Events for DevOps
    click DEV1 "https://github.com/reyer3/taskmaster-todo-app/blob/main/scripts/git-flow-helper.sh"
    click DEV2 "https://github.com/reyer3/taskmaster-todo-app/blob/main/docs/workflow/git-flow-guide.md"

    %% Styles
    classDef frontend fill:#fce1f5,stroke:#b85fc8,stroke-width:2px;
    classDef backend fill:#e0f7fa,stroke:#00acc1,stroke-width:2px;
    classDef service fill:#e8f5e9,stroke:#43a047,stroke-width:2px;
    classDef domain fill:#f3e5f5,stroke:#8e24aa,stroke-width:2px;
    classDef infra fill:#fff9c4,stroke:#f9a825,stroke-width:2px;
    classDef devops fill:#ffe0b2,stroke:#fb8c00,stroke-width:2px;
```
