How macoratti/cleanarchitecture_api works
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: AppDbContext.cs EF database context · CreateUserHandler.cs Create handler · ServiceExtensions.cs Persistence registration · IUserRepository.cs User repository contract
Components 20
HTTP API
- Users controller
CleanArchitecture.WebAPI/Controllers/UsersController.cs
Application
- Create request
CleanArchitecture.Application/UseCases/CreateUser/CreateUserRequest.cs - Create handler
CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs - Create mapper
CleanArchitecture.Application/UseCases/CreateUser/CreateUserMapper.cs - Create response
CleanArchitecture.Application/UseCases/CreateUser/CreateUserResponse.cs - Request validator
CleanArchitecture.Application/UseCases/CreateUser/CreateUserValidator.cs - Validation behavior
CleanArchitecture.Application/Shared/Behavior/ValidationBehavior.cs - Application registration
CleanArchitecture.Application/Services/ServiceExtensions.cs
Domain
- User entity
CleanArchitecture.Domain/Entities/User.cs - Base entity
CleanArchitecture.Domain/Common/BaseEntity.cs - User repository contract
CleanArchitecture.Domain/Interfaces/IUserRepository.cs - Repository contract
CleanArchitecture.Domain/Interfaces/IBaseRepository.cs - Unit of work contract
CleanArchitecture.Domain/Interfaces/IUnitOfWork.cs
Persistence
- User repository
CleanArchitecture.Persistence/Repositories/UserRepository.cs - Base repository
CleanArchitecture.Persistence/Repositories/BaseRepository.cs - Unit of work
CleanArchitecture.Persistence/Repositories/UnitOfWork.cs - EF database context
CleanArchitecture.Persistence/Context/AppDbContext.cs - Persistence registration
CleanArchitecture.Persistence/ServiceExtensions.cs - SQLite store
CleanArchitecture.WebAPI/usersdb.db
Other components
- API client
Connections 20
- API client → Users controller: sends request
- Users controller → Create request: uses request
CleanArchitecture.WebAPI/Controllers/UsersController.cs - Create handler → Create request: handles request
CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs - Create handler → User repository contract: creates user
CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs - Create handler → Unit of work contract: commits changes
CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs - Create handler → Create response: returns response
CleanArchitecture.Application/UseCases/CreateUser/CreateUserHandler.cs - Request validator → Create request: validates request
CleanArchitecture.Application/UseCases/CreateUser/CreateUserValidator.cs - Application registration → Validation behavior: registers behavior
CleanArchitecture.Application/Services/ServiceExtensions.cs - User entity → Base entity: inherits
CleanArchitecture.Domain/Entities/User.cs - User repository contract → Repository contract: extends
CleanArchitecture.Domain/Interfaces/IUserRepository.cs - User repository contract → User entity: operates on
CleanArchitecture.Domain/Interfaces/IUserRepository.cs - User repository → Base repository: inherits
CleanArchitecture.Persistence/Repositories/UserRepository.cs - User repository → EF database context: queries users
CleanArchitecture.Persistence/Repositories/UserRepository.cs - Base repository → EF database context: reads and writes
CleanArchitecture.Persistence/Repositories/BaseRepository.cs - Unit of work → EF database context: uses context
CleanArchitecture.Persistence/Repositories/UnitOfWork.cs - EF database context → User entity: stores users
CleanArchitecture.Persistence/Context/AppDbContext.cs - Persistence registration → EF database context: configures context
CleanArchitecture.Persistence/ServiceExtensions.cs - Persistence registration → User repository: registers repository
CleanArchitecture.Persistence/ServiceExtensions.cs - Persistence registration → Unit of work: registers unit of work
CleanArchitecture.Persistence/ServiceExtensions.cs - Persistence registration → SQLite store: configures SQLite
CleanArchitecture.Persistence/ServiceExtensions.cs