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