# adesduende/taskflow architecture

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

- Interactive diagram: https://gitdiagram.com/adesduende/taskflow
- Repository: https://github.com/adesduende/taskflow

## Overview

Para trazar un diagrama de arquitectura preciso y detallado de **TaskFlow**, sigue estos pasos adaptados a su Clean Architecture y patrones CQRS:

##### Identificación del tipo y propósito del proyecto
- Se trata de una **API REST** moderna de gestión de tareas, construida con **.NET 8**, que implementa **Clean Architecture**, **DDD**, **CQRS** y el patrón **Mediator**.
- Ofrece endpoints HTTP (Minimal APIs) en la capa de presentación y separa responsabilidades en capas claras: WebApi, Application, Domain e Infrastructure.

##### Análisis de la estructura de ficheros
- **TaskFlow.WebApi**: capa de presentación, definición de endpoints, configuración de JWT, Swagger, DI.
- **TaskFlow.Application**: casos de uso (UseCases), comandos y queries (CQRS), DTOs, validadores (FluentValidation), mappers, interfaces (IJwtTokenGenerator, IMediator, IPasswordHasher, repositories abstractions).
- **TaskFlow.Domain**: entidades, agregados (Group), enums (Status, Priority), excepciones de dominio, interfaces de repositorio (IGroupRepository, ITaskRepository, IUserRepository).
- **TaskFlow.Infrastructure**: implementaciones de repositorios (in-memory), generador JWT, hash de contraseñas, mediator, DependencyInjection para registrar servicios concretos.
- No hay base de datos real aún; usa repositorios in-memory pero la arquitectura facilita futuro cambio a EF Core, SQL, etc.

##### Componentes principales a representar
- **Cliente HTTP (Browser, Postman, App móvil)**
↳ realiza peticiones REST.
- **API Gateway / Entry Point**
- TaskFlow.WebApi (Program.cs, global usings, endpoints).
- Middleware de Autenticación JWT, autorización, validación (FluentValidation).
- **Capa de Application**
- Handlers (CreateTaskHandler, GetAllTasksHandler, etc.)
- Commands & Queries (CQRS)
- IMediator (punto de orquestación interno).
- **Capa de Domain**
- Entidades y agregados (Task, User, Group).
- Lógica de negocio mínima embebida en entidades.
- Excepciones de dominio.
- **Capa de Infrastructure**
- JWT Token Generator
- PasswordHasher
- Repositorios InMemory (implementaciones de ITaskRepository, IUserRepository, IGroupRepository)
- Mediator interno (TaskFlowMediator)
- **Servicios externos** (futuros): DB relacional, caché, colas, logging, etc.

##### Relaciones e interacción entre componentes
- El **cliente** envía una petición HTTP ➔ **WebApi**
- **WebApi**:
a) Valida JWT y autorización
b) Deserializa payload y aplica validaciones (FluentValidation)
c) Crea un **Command** o **Query** y lo pasa a **IMediator**
- **IMediator** (Infrastructure.Mediator) enruta al **Handler** correspondiente en Application
- **Handler**:
a) Invoca al **repositorio** (interfaz definida en Domain)
b) Repositorios in-memory (Infrastructure) realizan operaciones CRUD
c) Manipula **entidades** de Domain y devuelve DTO
- **WebApi** serializa la respuesta y la retorna al cliente.

##### Patrones y principios destacados
- **Clean Architecture**: separación clara de capas, dependencia unidireccional hacia adentro.
- **DDD**: entidades, agregados, excepciones de dominio.
- **CQRS**: separación comandos (write) / queries (read)
- **Mediator Pattern**: desacopla emisores de lógica de negocio.
- **Repository Pattern**: abstracción de acceso a datos.
- **FluentValidation**: validación de entrada antes de llegar a la lógica de negocio.
- **JWT Authentication**: capa de seguridad en WebApi.

