# dilanvlad/libreria.modelos architecture

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

- Interactive diagram: https://gitdiagram.com/dilanvlad/libreria.modelos
- Repository: https://github.com/dilanvlad/libreria.modelos

## Overview

##### Project type and purpose
- This is a monolithic .NET solution consisting of:
- A Web API (Libreria.API) exposing CRUD endpoints for Autores, Editoriales, Libros, Paises.
- A shared domain-model assembly (Libreria.Modelos) containing your entity classes.
- A small console-style API consumer (Librerria.API.Consumer) acting as an HTTP client to test or demonstrate your API.
- Its purpose: manage library data (authors, books, publishers, countries) via RESTful endpoints backed by EF Core and SQL Server.

##### File structure
- Top-level projects:
- Libreria.API – your ASP.NET Core Web API
- Libreria.Modelos – your domain/entity definitions
- Librerria.API.Consumer – a simple client for CRUD calls
- Key directories in Libreria.API:
- Controllers – HTTP endpoints
- Data – AppDbContext & EF Core setup & Migrations
- Properties & appsettings – launch and configuration
- Build & run scripts: Program.cs (Startup), .csproj files define .NET SDK and NuGet dependencies.

##### README
- Minimal content (“# Libreria.Modelos”)—no additional architecture docs. Rely on code structure.

##### Main components and their relationships
A. Consumer Application (Librerria.API.Consumer)
- Technology: .NET console app (Crud.cs using HttpClient)
- Role: issues HTTP requests to your API
B. Web API (Libreria.API) – your presentation layer
- Sub-components:
- Controllers (AutoresController, LibrosController, etc.)
- Program.cs/Startup (middleware pipeline, routing, DI)
- Technology: ASP.NET Core
C. Data Access Layer (within Libreria.API)
- AppDbContext (EF Core) + Migrations
- Handles ORM → Database
D. Database
- SQL Server (connection defined in appsettings.json)
- Persists tables for Autor, Libro, Editorial, Pais
E. Shared Domain Models (Libreria.Modelos)
- Used by both API (for EF mappings) and Consumer (for deserialization, DTOs)

##### Architectural patterns & design principles
- Layered architecture: Presentation (Controllers), Domain (Models), Data Access (DbContext), Infrastructure (Database)
- Separation of concerns: domain entities decoupled in Libreria.Modelos assembly
- EF Core Code-First migrations under Data/Migrations
- Dependency Injection: Controllers depend on DbContext via DI container in Program.cs

##### Detail level
- EF Core migration mechanism as a small sub-component under Data Access.
- Don’t over-split—focus on the 4–5 main pieces and their interactions.

- How your client drives the API
- How controllers dispatch to EF Core
- Where your domain models live
- How data flows to/from your SQL Server

This level of granularity ensures any reader immediately understands your system’s composition and data flows.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Consumer Application" 
        direction TB
        ConsumerProj["Librerria.API.Consumer.csproj"]:::consumer
        Crud["Crud.cs"]:::consumer
    end

    subgraph "Web API (Libreria.API)" 
        direction TB
        Config["Program.cs"]:::api
        Appsettings["appsettings.json"]:::api
        Launch["launchSettings.json"]:::api
        subgraph Controllers
            direction TB
            Autores["AutoresController.cs"]:::api
            Editoriales["EditorialesController.cs"]:::api
            Libros["LibrosController.cs"]:::api
            Paises["PaisesController.cs"]:::api
            Weather["WeatherForecastController.cs"]:::api
        end
        subgraph "Data Access"
            direction TB
            DbContext["AppDbContext.cs"]:::api
            subgraph Migrations
                direction TB
                Mig1["20250423155952_v01-sqlserver.cs"]:::api
                Mig2["20250423155952_v01-sqlserver.Designer.cs"]:::api
                Mig3["AppDbContextModelSnapshot.cs"]:::api
            end
        end
    end

    subgraph "Shared Domain Models" 
        direction TB
        ModelProj["Libreria.Modelos.csproj"]:::models
        AutorEntity["Autor.cs"]:::models
        EditorialEntity["Editorial.cs"]:::models
        LibroEntity["Libro.cs"]:::models
        PaisEntity["Pais.cs"]:::models
    end

    DB[(SQL Server)]:::db

    Crud -->|"HTTP over TCP"| Autores
    ConsumerProj -->|"uses models"| ModelProj
    Config -->|"references models"| ModelProj
    Autores -->|"calls"| DbContext
    Editoriales -->|"calls"| DbContext
    Libros -->|"calls"| DbContext
    Paises -->|"calls"| DbContext
    DbContext -->|"SQL"| DB

    click ConsumerProj "https://github.com/dilanvlad/libreria.modelos/blob/master/Librerria.API.Consumer/Librerria.API.Consumer.csproj"
    click Crud "https://github.com/dilanvlad/libreria.modelos/blob/master/Librerria.API.Consumer/Crud.cs"
    click Config "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Program.cs"
    click Appsettings "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/appsettings.json"
    click Launch "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Properties/launchSettings.json"
    click Autores "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Controllers/AutoresController.cs"
    click Editoriales "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Controllers/EditorialesController.cs"
    click Libros "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Controllers/LibrosController.cs"
    click Paises "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Controllers/PaisesController.cs"
    click Weather "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Controllers/WeatherForecastController.cs"
    click DbContext "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Data/AppDbContext.cs"
    click Mig1 "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Migrations/20250423155952_v01-sqlserver.cs"
    click Mig2 "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Migrations/20250423155952_v01-sqlserver.Designer.cs"
    click Mig3 "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.API/Migrations/AppDbContextModelSnapshot.cs"
    click ModelProj "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.Modelos/Libreria.Modelos.csproj"
    click AutorEntity "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.Modelos/Autor.cs"
    click EditorialEntity "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.Modelos/Editorial.cs"
    click LibroEntity "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.Modelos/Libro.cs"
    click PaisEntity "https://github.com/dilanvlad/libreria.modelos/blob/master/Libreria.Modelos/Pais.cs"

    classDef consumer fill:#ADD8E6,stroke:#000
    classDef api fill:#87CEFA,stroke:#000
    classDef models fill:#90EE90,stroke:#000
    classDef db fill:#FFA500,stroke:#000,stroke-width:2px
```
