# macoratti/cleanarchitecture_api architecture

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

- Interactive diagram: https://gitdiagram.com/macoratti/cleanarchitecture_api
- Repository: https://github.com/macoratti/cleanarchitecture_api

## Overview

This is a small Clean Architecture user-management API, centered on creating users: an HTTP request reaches the API controller, the application handles a create-user request, persists the user, and returns a response. The application also contains validation and mapping components; the domain defines user and repository contracts, while persistence supplies EF Core implementations and SQLite configuration. Source excerpts verify the handler’s repository/commit calls and persistence operations. Controller dispatch and some startup wiring are not shown, so those links are omitted.

Main entry points: [`CleanArchitecture.Persistence/Context/AppDbContext.cs`](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Context/AppDbContext.cs) (EF database context), [`CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs`](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs) (Create handler), [`CleanArchitecture.Persistence/ServiceExtensions.cs`](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/ServiceExtensions.cs) (Persistence registration), [`CleanArchitecture.Domain/Interfaces/IUserRepository.cs`](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IUserRepository.cs) (User repository contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_users_controller["Users controller<br/>[UsersController.cs]"]
end

subgraph group_application["Application"]
  node_create_request["Create request"]
  node_create_handler["Create handler"]
  node_create_mapper["Create mapper"]
  node_create_response["Create response"]
  node_create_validator["Request validator"]
  node_validation_behavior["Validation behavior"]
  node_application_registration["Application registration"]
end

subgraph group_domain["Domain"]
  node_user["User entity<br/>[User.cs]"]
  node_base_entity["Base entity<br/>[BaseEntity.cs]"]
  node_user_repository_contract["User repository contract<br/>[IUserRepository.cs]"]
  node_base_repository_contract["Repository contract<br/>[IBaseRepository.cs]"]
  node_unit_of_work_contract["Unit of work contract<br/>[IUnitOfWork.cs]"]
end

subgraph group_persistence["Persistence"]
  node_user_repository["User repository<br/>[UserRepository.cs]"]
  node_base_repository["Base repository<br/>[BaseRepository.cs]"]
  node_unit_of_work["Unit of work<br/>[UnitOfWork.cs]"]
  node_db_context["EF database context<br/>[AppDbContext.cs]"]
  node_persistence_registration["Persistence registration"]
  node_sqlite_store[("SQLite store<br/>[usersdb.db]")]
end

node_client(("API client"))

node_client -.->|"sends request"| node_users_controller
node_users_controller -->|"uses request"| node_create_request
node_create_handler -->|"handles request"| node_create_request
node_create_handler -->|"creates user"| node_user_repository_contract
node_create_handler -->|"commits changes"| node_unit_of_work_contract
node_create_handler -->|"returns response"| node_create_response
node_create_validator -->|"validates request"| node_create_request
node_application_registration -->|"registers behavior"| node_validation_behavior
node_user -->|"inherits"| node_base_entity
node_user_repository_contract -->|"extends"| node_base_repository_contract
node_user_repository_contract -->|"operates on"| node_user
node_user_repository -->|"inherits"| node_base_repository
node_user_repository -->|"queries users"| node_db_context
node_base_repository -->|"reads and writes"| node_db_context
node_unit_of_work -->|"uses context"| node_db_context
node_db_context -->|"stores users"| node_user
node_persistence_registration -->|"configures context"| node_db_context
node_persistence_registration -->|"registers repository"| node_user_repository
node_persistence_registration -->|"registers unit of work"| node_unit_of_work
node_persistence_registration -->|"configures SQLite"| node_sqlite_store

click node_users_controller "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.WebAPI/Controllers/UsersController.cs"
click node_create_request "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserRequest.cs"
click node_create_handler "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs"
click node_create_mapper "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserMapper.cs"
click node_create_response "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserResponse.cs"
click node_create_validator "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserValidator.cs"
click node_validation_behavior "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/Shared/Behavior/ValidationBehavior.cs"
click node_application_registration "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/Services/ServiceExtensions.cs"
click node_user "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Entities/User.cs"
click node_base_entity "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Common/BaseEntity.cs"
click node_user_repository_contract "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IUserRepository.cs"
click node_base_repository_contract "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IBaseRepository.cs"
click node_unit_of_work_contract "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IUnitOfWork.cs"
click node_user_repository "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Repositories/UserRepository.cs"
click node_base_repository "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Repositories/BaseRepository.cs"
click node_unit_of_work "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Repositories/UnitOfWork.cs"
click node_db_context "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Context/AppDbContext.cs"
click node_persistence_registration "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/ServiceExtensions.cs"
click node_sqlite_store "https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.WebAPI/usersdb.db"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_users_controller,node_client toneBlue
class node_create_request,node_create_handler,node_create_mapper,node_create_response,node_create_validator,node_validation_behavior,node_application_registration toneAmber
class node_user,node_base_entity,node_user_repository_contract,node_base_repository_contract,node_unit_of_work_contract toneMint
class node_user_repository,node_base_repository,node_unit_of_work,node_db_context,node_persistence_registration,node_sqlite_store toneRose
```

## Components

### HTTP API

- [Users controller](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.WebAPI/Controllers/UsersController.cs): `CleanArchitecture.WebAPI/Controllers/UsersController.cs`

### Application

- [Create request](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserRequest.cs): `CleanArchitecture.Application/UseCases/CreateUser/CreateUserRequest.cs`
- [Create handler](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs): `CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs`
- [Create mapper](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserMapper.cs): `CleanArchitecture.Application/UseCases/CreateUser/CreateUserMapper.cs`
- [Create response](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserResponse.cs): `CleanArchitecture.Application/UseCases/CreateUser/CreateUserResponse.cs`
- [Request validator](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/UseCases/CreateUser/CreateUserValidator.cs): `CleanArchitecture.Application/UseCases/CreateUser/CreateUserValidator.cs`
- [Validation behavior](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/Shared/Behavior/ValidationBehavior.cs): `CleanArchitecture.Application/Shared/Behavior/ValidationBehavior.cs`
- [Application registration](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Application/Services/ServiceExtensions.cs): `CleanArchitecture.Application/Services/ServiceExtensions.cs`

### Domain

- [User entity](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Entities/User.cs): `CleanArchitecture.Domain/Entities/User.cs`
- [Base entity](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Common/BaseEntity.cs): `CleanArchitecture.Domain/Common/BaseEntity.cs`
- [User repository contract](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IUserRepository.cs): `CleanArchitecture.Domain/Interfaces/IUserRepository.cs`
- [Repository contract](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IBaseRepository.cs): `CleanArchitecture.Domain/Interfaces/IBaseRepository.cs`
- [Unit of work contract](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Domain/Interfaces/IUnitOfWork.cs): `CleanArchitecture.Domain/Interfaces/IUnitOfWork.cs`

### Persistence

- [User repository](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Repositories/UserRepository.cs): `CleanArchitecture.Persistence/Repositories/UserRepository.cs`
- [Base repository](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Repositories/BaseRepository.cs): `CleanArchitecture.Persistence/Repositories/BaseRepository.cs`
- [Unit of work](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Repositories/UnitOfWork.cs): `CleanArchitecture.Persistence/Repositories/UnitOfWork.cs`
- [EF database context](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/Context/AppDbContext.cs): `CleanArchitecture.Persistence/Context/AppDbContext.cs`
- [Persistence registration](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.Persistence/ServiceExtensions.cs): `CleanArchitecture.Persistence/ServiceExtensions.cs`
- [SQLite store](https://github.com/macoratti/cleanarchitecture_api/blob/master/CleanArchitecture.WebAPI/usersdb.db): `CleanArchitecture.WebAPI/usersdb.db`

### Other components

- **API client**

## Connections

- API client → Users controller: sends request
- Users controller → Create request: uses request (evidence: `CleanArchitecture.WebAPI/Controllers/UsersController.cs`)
- Create handler → Create request: handles request (evidence: `CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs`)
- Create handler → User repository contract: creates user (evidence: `CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs`)
- Create handler → Unit of work contract: commits changes (evidence: `CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs`)
- Create handler → Create response: returns response (evidence: `CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs`)
- Request validator → Create request: validates request (evidence: `CleanArchitecture.Application/UseCases/CreateUser/CreateUserValidator.cs`)
- Application registration → Validation behavior: registers behavior (evidence: `CleanArchitecture.Application/Services/ServiceExtensions.cs`)
- User entity → Base entity: inherits (evidence: `CleanArchitecture.Domain/Entities/User.cs`)
- User repository contract → Repository contract: extends (evidence: `CleanArchitecture.Domain/Interfaces/IUserRepository.cs`)
- User repository contract → User entity: operates on (evidence: `CleanArchitecture.Domain/Interfaces/IUserRepository.cs`)
- User repository → Base repository: inherits (evidence: `CleanArchitecture.Persistence/Repositories/UserRepository.cs`)
- User repository → EF database context: queries users (evidence: `CleanArchitecture.Persistence/Repositories/UserRepository.cs`)
- Base repository → EF database context: reads and writes (evidence: `CleanArchitecture.Persistence/Repositories/BaseRepository.cs`)
- Unit of work → EF database context: uses context (evidence: `CleanArchitecture.Persistence/Repositories/UnitOfWork.cs`)
- EF database context → User entity: stores users (evidence: `CleanArchitecture.Persistence/Context/AppDbContext.cs`)
- Persistence registration → EF database context: configures context (evidence: `CleanArchitecture.Persistence/ServiceExtensions.cs`)
- Persistence registration → User repository: registers repository (evidence: `CleanArchitecture.Persistence/ServiceExtensions.cs`)
- Persistence registration → Unit of work: registers unit of work (evidence: `CleanArchitecture.Persistence/ServiceExtensions.cs`)
- Persistence registration → SQLite store: configures SQLite (evidence: `CleanArchitecture.Persistence/ServiceExtensions.cs`)
