# josesepulvedavelez/eureka_back architecture

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

- Interactive diagram: https://gitdiagram.com/josesepulvedavelez/eureka_back
- Repository: https://github.com/josesepulvedavelez/eureka_back

## Overview

##### Project type and purpose
- This is an ASP.NET Core Web API project (“EurekaBack”) designed to manage “Artículos”, “Clientes” and “Facturas” (invoices), backed by a relational database (Tablas.sql).
- It exposes RESTful endpoints via Controllers and uses Entity Framework Core (EurekaContext) for data access.

##### Main components
a. API Host / Container
- Program.cs & Startup (built‑in DI container, Kestrel server)
- appsettings.json (configuration, connection strings)
b. Controllers Layer
- ArticulosController
- ClientesController
- FacturasController
- (WeatherForecastController – sample or health endpoint)
c. DTOs / Mapping Layer
d. Data Access Layer
- EurekaContext (DbContext)
- Models (Articulo, Cliente, Factura, FacturaDetalle)
e. Database
- SQL Server / other RDBMS (tables defined in Tablas.sql)
f. External/Infrastructure
- Logging, Configuration Provider, Migrations (if any)

##### Relationships & Data Flow
- HTTP Request → Kestrel → Controller
- Controller injects EurekaContext via DI → Queries/Updates Models
- Models ↔ Database via EF Core (SQL queries executed)
- Query results mapped to DTOs → Controller → HTTP Response
- Configuration (appsettings.json) feeds connection strings into the DI container at startup

##### Architectural Patterns & Design Principles
- Layered Architecture:
- Presentation/API layer (Controllers)
- Application/Mapping layer (DTOs)
- Data Access layer (DbContext + Models)
- Dependency Injection (built‑in ASP.NET Core)
- Separation of Concerns: controllers do not directly manipulate database schemas—they use EF Core abstractions.
- RESTful routing conventions for resources.

##### Relevant Technologies/Frameworks
- ASP.NET Core Web API (Controllers, Middleware, DI container)
- Entity Framework Core (DbContext, Migrations)
- C# 10 / .NET 6+
- SQL Server (or any provider configured in appsettings.json)
- JSON serialization (System.Text.Json by default)

##### Step‑by‑step Creation
– Top: Controllers (list each Controller)
– Middle: DTOs & Mapping
– Bottom: EF Core / EurekaContext + Models
5. Optionally, show any external logs/monitoring or health-check endpoints.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External client
    External["HTTP Client"]:::external

    %% Backend API Container
    subgraph "Backend API"
        subgraph "API Host"
            Program["Program.cs & Startup"]:::api
            Config["appsettings.json"]:::config
        end

        subgraph "Controllers Layer"
            ArtCtrl["ArticulosController"]:::controller
            CliCtrl["ClientesController"]:::controller
            FacCtrl["FacturasController"]:::controller
            WeatherCtrl["WeatherForecastController"]:::controller
        end

        subgraph "DTOs & Mapping"
            FacDto["FacturaDto"]:::dto
            FacDetDto["FacturaDetalleDto"]:::dto
        end

        subgraph "Data Access Layer"
            Context["EurekaContext (DbContext)"]:::data
            Models["Models (Articulo, Cliente, Factura, FacturaDetalle)"]:::data
        end
    end

    %% Database
    Database[(SQL Database)]:::database

    %% Data Flows
    External -->|"HTTP Request"| ArtCtrl
    External -->|"HTTP Request"| CliCtrl
    External -->|"HTTP Request"| FacCtrl
    External -->|"HTTP Request"| WeatherCtrl

    ArtCtrl -->|"injects EurekaContext"| Context
    CliCtrl -->|"injects EurekaContext"| Context
    FacCtrl -->|"injects EurekaContext"| Context
    WeatherCtrl -->|"injects EurekaContext"| Context

    Context -->|"EF Core query"| Database
    Database -->|"SQL result"| Context
    Context -->|"materializes Models"| Models

    Models -->|"maps to DTOs"| FacDto
    Models -->|"maps to DTOs"| FacDetDto

    FacDto -->|"returns DTOs"| FacCtrl
    FacDetDto -->|"returns DTOs"| FacCtrl

    Config -->|"provides connection string"| Program

    %% Click Events
    click Program "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Program.cs"
    click Config "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/appsettings.json"
    click ArtCtrl "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Controllers/ArticulosController.cs"
    click CliCtrl "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Controllers/ClientesController.cs"
    click FacCtrl "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Controllers/FacturasController.cs"
    click WeatherCtrl "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Controllers/WeatherForecastController.cs"
    click FacDto "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Dto/FacturaDto.cs"
    click FacDetDto "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Dto/FacturaDetalleDto.cs"
    click Context "https://github.com/josesepulvedavelez/eureka_back/blob/main/EurekaBack/EurekaBack/Data/EurekaContext.cs"
    click Models "https://github.com/josesepulvedavelez/eureka_back/tree/main/EurekaBack/EurekaBack/Models"

    %% Styles
    classDef external fill:#CCCCCC,stroke:#333,stroke-width:1px;
    classDef api fill:#B3CDE3,stroke:#333,stroke-width:1px;
    classDef config fill:#FDDC5C,stroke:#333,stroke-width:1px;
    classDef controller fill:#6497B1,stroke:#333,stroke-width:1px;
    classDef dto fill:#005B96,stroke:#fff,stroke-width:1px;
    classDef data fill:#99C24D,stroke:#333,stroke-width:1px;
    classDef database fill:#EE9E45,stroke:#333,stroke-width:1px;
```
