How adesduende/taskflow works
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!