# picolo21/iwantapp architecture

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

- Interactive diagram: https://gitdiagram.com/picolo21/iwantapp
- Repository: https://github.com/picolo21/iwantapp

## Overview

##### Project type and purpose
- This is a .NET 7+ minimal‐API service (C#) focused on managing “Categories” and “Products.”
- It follows a Clean/Onion Architecture style, separating Domain, Endpoints (presentation), and Infrastructure (data access).

##### File structure to define components
Top-level folders and roles:
- Domain: business entities & logic (Category.cs, Product.cs, Entity.cs)
- Endpoints: Minimal API endpoint definitions (CategoryGetAll, CategoryPost, etc.)
- Infra/Data: EF Core DbContext (ApplicationDbContext) & Migrations
- Program.cs + appsettings*.json: application bootstrap & configuration

##### Main architectural components
a. Client(s) (e.g., browser SPA, mobile app, Postman)
b. API Host (ASP.NET Core minimal API)
– Program.cs
– Endpoints/Categories/*.cs
c. Domain Layer
– Domain/Products: Category, Product, Entity base types
d. Infrastructure Layer
– Infra/Data/ApplicationDbContext
– Migrations (schema management)
e. Database
– Relational store (SQL Server or configured provider)

Optional external services (none in current code) can be added later.

##### Relationships and interactions
- Clients issue HTTP calls (GET, POST, PUT, DELETE) to the API Host.
- Program.cs wires each endpoint to its handler (e.g., CategoryGetAll → uses ApplicationDbContext).
- Endpoint handlers map CategoryRequest ↔ CategoryResponse via Domain entities.
- Handlers call ApplicationDbContext (EF Core) to read/write Category/Product tables.
- Migrations ensure the database schema matches the Domain model.

##### Architectural patterns & design principles
- Onion / Clean Architecture:
– Outermost: Endpoints (presentation)
– Middle: Domain entities (business logic, no external dependencies)
– Outermost infra adapter: EF Core DbContext, migrations
- Single‐responsibility endpoints (one file per CRUD).
- Minimal API style: functional endpoint definitions, no MVC controllers class overhead.
- Configuration via appsettings.json and launchSettings.json.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    subgraph "Clients"
        Client["Browser / Mobile / Postman"]
    end

    %% Presentation Layer
    subgraph "API Host (Minimal API)"
        direction TB
        Program["Program.cs"]:::presentation
        CatGetAll["CategoryGetAll.cs"]:::presentation
        CatPost["CategoryPost.cs"]:::presentation
        CatPut["CategoryPut.cs"]:::presentation
        CatDelete["CategoryDelete.cs"]:::presentation
        CatReq["CategoryRequest.cs"]:::presentation
        CatRes["CategoryResponse.cs"]:::presentation
        ProblemExt["ProblemDetailsExtensions.cs"]:::presentation
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        Entity["Entity.cs"]:::domain
        CategoryEntity["Category.cs"]:::domain
        ProductEntity["Product.cs"]:::domain
    end

    %% Infrastructure Layer
    subgraph "Infra/Data"
        direction TB
        DbContext["ApplicationDbContext.cs"]:::infra
        subgraph "Migrations"
            M1["20230828174200_AddCategoryAndProduct.cs"]:::infra
            M1D["20230828174200_AddCategoryAndProduct.Designer.cs"]:::infra
            Snapshot["ApplicationDbContextModelSnapshot.cs"]:::infra
        end
    end

    %% Configuration
    subgraph "Configuration"
        AppSettings["appsettings.json"]:::config
        AppSettingsDev["appsettings.Development.json"]:::config
        LaunchSettings["launchSettings.json"]:::config
    end

    %% Database
    Database["Relational Database"]:::database

    %% Flows
    Client -->|"HTTP Requests"| Program
    Program -->|"maps endpoints"| CatGetAll
    Program --> CatPost
    Program --> CatPut
    Program --> CatDelete
    Program --> ProblemExt
    CatGetAll -->|uses| Entity
    CatGetAll -->|uses| CategoryEntity
    CatGetAll -->|calls| DbContext
    CatPost --> Entity
    CatPost --> CategoryEntity
    CatPost --> DbContext
    CatPut --> Entity
    CatPut --> CategoryEntity
    CatPut --> DbContext
    CatDelete --> DbContext
    DbContext -->|applies migrations| M1
    DbContext --> Snapshot
    DbContext -->|queries| Database
    Database -->|results| DbContext
    DbContext -->|returns entities| CatGetAll
    CatGetAll -->|responds| Client
    Program --> AppSettings
    Program --> AppSettingsDev
    Program --> LaunchSettings

    %% Legend
    subgraph "Legend"
        direction TB
        A["Presentation Layer"]:::presentation
        B["Domain Layer"]:::domain
        C["Infrastructure"]:::infra
        D["Database"]:::database
        E["Configuration"]:::config
    end

    %% Click Events
    click Program "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Program.cs"
    click CatGetAll "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/Categories/CategoryGetAll.cs"
    click CatPost "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/Categories/CategoryPost.cs"
    click CatPut "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/Categories/CategoryPut.cs"
    click CatDelete "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/Categories/CategoryDelete.cs"
    click CatReq "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/Categories/CategoryRequest.cs"
    click CatRes "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/Categories/CategoryResponse.cs"
    click ProblemExt "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Endpoints/ProblemDetailsExtensions.cs"
    click Entity "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Domain/Products/Entity.cs"
    click CategoryEntity "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Domain/Products/Category.cs"
    click ProductEntity "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Domain/Products/Product.cs"
    click DbContext "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Infra/Data/ApplicationDbContext.cs"
    click M1 "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Migrations/20230828174200_AddCategoryAndProduct.cs"
    click M1D "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Migrations/20230828174200_AddCategoryAndProduct.Designer.cs"
    click Snapshot "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Migrations/ApplicationDbContextModelSnapshot.cs"
    click AppSettings "https://github.com/picolo21/iwantapp/blob/main/IWantApp/appsettings.json"
    click AppSettingsDev "https://github.com/picolo21/iwantapp/blob/main/IWantApp/appsettings.Development.json"
    click LaunchSettings "https://github.com/picolo21/iwantapp/blob/main/IWantApp/Properties/launchSettings.json"

    %% Styles
    classDef presentation fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef domain fill:#E0FFE0,stroke:#2E8B57,color:#2E8B57;
    classDef infra fill:#FFE5B4,stroke:#FF8C00,color:#FF8C00;
    classDef config fill:#F3E5F5,stroke:#8E24AA,color:#8E24AA;
    classDef database fill:#E0E0E0,stroke:#606060,color:#606060,stroke-dasharray: 5 5;
```
