# yofreca/base architecture

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

- Interactive diagram: https://gitdiagram.com/yofreca/base
- Repository: https://github.com/yofreca/base

## Overview

##### Project Type & Purpose
- This is a backend‐only RESTful API built with ASP.NET Core 3.1, organized according to Clean Architecture.
- Its purpose is to expose user‐ and token‐related endpoints, encapsulate business logic in a “Core” layer, handle persistence via Entity Framework Core in an “Infrastructure” layer, and support JWT authentication, validation, paging, and automapping.

##### File Structure
- Top-level layers:
– Api/ (presentation): Controllers, Program.cs, Startup.cs, appsettings.json, API responses.
– Core/ (domain & application): Entities, DTOs, QueryFilters, Interfaces (IServices & IRepositories), Services (implementation), CustomEntities (pagination), Exceptions.
– Infrastruture/ (persistence & cross-cutting): EF Core DbContext & Configurations, Repositories, Automapper mappings, FluentValidation validators, global filters.
– Base.UnitTest/ (test project): Unit tests for Core services or controllers.
- Build scripts & solution: Base.sln ties all projects; each layer is its own csproj.
- Dependencies: EF Core (SQL Server + Tools), AutoMapper, FluentValidation, JWT Bearer, Newtonsoft.Json.

##### README for Insights
- Confirms Clean Architecture and required NuGet dependencies.

##### Detail
– Capture all critical components: controllers, services, repositories, DbContext, filters, validators, mappings.
– Show how exceptions bubble up via GlobalExceptionFilter.
– Indicate paging/filtering flow through CustomEntities and QueryFilters.

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Client
    Client["External Client"]:::external

    %% API Layer
    subgraph "API Layer"
        DefaultController["DefaultController"]:::api
        UserController["UserController"]:::api
        TokenController["TokenController"]:::api
        ApiResponse["ApiResponse"]:::api
        Program["Program.cs"]:::api
        Startup["Startup.cs"]:::api
        AppSettings["appsettings.json"]:::api
        DevSettings["appsettings.Development.json"]:::api
    end

    %% Core Layer
    subgraph "Core Layer"
        Entities["Entities"]:::core
        UserDto["UserDto"]:::core
        UserLoginDto["UserLoginDto"]:::core
        QueryFilters["UserQueryFilter"]:::core
        CustomEntities["CustomEntities"]:::core
        Interfaces["Interfaces"]:::core
        UserService["UserService"]:::core
        LoginService["LoginService"]:::core
        BusinessException["BusinessException"]:::core
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        Context["BaseContext"]:::infra
        Configs["EntityTypeConfigurations"]:::infra
        UserRepository["UserRepository"]:::infra
        LoginRepository["LoginRepository"]:::infra
        AutomapperProfile["AutomapperProfile"]:::infra
        UserValidator["UserValidator"]:::infra
        GlobalExceptionFilter["GlobalExceptionFilter"]:::infra
    end

    %% External Systems
    subgraph "External Systems"
        DB["SQL Server Database"]:::external
        Auth["JWT Auth Middleware"]:::external
    end

    %% Data Flows & Dependencies
    Client -->|HTTP Request| DefaultController
    Client -->|HTTP Request| UserController
    Client -->|HTTP Request| TokenController

    Startup -->|configures| Auth
    Auth -->|authenticates| DefaultController
    Auth -->|authenticates| UserController
    Auth -->|authenticates| TokenController

    DefaultController -->|"uses"| UserService
    DefaultController -->|"uses"| LoginService
    UserController -->|"uses"| UserService
    TokenController -->|"uses"| LoginService

    DefaultController -->|"wraps"| ApiResponse
    UserController -->|"wraps"| ApiResponse
    TokenController -->|"wraps"| ApiResponse

    UserService -->|"depends on"| Interfaces
    LoginService -->|"depends on"| Interfaces

    Interfaces -->|"implemented by"| UserRepository
    Interfaces -->|"implemented by"| LoginRepository

    UserRepository -->|uses| Context
    LoginRepository -->|uses| Context
    Context -->|connects to| DB

    DefaultController -->|validates| UserValidator
    DefaultController -->|maps| AutomapperProfile
    UserController -->|validates| UserValidator
    UserController -->|maps| AutomapperProfile

    GlobalExceptionFilter -->|catches exceptions from| DefaultController
    GlobalExceptionFilter -->|catches exceptions from| UserController
    GlobalExceptionFilter -->|catches exceptions from| TokenController

    %% Core Entities & Helpers
    Entities -->|defines| UserDto
    Entities -->|defines| UserLoginDto
    QueryFilters -->|used by| UserService
    CustomEntities -->|used by| UserService
    BusinessException -->|thrown by| UserService
    BusinessException -->|thrown by| LoginService

    %% Click Events
    click DefaultController "https://github.com/yofreca/base/blob/master/Api/Controllers/DefaultController.cs"
    click UserController "https://github.com/yofreca/base/blob/master/Api/Controllers/UserController.cs"
    click TokenController "https://github.com/yofreca/base/blob/master/Api/Controllers/TokenController.cs"
    click ApiResponse "https://github.com/yofreca/base/blob/master/Api/Responses/ApiResponse.cs"
    click Program "https://github.com/yofreca/base/blob/master/Api/Program.cs"
    click Startup "https://github.com/yofreca/base/blob/master/Api/Startup.cs"
    click AppSettings "https://github.com/yofreca/base/blob/master/Api/appsettings.json"
    click DevSettings "https://github.com/yofreca/base/blob/master/Api/appsettings.Development.json"

    click Entities "https://github.com/yofreca/base/tree/master/Core/Entities"
    click UserDto "https://github.com/yofreca/base/blob/master/Core/DTOs/UserDto.cs"
    click UserLoginDto "https://github.com/yofreca/base/blob/master/Core/DTOs/UserLoginDto.cs"
    click QueryFilters "https://github.com/yofreca/base/blob/master/Core/QueryFilters/UserQueryFilter.cs"
    click CustomEntities "https://github.com/yofreca/base/tree/master/Core/CustomEntities"
    click Interfaces "https://github.com/yofreca/base/tree/master/Core/Interfaces"
    click UserService "https://github.com/yofreca/base/blob/master/Core/Services/UserService.cs"
    click LoginService "https://github.com/yofreca/base/blob/master/Core/Services/LoginService.cs"
    click BusinessException "https://github.com/yofreca/base/blob/master/Core/Exceptions/BusinessException.cs"

    click Context "https://github.com/yofreca/base/blob/master/Infrastruture/Data/BaseContext.cs"
    click Configs "https://github.com/yofreca/base/tree/master/Infrastruture/Data/Configurations"
    click UserRepository "https://github.com/yofreca/base/blob/master/Infrastruture/Repositories/UserRepository.cs"
    click LoginRepository "https://github.com/yofreca/base/blob/master/Infrastruture/Repositories/LoginRepository.cs"
    click AutomapperProfile "https://github.com/yofreca/base/blob/master/Infrastruture/Mappings/AutomapperProfile.cs"
    click UserValidator "https://github.com/yofreca/base/blob/master/Infrastruture/Validators/UserValidator.cs"
    click GlobalExceptionFilter "https://github.com/yofreca/base/blob/master/Infrastruture/Filters/GlobalExceptionFilter.cs"

    %% Styles
    classDef api fill:#cce5ff,stroke:#004085,color:#004085;
    classDef core fill:#d4edda,stroke:#155724,color:#155724;
    classDef infra fill:#fff3cd,stroke:#856404,color:#856404;
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
```
