# ibrahimkahramann/dotnet-dietitian architecture

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

- Interactive diagram: https://gitdiagram.com/ibrahimkahramann/dotnet-dietitian
- Repository: https://github.com/ibrahimkahramann/dotnet-dietitian

## Overview

##### Main System Components
a. Client UI (Web/Mobile)
b. API Layer (Dotnet-Dietitian.API)
c. Application Layer (Dotnet-Dietitian.Application)
d. Domain Layer (Dotnet-Dietitian.Domain)
e. Persistence Layer (Dotnet-Dietitian.Persistence)
f. Infrastructure Layer (Dotnet-Dietitian.Infrastructure)
g. External Services & Infrastructure
- Relational Database (EF Core)
- MongoDB (NoSQL)
- Redis (Caching)
- RabbitMQ (Message Bus/ESB)
- SignalR (Real-time Notifications)
- Authentication (JWT Issuer)

##### Relationships & Data Flows
- Client UI → HTTP/HTTPS → API Layer Controllers
- Controllers → (via DI) → Application Layer’s Mediator (Commands & Queries)
- Mediator Handlers → Domain Entities + Services → Persistence Repositories
- Repositories → EF Core DbContext → SQL Database
- Repositories may also connect to MongoDB for document storage
- Caching layer (Redis) is consulted by Services/Repositories for hot data
- Domain events or integration events published → RabbitMQ → other services
- API Layer hosts SignalR Hubs → push notifications to Client UI
- Authentication middleware validates JWT tokens on incoming requests

##### Architectural Patterns & Principles
- Onion Architecture: concentric rings (API → Application → Domain → Infrastructure)
- CQRS & Mediator: separate read/write Models, Commands & Queries handled by Mediator
- SOLID: each layer and class has a single responsibility
- Repository Pattern: Persistence abstractions in Application.Interfaces, implemented in Persistence
- Dependency Injection: ServiceCollectionExtensions wiring all services

##### Technologies & Frameworks
- ASP.NET Core Web API (Controllers, Middleware)
- MediatR or Custom Mediator (in Application.Features.Mediator)
- Entity Framework Core (Dotnet-Dietitian.Persistence)
- MongoDB & Redis (configured in Infrastructure/Services or DI extensions)
- JWT Authentication (Infrastructure/Services/JwtTokenGenerator + Application.Tools)
- SignalR Hubs (in API Layer)
- RabbitMQ Client Libraries (for ESB/integration events)

##### Final Checklist
- JWT Authentication flow: client login → AuthController → JwtTokenGenerator → token returned

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client UI
    subgraph "Client UI"
        UI["Web/Mobile App"]:::ui
    end

    %% API Layer
    subgraph "API Layer" 
        Controllers["Controllers"]:::layer
        Middleware["ExceptionMiddleware"]:::layer
        DIExt["ServiceCollectionExtensions"]:::layer
        Config["appsettings.json"]:::layer
        Program["Program.cs"]:::layer
        SignalRHub["SignalR Hub"]:::layer
    end

    %% Application Layer
    subgraph "Application Layer"
        Commands["CQRS Commands"]:::layer
        Queries["CQRS Queries"]:::layer
        Handlers["CQRS Handlers"]:::layer
        Mediator["Mediator Features"]:::layer
        DTO["TokenResponseDto"]:::layer
        AppInterfaces["Interfaces"]:::layer
        AppServices["Services"]:::layer
        Tools["JwtTokenDefaults"]:::layer
    end

    %% Domain Layer
    subgraph "Domain Layer"
        Entities["Domain Entities"]:::layer
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        DbContext["ApplicationDbContext"]:::layer
        SeedData["SeedData"]:::layer
        Migrations["Migrations"]:::layer
        Repos["Repositories"]:::layer
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        JwtGen["JwtTokenGenerator"]:::layer
    end

    %% External Services & Data Stores
    subgraph "External Services"
        SQLDB["SQL Database"]:::datastore
        MongoDB["MongoDB"]:::datastore
        Redis["Redis Cache"]:::datastore
        RabbitMQ["RabbitMQ"]:::broker
        JWTIssuer["JWT Issuer"]:::datastore
    end

    %% Relationships
    UI -->|HTTP/HTTPS| Controllers
    Controllers -->|uses DI→Mediator| Mediator
    Mediator -->|handles Commands/Queries| Handlers
    Handlers --> Entities
    Handlers --> Repos
    Repos --> DbContext
    DbContext --> SQLDB
    Repos --> MongoDB
    Repos <--> Redis
    Handlers -->|publish events AMQP| RabbitMQ
    Controllers -->|push notifications WS| SignalRHub
    SignalRHub --> UI
    Controllers -->|JWT validation| Middleware
    Controllers -->|generate token| JwtGen
    JwtGen --> JWTIssuer

    %% Click Events
    click Controllers "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.API/Controllers/"
    click Middleware "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.API/Middlewares/ExceptionMiddleware.cs"
    click DIExt "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.API/Extensions/ServiceCollectionExtensions.cs"
    click Config "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.API/appsettings.json"
    click Program "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.API/Program.cs"
    click Commands "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Application/Features/CQRS/Commands/"
    click Queries "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Application/Features/CQRS/Queries/"
    click Handlers "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Application/Features/CQRS/Handlers/"
    click Mediator "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Application/Features/Mediator/"
    click DTO "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.Application/Dtos/TokenResponseDto.cs"
    click AppInterfaces "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Application/Interfaces/"
    click AppServices "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Application/Services/"
    click Tools "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.Application/Tools/JwtTokenDefaults.cs"
    click Entities "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Domain/Entities/"
    click DbContext "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.Persistence/Context/ApplicationDbContext.cs"
    click SeedData "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.Persistence/Data/SeedData.cs"
    click Migrations "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Persistence/Migrations/"
    click Repos "https://github.com/ibrahimkahramann/dotnet-dietitian/tree/main/Dotnet-Dietitian.Persistence/Repositories/"
    click JwtGen "https://github.com/ibrahimkahramann/dotnet-dietitian/blob/main/Dotnet-Dietitian.Infrastructure/Services/JwtTokenGenerator.cs"

    %% Styles
    classDef layer fill:#D0E6FF,stroke:#333,stroke-width:1px
    classDef datastore fill:#C6F6D5,stroke:#333,stroke-width:1px
    classDef broker fill:#FED7AA,stroke:#333,stroke-width:1px
    classDef ui fill:#E2E8F0,stroke:#333,stroke-width:1px
```
