# humbertovitalino/taskflow architecture

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

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

## Overview

##### Project type and purpose
- TaskFlow is a full-stack task management application with a React/TypeScript frontend and a C#/.NET backend.
- The backend is structured into three layers:
- API layer (ASP.NET Core controllers and HTTP endpoints)
- Core layer (domain entities, use-case interactor logic, JWT services)
- Infra layer (EF Core DbContext, migrations, repositories, UnitOfWork)
- A relational database (e.g., SQL Server) is used via Entity Framework Core.

##### Main components
a. Frontend (React/TypeScript SPA)
b. Backend API (ASP.NET Core Web API controllers)
c. Core domain & use-case services
d. Infrastructure (EF Core DbContext, repositories, UnitOfWork)
e. Database (SQL Server or containerized database)
f. Cross-cutting concerns (JWT authentication, Docker/Docker-Compose)

##### Relationships & data flows
- User’s browser ←→ Frontend (UI components, React router)
- Frontend → HTTP(S) → Backend API endpoints
- API Controllers → invoke corresponding UseCase interactor in Core
- UseCases → coordinate business logic, validate requests, map DTOs
- UseCases → call UnitOfWork → specific repository → EF Core DbContext
- DbContext → CRUD operations → Database
- JWT middleware: API validates tokens on protected endpoints, issues tokens via Core’s JwtTokenService
- Docker Compose: brings up API container + Database container for local deployment

##### Architectural patterns & design principles
- Layered architecture (Presentation → UseCases → Infrastructure)
- Clean Architecture / Ports & Adapters: Core uses repository interfaces, Infra implements them
- Dependency Injection (services and repositories registered via ServiceExtensions)
- CQRS‐like separation: distinct use cases per operation, clear input/output boundaries
- Unit testing of each use-case in isolation (UnitTests project)

##### Technologies & frameworks
- Frontend: React, TypeScript, Create React App
- Backend API: ASP.NET Core, C#, Controllers, Swagger/HTTP client definitions (.http file)
- Domain: C# classes, FluentValidation (validators), AutoMapper (mappers)
- Infra: Entity Framework Core, Migrations, SQL Server
- Auth: JWT (JwtTokenService, filters)
- DevOps: Docker, docker‐compose.yml

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend" 
        UI["React/TypeScript SPA"]:::frontend
    end

    %% Backend API Layer
    subgraph "Backend - API Container"
        APILayer["ASP.NET Core API\n(Controllers)"]:::api
        HttpClient["API HTTP definitions\n(.http)"]:::api
        DockerFile["Dockerfile"]:::container
        ComposeAPI["docker-compose.yml"]:::container
    end

    %% Backend Core Layer
    subgraph "Backend - Core"
        Entities["Domain Entities"]:::domain
        Enums["Enums (StatusEnum)"]:::domain
        Interfaces["Repository Interfaces\n& UnitOfWork"]:::domain
        JwtServices["JwtTokenService &\nAuthorization Filter"]:::auth
        ServiceExtCore["ServiceExtensions"]:::domain
        UseCases["Use Cases\n(Interactors)"]:::domain
    end

    %% Backend Infrastructure Layer
    subgraph "Backend - Infra"
        DbContext["AppDbContext"]:::infra
        Migrations["Migrations"]:::infra
        Repositories["Repositories & UnitOfWork\n(EF Core)"]:::infra
        ServiceExtInfra["ServiceExtensions"]:::infra
    end

    %% Unit Tests
    subgraph "Unit Tests"
        UnitTests["Use Cases Unit Tests"]:::test
    end

    %% Database
    DB["SQL Server"]:::db

    %% Docker Compose
    DockerCompose["Docker Compose"]:::container

    %% Data Flows
    User["User"]:::external --> UI
    UI -->|"HTTPS/REST"| APILayer
    APILayer -->|"invoke"| UseCases
    APILayer -->|"JWT Validate/Issue"| JwtServices
    UseCases -->|"use repo interfaces"| Interfaces
    UseCases -->|"validate & map"| JwtServices
    UseCases --> UnitTests
    Interfaces -->|"implemented by"| Repositories
    Repositories -->|"EF Core"| DbContext
    DbContext -->|"CRUD Operations"| DB
    DockerCompose --> APILayer
    DockerCompose --> DB

    %% Additional Connections
    APILayer --> HttpClient
    APILayer --> DockerFile
    APILayer --> ComposeAPI

    %% Click Events
    click UI "https://github.com/humbertovitalino/taskflow/tree/main/frontend/taskflow-frontend"
    click APILayer "https://github.com/humbertovitalino/taskflow/tree/main/backend/API"
    click HttpClient "https://github.com/humbertovitalino/taskflow/blob/main/backend/API/API.http"
    click DockerFile "https://github.com/humbertovitalino/taskflow/tree/main/backend/API/Dockerfile"
    click ComposeAPI "https://github.com/humbertovitalino/taskflow/blob/main/backend/API/docker-compose.yml"
    click Entities "https://github.com/humbertovitalino/taskflow/tree/main/backend/Core/Entities"
    click Enums "https://github.com/humbertovitalino/taskflow/blob/main/backend/Core/Enums/StatusEnum.cs"
    click Interfaces "https://github.com/humbertovitalino/taskflow/tree/main/backend/Core/Interfaces"
    click JwtServices "https://github.com/humbertovitalino/taskflow/blob/main/backend/Core/Services/JwtTokenService.cs"
    click ServiceExtCore "https://github.com/humbertovitalino/taskflow/blob/main/backend/Core/Services/ServiceExtensions.cs"
    click UseCases "https://github.com/humbertovitalino/taskflow/tree/main/backend/Core/UseCases"
    click DbContext "https://github.com/humbertovitalino/taskflow/blob/main/backend/Infra/Context/AppDbContext.cs"
    click Migrations "https://github.com/humbertovitalino/taskflow/tree/main/backend/Infra/Migrations"
    click Repositories "https://github.com/humbertovitalino/taskflow/tree/main/backend/Infra/Repositories"
    click ServiceExtInfra "https://github.com/humbertovitalino/taskflow/blob/main/backend/Infra/Services/ServiceExtensions.cs"
    click UnitTests "https://github.com/humbertovitalino/taskflow/tree/main/backend/UnitTests"

    %% Styles
    classDef frontend fill:#D6EAF8,stroke:#3498DB,color:#1B4F72
    classDef api fill:#EBF5FB,stroke:#5DADE2,color:#1B4F72
    classDef domain fill:#E8DAEF,stroke:#A569BD,color:#4A235A
    classDef infra fill:#EAFAF1,stroke:#58D68D,color:#1D8348
    classDef container fill:#FDEDEC,stroke:#EC7063,color:#641E16
    classDef db fill:#FEF9E7,stroke:#F4D03F,color:#7D6608
    classDef auth fill:#F9E79F,stroke:#F4D03F,color:#7D6608
    classDef test fill:#F5EEF8,stroke:#BB8FCE,color:#6C3483
    classDef external fill:#F2F3F4,stroke:#CCD1D1,color:#424949
```