##### Guía para el diagrama
- Dibuja **4 cajas** principales, apiladas de arriba hacia abajo o de izquierda a derecha:
1) Cliente
2) WebApi (presentación)
3) Application (UseCases / Mediator)
4) Domain + Infrastructure
- Dentro de Infrastructure, puedes subdividir en: Auth (JwtTokenGenerator), HashPassword, Mediator impl., Repositorios (InMemory).
- Muestra flechas con direccionalidad:
- HTTP ➔ WebApi ➔ Mediator ➔ Handler ➔ Repositorio ➔ (Entities de Domain)
- Respuesta inversa siguiendo la misma ruta.
- Capa de presentación (azul),
- Capa de aplicación (verde),
- Capa de dominio (amarillo),
- Capa de infraestructura (naranja).
- Etiqueta cada componente con nombre de proyecto/namespace (p. ej. TaskFlow.WebApi, TaskFlow.Application, ITaskRepository).

##### Elementos a incluir
- Caja “TaskFlow.WebApi” con subcomponentes: Endpoints, Middleware JWT, Swagger.
- Caja “TaskFlow.Application” con Mediator, UseCases (CreateTask, GetAllTasks, etc.).
- Caja “TaskFlow.Domain” con Entidades (Task, User, Group), Enums, Excepciones, Interfaces de Repositorio.
- Caja “TaskFlow.Infrastructure” con implementaciones concretas: InMemoryRepos, JwtTokenGenerator, PasswordHasher, TaskFlowMediator.
- Flechas de flujo de datos y dependencias.
- Leyenda de colores/íconos para cada capa.

Con este diagrama, el equipo podrá visualizar claramente la separación de responsabilidades, los flujos de datos y los puntos de extensión (p. ej. reemplazo de repositorios in-memory por una base de datos real). ¡Detalla cada elemento y relación para maximizar la claridad!

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client (Browser/Postman/Mobile)"]:::external
    subgraph "Presentation Layer"
        WebApi["TaskFlow.WebApi\n- Endpoints\n- JWT Middleware\n- Swagger"]:::presentation
    end
    subgraph "Application Layer"
        Mediator["IMediator"]:::application
        UseCases["UseCases (Commands & Queries)"]:::application
    end
    subgraph "Domain Layer"
        Entities["Entities & Aggregates\n(Task, User, Group)"]:::domain
        Enums["Enums & Exceptions"]:::domain
        RepoInterfaces["Repository Interfaces"]:::domain
    end
    subgraph "Infrastructure Layer"
        JwtGen["JwtTokenGenerator"]:::infra
        PwHash["PasswordHasher"]:::infra
        MediatorImpl["TaskFlowMediator"]:::infra
        Repos["InMemory Repositories"]:::infra
    end

    Client -->|HTTP Request| WebApi
    WebApi -->|Create Command/Query| Mediator
    Mediator -->|Route to Handler| UseCases
    UseCases -->|Invoke| RepoInterfaces
    RepoInterfaces -->|Implemented by| Repos
    Repos -->|CRUD on| Entities
    UseCases -->|Manipulate| Entities
    Entities -->|Use Enums/Exceptions| Enums

    click WebApi "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.WebApi/Program.cs"
    click Mediator "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Application/Interfaces/IMediator.cs"
    click UseCases "https://github.com/adesduende/taskflow/tree/main/src/TaskFlow.Application/UseCases"
    click Entities "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Domain/Entities/Task.cs"
    click Enums "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Domain/Enums/StatusEnum.cs"
    click RepoInterfaces "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Domain/Repositories/ITaskRepository.cs"
    click JwtGen "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Infrastructure/Auth/JwtTokenGenerator.cs"
    click PwHash "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Infrastructure/HashPassword/PasswordHasher.cs"
    click MediatorImpl "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Infrastructure/Mediator/TaskFlowMediator.cs"
    click Repos "https://github.com/adesduende/taskflow/blob/main/src/TaskFlow.Infrastructure/Repositories/InMemory/TaskInMemoryRepository.cs"

    classDef presentation fill:#D0E8FF,stroke:#4D89F9,color:#000;
    classDef application fill:#DFFFD0,stroke:#6FBF00,color:#000;
    classDef domain fill:#FFF2B8,stroke:#E6B800,color:#000;
    classDef infra fill:#FFE4C4,stroke:#FF8C00,color:#000;
    classDef external fill:#F0F0F0,stroke:#CCCCCC,color:#000;
```
