# georgesan97/deberadaptadoresinterfaz architecture

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

- Interactive diagram: https://gitdiagram.com/georgesan97/deberadaptadoresinterfaz
- Repository: https://github.com/georgesan97/deberadaptadoresinterfaz

## Overview

##### Project type and purpose
- This is a full-stack, layered ASP.NET Core Web API solution implementing a Clean (Onion/Hexagonal) architecture around a Northwind “Sales” domain.
- Its purpose is to support a “Create Order” use case (and potentially others) via a Web API, with EF Core–backed persistence, DI containers per layer, and DTOs for data exchange.

##### File structure
- Top-level layers (each a separate project):
- NorthWind.Sales.Backend.BusinessObjects – the Domain/Entities, Aggregates, Value Objects, Enums, and Port interfaces (Input/Output Ports).
- NorthWind.Sales.Backend.UseCases – the Interactors implementing Input Ports, coordinating domain logic.
- NorthWind.Sales.Backend.Repositories – Infrastructure layer: repository implementations.
- NorthWind.Sales.Backend.DataContexts.EFCore – EF Core DbContext, configurations, migrations.
- NorthWind.Sales.Backend.Controllers (in Northwind.Sales.WebApi) – ASP-NET API controllers exposing endpoints.
- NorthWind.Sales.FrontEnd.WebApiGateways – client-side gateway for calling the API.
- IoC projects – per-layer containers for registering dependencies.
- NorthWind.Sales.Entities – shared DTOs and Value Objects for communication across layers or to clients.
- You also have sample ADO.NET, Dapper, Minimal API sample projects under WebApplication_API_* but the core system is the NorthWind.Sales solution.

##### README
- The README is generic and doesn’t describe architecture. All architectural clues come from the file/namespace organization.

##### Detailed capture of architectural elements
- Ports (ICreateOrderInputPort, ICreateOrderOutputPort, ICommandsRepository, IUnitOfWork)
- Adapters: EF Core Context, CommandsRepository, CreateOrderPresenter, WebApi Gateway
- Shared Kernel: NorthWind.Sales.Entities (DTOs) used at the boundary

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Front-end Gateway Layer
    subgraph "FrontEnd WebApi Gateway"
        direction TB
        Gateway["CreateOrderGateway"]:::gateway
        FEDI["DependencyContainer"]:::infra
    end

    %% Web API Host
    subgraph "Web API Host"
        direction TB
        Program["Program.cs"]:::apiHost
        Startup["Startup.cs"]:::apiHost
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        Controller["CreateOrderController"]:::api
    end

    %% Application/Use Case Layer
    subgraph "Use Case Layer"
        direction TB
        UCDI["DependencyContainer"]:::infra
        Interactor["CreateOrderInteractor"]:::usecase
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        IInput["ICreateOrderInputPort"]:::port
        IOutput["ICreateOrderOutputPort"]:::port
        CommandsPort["ICommandsRepository"]:::port
        UowPort["IUnitOfWork"]:::port
        OrderAgg["OrderAggregate"]:::domain
        OrderDetailVO["OrderDetail"]:::domain
        OrderEntity["Order"]:::domain
        Enums["DiscountType & ShippingType"]:::domain
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        direction TB
        PDI["DependencyContainer"]:::infra
        Presenter["CreateOrderPresenter"]:::presenter
        RDI["DependencyContainer"]:::infra
        Repository["CommandsRepository"]:::repo
        EF_DI["DependencyContainer"]:::infra
        DbContext["NorthWindSalesContext"]:::db
        Configs["OrderConfiguration<br/>OrderDetailConfiguration"]:::db
        DataService["NorthWindSalesCommandsDataContext"]:::db
    end

    %% Data Store
    DB["SQL Server"]:::dbServer

    %% Connections
    Gateway -->|HTTP call| Program
    Program --> Startup
    Startup --> Controller
    Controller -->|calls ICreateOrderInputPort| IInput
    IInput --> Interactor
    Interactor --> OrderAgg
    Interactor --> OrderDetailVO
    Interactor --> OrderEntity
    Interactor --> Enums
    Interactor -->|calls ICommandsRepository| CommandsPort
    CommandsPort --> Repository
    Repository --> DbContext
    DbContext --> Configs
    Repository --> DataService
    Repository --> DB
    Interactor -->|outputs to| IOutput
    IOutput --> Presenter
    Presenter --> Controller
    Controller -->|HTTP response| Gateway

    %% Click Events
    click Gateway "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.FrontEnd.WebApiGateways/CreateOrderGateway.cs"
    click FEDI "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.FrontEnd.WebApiGateways/DependencyContainer.cs"
    click Program "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/Northwind.Sales.WebApi/Program.cs"
    click Startup "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/Northwind.Sales.WebApi/Startup.cs"
    click Controller "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.Controllers/CreateOrder/CreateOrderController.cs"
    click UCDI "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.UseCases/DependencyContainer.cs"
    click Interactor "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.UseCases/CreateOrder/CreateOrderInteractor.cs"
    click OrderAgg "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Aggregates/OrderAggregate.cs"
    click OrderDetailVO "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/ValueObjects/OrderDetail.cs"
    click OrderEntity "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/POCOEntities/Order.cs"
    click Enums "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Enums/DiscountType.cs"
    click Enums "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Enums/ShippingType.cs"
    click IInput "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Interfaces/CreateOrder/ICreateOrderInputPort.cs"
    click IOutput "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Interfaces/CreateOrder/ICreateOrderOutputPort.cs"
    click CommandsPort "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Interfaces/Repositories/ICommandsRepository.cs"
    click UowPort "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.BusinessObjects/Interfaces/Common/IUnitOfWork.cs"
    click PDI "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.Presenters/DependencyContainer.cs"
    click Presenter "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.Presenters/CreateOrder/CreateOrderPresenter.cs"
    click RDI "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.Repositories/DependencyContainer.cs"
    click Repository "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.Repositories/Repositories/CommandsRepository.cs"
    click EF_DI "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.DataContexts.EFCore/DependencyContainer.cs"
    click DbContext "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.DataContexts.EFCore/DataContexts/NorthWindSalesContext.cs"
    click Configs "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.DataContexts.EFCore/Configurations/OrderConfiguration.cs"
    click Configs "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.DataContexts.EFCore/Configurations/OrderDetailConfiguration.cs"
    click DataService "https://github.com/georgesan97/deberadaptadoresinterfaz/blob/master/NorthWind.Sales.Backend.DataContexts.EFCore/Services/NorthWindSalesCommandsDataContext.cs"

    %% Styles
    classDef gateway fill:#D6EAF8,stroke:#31708E,color:#0B5345;
    classDef apiHost fill:#AED6F1,stroke:#1B4F72,color:#154360;
    classDef api fill:#85C1E9,stroke:#1A5276,color:#1B2631;
    classDef usecase fill:#A9DFBF,stroke:#196F3D,color:#145A32;
    classDef domain fill:#F9E79F,stroke:#B9770E,color:#7E5109;
    classDef infra fill:#D5DBDB,stroke:#626567,color:#17202A;
    classDef presenter fill:#F5B7B1,stroke:#C0392B,color:#641E16;
    classDef repo fill:#D7BDE2,stroke:#7D3C98,color:#4A235A;
    classDef db fill:#FADBD8,stroke:#922B21,color:#641E16;
    classDef dbServer fill:#FDEBD0,stroke:#B9770E,color:#7D6608;
    classDef port fill:#FCF3CF,stroke:#B7950B,color:#7D6608;
```
