# zodiaco1999/dotnetcleanarchitecture architecture

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

- Interactive diagram: https://gitdiagram.com/zodiaco1999/dotnetcleanarchitecture
- Repository: https://github.com/zodiaco1999/dotnetcleanarchitecture

## Overview

##### Project type and purpose
- This is a .NET 8.0 backend API project using the Clean Architecture pattern.
- Its domain is vehicle rentals (“Alquileres”), vehicle searching, user management, and reviews.
- It’s structured into four main assemblies:
- Api (presentation)
- Application (use-case/business logic)
- Domain (core entities, value objects, domain events)
- Infrastructure (EF Core DbContext, repositories, migrations, email/clock services)

##### File structure
- Top-level solution: CleanArchitecture.sln
- CleanArquitecture.Api
- Controllers → HTTP endpoints
- Middleware, Extensions, Program.cs, appsettings.json
- CleanArchitecture.Application
- Abstractions (ICommand/IQuery, behaviors, clock, email, data)
- Use-cases under Alquileres and Vehiculos (commands, queries, handlers, validators, domain event handlers)
- DependencyInjection.cs for registering MediatR pipelines, validators, etc.
- CleanArchitecture.Domain
- Entities, value objects, errors, domain events, repository interfaces, IUnitOfWork
- CleanArchitecture.Infraestructure
- ApplicationDbContext (EF Core) + Migrations
- Repository implementations for Domain interfaces
- SqlConnectionFactory, DateTimeProvider, EmailService
- EntityTypeConfigurations

##### README
- Confirms use of “Clean Architecture” in C#/.NET 8.0.
- No further architecture details but it sets the expectation of strict layer separation.

- Presentation/API layer (CleanArquitecture.Api)
- Application layer (CleanArchitecture.Application)
- Domain layer (CleanArchitecture.Domain)
- Infrastructure layer (CleanArchitecture.Infraestructure)
- External resources: SQL Database, SMTP/Email provider, System Clock

1. Client → HTTP Controllers (Api)
2. Controllers → Mediator (ICommand/IQuery) in Application
– Show ValidationBehavior, LoggingBehavior in the pipeline
3. CommandHandler/QueryHandler in Application → Domain Entities & Domain Services
4. Handlers invoke repository interfaces (IAlquilerRepository, IUserRepository, IVehiculoRepository)
5. Repository implementations in Infrastructure → EF Core DbContext → SQL Database
6. Domain events (e.g., AlquilerReservadoDomainEvent) published → handled by Application’s DomainEventHandlers (e.g., to send emails)
7. Infrastructure EmailService and DateTimeProvider are injected into Application via abstractions

c. Architectural patterns/design principles:
- Layered (Onion/Clean) architecture – dependencies only point inward
- CQRS with MediatR-like mediator for commands/queries
- Repository + Unit of Work abstractions in Domain, implemented in Infrastructure
- Domain events for decoupled side effects (email notifications, etc.)
- Behavior pipeline for cross-cutting concerns (validation, logging)

