# feriel214/asp.net-core-cleanarchitecture-cqrs-identity architecture

> Architecture diagram of the GitHub repository feriel214/asp.net-core-cleanarchitecture-cqrs-identity, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity
- Repository: https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity

## Overview

##### Project type and purpose
- This is an ASP.NET Core 8.0 Web API implementing Clean Architecture with CQRS (commands/queries via MediatR), Identity for role and user management, JWT authentication/authorization, Entity Framework Core (for migrations & identity tables), and Dapper (for optimized queries).
- Its purpose is to expose endpoints (AuthController, UserController, RoleController) for clients to perform authentication, user, and role operations against a SQL Server database.

##### File structure
- Top-level solution “Authentication.sln” contains four main projects:
- Naxxum.JobyHunter.Authentication.Api: the Web API entry point (Controllers, Program.cs, appsettings.json).
- Naxxum.JobyHunter.Authentication.Application: application‐level logic (CQRS commands & queries, DTOs, dependency injection).
- Naxxum.JobyHunter.Authentication.Domain: domain entities (User, Role via BaseEntity), repository interfaces for commands/queries.
- Naxxum.JobyHunter.Authentication.Infrastructure: concrete implementations (EF Core DbContext, Migrations, Dapper/EF repositories, IdentityService, TokenGenerator).
- There’s also a UnitTests project for testing Application & Domain layers.

##### README for additional insights
- Clean Architecture pattern separates concerns into independent layers.
- CQRS: Commands (write) and Queries (read) classes under Application/Commands and Application/Queries.
- Uses EF Core and Dapper in Infrastructure, AutoMapper for mapping, MediatR for dispatching commands/queries, JWT for token-based security.

##### Detail without over-complicating
- API: Controllers (Auth, User, Role), appsettings.json
- Application: Commands, Queries, DTOs, DependencyInjection.cs
- Domain: Entities, IRepository interfaces
- Infrastructure: ApplicationDbContext & Migrations, CommandRepository, QueryRepository, IdentityService, TokenGenerator
- Data flow for both a write operation (e.g., CreateUserCommand) and a read operation (GetUserQuery) to illustrate CQRS.

## Diagram (Mermaid)

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

    %% API Layer
    subgraph "API Layer"
        direction TB
        apiDir["Naxxum.JobyHunter.Authentication.Api"]:::api
        AuthController["AuthController.cs"]:::api
        UserController["UserController.cs"]:::api
        RoleController["RoleController.cs"]:::api
        ProgramFile["Program.cs"]:::api
        AppSettings["appsettings.json"]:::api
        AppSettingsDev["appsettings.Development.json"]:::api
        HttpCollection["Naxxum.JobyHunter.Authentication.Api.http"]:::api
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        appDir["Naxxum.JobyHunter.Authentication.Application"]:::application
        AppCsproj["Authentication.Application.csproj"]:::application
        CommandsDir["Commands"]:::application
        QueriesDir["Queries"]:::application
        DTOsDir["DTOs"]:::application
        DIApp["DependencyInjection.cs"]:::application
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        domainDir["Naxxum.JobyHunter.Authentication.Domain"]:::domain
        DomainCsproj["Authentication.Domain.csproj"]:::domain
        EntitiesDir["Entities"]:::domain
        ReposDir["Repositories"]:::domain
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        direction TB
        infraDir["Naxxum.JobyHunter.Authentication.Infrastructure"]:::infra
        InfraCsproj["Authentication.Infra.csproj"]:::infra
        DataDir["Data"]:::infra
        MigrationsDir["Migrations"]:::infra
        RepoImplDir["Repository"]:::infra
        IdentityService["IdentityService.cs"]:::infra
        TokenGenerator["TokenGenerator.cs"]:::infra
        DIInfra["DependencyInjection.cs"]:::infra
    end

    %% Database
    database["SQL Server Database"]:::database

    %% Unit Tests
    UnitTests["Authentication.UnitTests"]:::unittest

    %% Connections
    Client -->|"HTTP Request"| apiDir
    apiDir -->|"Calls Mediator via Controllers"| appDir
    appDir -->|"Depends on Interfaces"| domainDir
    domainDir -->|"Implemented by"| infraDir
    infraDir -->|"Reads/Writes"| database

    UnitTests -.->|tests| appDir
    UnitTests -.->|tests| domainDir

    %% Click Events - API
    click apiDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api"
    click AuthController "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/Controllers/AuthController.cs"
    click UserController "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/Controllers/UserController.cs"
    click RoleController "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/Controllers/RoleController.cs"
    click ProgramFile "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/Program.cs"
    click AppSettings "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/appsettings.json"
    click AppSettingsDev "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/appsettings.Development.json"
    click HttpCollection "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Api/Naxxum.JobyHunter.Authentication.Api.http"

    %% Click Events - Application
    click appDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Application"
    click AppCsproj "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Application/Authentication.Application.csproj"
    click CommandsDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Application/Commands"
    click QueriesDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Application/Queries"
    click DTOsDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Application/DTOs"
    click DIApp "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Application/DependencyInjection.cs"

    %% Click Events - Domain
    click domainDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Domain"
    click DomainCsproj "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Domain/Authentication.Domain.csproj"
    click EntitiesDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Domain/Entities"
    click ReposDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Domain/Repositories"

    %% Click Events - Infrastructure
    click infraDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Infrastructure"
    click InfraCsproj "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Infrastructure/Authentication.Infra.csproj"
    click DataDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Infrastructure/Data"
    click MigrationsDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Infrastructure/Migrations"
    click RepoImplDir "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/tree/main/Naxxum.JobyHunter.Authentication.Infrastructure/Repository"
    click IdentityService "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Infrastructure/Services/IdentityService.cs"
    click TokenGenerator "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Infrastructure/Services/TokenGenerator.cs"
    click DIInfra "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.Infrastructure/DependencyInjection.cs"

    %% Click Events - UnitTests
    click UnitTests "https://github.com/feriel214/asp.net-core-cleanarchitecture-cqrs-identity/blob/main/Naxxum.JobyHunter.Authentication.UnitTests"

    %% Styles
    classDef api fill:#D6EAF8,stroke:#2980B9
    classDef application fill:#D5F5E3,stroke:#27AE60
    classDef domain fill:#FCF3CF,stroke:#B7950B
    classDef infra fill:#FADBD8,stroke:#C0392B
    classDef database fill:#EBDEF0,stroke:#7D3C98,stroke-dasharray: 5 5
    classDef client fill:#FDEBD0,stroke:#B9770E
    classDef unittest fill:#E8DAEF,stroke:#6C3483,stroke-dasharray: 2 2
```