d. Key technologies/frameworks:
- .NET 8.0, C#
- ASP.NET Core Web API
- MediatR or custom mediator abstractions
- Entity Framework Core (DbContext, Migrations)
- FluentValidation (command validators)
- Dependency Injection (built into ASP.NET Core)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% API Layer
    subgraph "API Layer"
        direction TB
        Controllers["Controllers"]:::api
        AlqController["AlquileresController"]:::api
        VehController["VehiculosController"]:::api
        Middleware["ExceptionHandlerMiddleware"]:::api
        Program["Program.cs"]:::api
        Extensions["Extensions"]:::api
        Settings["appsettings.json"]:::api
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        Abstractions["Messaging & Behaviors"]:::app
        ClockEmailAbst["Clock & Email Abstractions"]:::app
        UseCasesAlq["Alquileres Use-Cases"]:::app
        UseCasesVeh["Vehiculos Use-Cases"]:::app
        Exceptions["Exceptions"]:::app
        AppDI["DependencyInjection.cs"]:::app
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        DomAbst["Core Abstractions"]:::domain
        AlqAgg["Alquileres Aggregate"]:::domain
        VehAgg["Vehiculos Aggregate"]:::domain
        UserAgg["Users Aggregate"]:::domain
        RevAgg["Reviews Aggregate"]:::domain
        SharedVO["Shared Value Objects"]:::domain
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        direction TB
        DbContext["ApplicationDbContext & Migrations"]:::infra
        Data["Data & Type Handlers"]:::infra
        ReposImpl["Repository Implementations"]:::infra
        Configs["Entity Configurations"]:::infra
        ClockImpl["DateTimeProvider"]:::infra
        EmailImpl["EmailService"]:::infra
        InfraDI["DependencyInjection.cs"]:::infra
    end

    %% External Resources
    subgraph "External"
        direction TB
        SQLDB["SQL Database"]:::external
        SMTP["SMTP/Email Provider"]:::external
        SysClock["System Clock"]:::external
    end

    %% Connections
    Client["Client"]:::external -->|"HTTP Request"| Controllers
    Controllers -->|"calls"| Abstractions
    Abstractions -->|"invokes Pipeline"| UseCasesAlq
    Abstractions --> UseCasesVeh
    UseCasesAlq -->|"uses Entities"| AlqAgg
    UseCasesVeh --> VehAgg
    UseCasesAlq -->|"publishes DomainEvent"| DomAbst
    DomAbst -->|"handled by"| UseCasesAlq
    UseCasesAlq -->|"IAlquilerRepository"| ReposImpl
    UseCasesVeh -->|"IVehiculoRepository"| ReposImpl
    UseCasesAlq -->|"IUserRepository"| ReposImpl
    ReposImpl --> DbContext
    DbContext --> SQLDB
    UseCasesAlq -->|"IDateTimeProvider"| ClockImpl
    ClockImpl --> SysClock
    UseCasesAlq -->|"IEmailService"| EmailImpl
    EmailImpl --> SMTP

    %% Click Events - API
    click Controllers "https://github.com/zodiaco1999/dotnetcleanarchitecture/tree/main/CleanArquitecture.Api/Controllers"
    click AlqController "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArquitecture.Api/Controllers/Alquileres/AlquileresController.cs"
    click VehController "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArquitecture.Api/Controllers/Vehiculos/VehiculosController.cs"
    click Middleware "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArquitecture.Api/Middleware/ExceptionHandlerMiddleware.cs"
    click Program "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArquitecture.Api/Program.cs"
    click Extensions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArquitecture.Api/Extensions/ApplicationBuilderExtensions.cs"
    click Settings "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArquitecture.Api/appsettings.json"

    %% Click Events - Application
    click Abstractions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Messaging/ICommand.cs"
    click Abstractions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Messaging/IQuery.cs"
    click Abstractions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Messaging/ICommandHandler.cs"
    click Abstractions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Messaging/IQueryHandler.cs"
    click Abstractions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Behaviors/ValidationBehavior.cs"
    click Abstractions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Behaviors/LoggingBehavior.cs"
    click ClockEmailAbst "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Clock/IDateTimeProvider.cs"
    click ClockEmailAbst "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Abstractions/Email/IEmailService.cs"
    click UseCasesAlq "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Alquileres/GetAlquiler/GetAlquilerQuery.cs"
    click UseCasesAlq "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Alquileres/ReservarAlquiler/ReservarAlquilerCommand.cs"
    click UseCasesVeh "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Vehiculos/SearchVehiculos/SearchVehiculosQuery.cs"
    click Exceptions "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/Exceptions/ValidationException.cs"
    click AppDI "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Application/DependencyInjection.cs"

    %% Click Events - Domain
    click DomAbst "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Domain/Abstractions/Entity.cs"
    click AlqAgg "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Domain/Alquileres/Alquiler.cs"
    click VehAgg "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Domain/Vehiculos/Vehiculo.cs"
    click UserAgg "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Domain/Users/User.cs"
    click RevAgg "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Domain/Reviews/Review.cs"
    click SharedVO "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Domain/Shared/Moneda.cs"

    %% Click Events - Infrastructure
    click DbContext "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/ApplicationDbContext.cs"
    click Data "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/Data/SqlConnectionFactory.cs"
    click ReposImpl "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/Repositories/AlquilerRepository.cs"
    click ReposImpl "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/Repositories/VehiculoRepository.cs"
    click Configs "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/Configurations/AlquilerConfiguration.cs"
    click ClockImpl "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/Clock/DateTimeProvider.cs"
    click EmailImpl "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/Email/EmailService.cs"
    click InfraDI "https://github.com/zodiaco1999/dotnetcleanarchitecture/blob/main/CleanArchitecture.Infraestructure/DependencyInjection.cs"

    %% Styles
    classDef api fill:#D6E9FF,stroke:#4A90E2,color:#000
    classDef app fill:#E8F5E9,stroke:#43A047,color:#000
    classDef domain fill:#FFF9C4,stroke:#FBC02D,color:#000
    classDef infra fill:#FFE0B2,stroke:#FB8C00,color:#000
    classDef external fill:#F0F0F0,stroke:#888,color:#000
```
