# aimenux/swaggergenerationdemo architecture

> Architecture diagram of the GitHub repository aimenux/swaggergenerationdemo, 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/aimenux/swaggergenerationdemo
- Repository: https://github.com/aimenux/swaggergenerationdemo

## Overview

SwaggerGenerationDemo compares two ASP.NET Core Todo APIs: a controller-based API and a minimal-API variant. In each, an HTTP request reaches its presentation handler, which calls the application service; the service asks a repository abstraction for generated Todo data and returns it for the response. Both variants also demonstrate API versioning and Swagger/OpenAPI support. The README additionally describes build-time OpenAPI generation. Edges reflect shown calls or README claims; some startup wiring and build-time implementation details are not sampled.

Main entry points: [`README.md`](https://github.com/aimenux/swaggergenerationdemo/blob/main/README.md) (Build-time OpenAPI), [`src/ControllerApi/Presentation/Controllers/TodosController.cs`](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Controllers/TodosController.cs) (Todo controller), [`src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs`](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs) (Todo endpoints), [`src/ControllerApi/Presentation/Program.cs`](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Program.cs) (Controller host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controller["Controller API"]
  node_c_program["Controller host<br/>[Program.cs]"]
  node_c_routes["Todo controller<br/>[TodosController.cs]"]
  node_c_service["Todo service<br/>[TodoService.cs]"]
  node_c_contract["Repository contract<br/>[ITodoRepository.cs]"]
  node_c_repo["Sample data repository<br/>[TodoRepository.cs]"]
  node_c_model["Todo model<br/>[Todo.cs]"]
  node_c_swagger["Swagger support"]
  node_c_version["API versioning"]
end

subgraph group_minimal["Minimal API"]
  node_m_program["Minimal host<br/>[Program.cs]"]
  node_m_routes["Todo endpoints<br/>[TodosEndpoints.cs]"]
  node_m_service["Todo service<br/>[TodoService.cs]"]
  node_m_contract["Repository contract<br/>[ITodoRepository.cs]"]
  node_m_repo["Sample data repository<br/>[TodoRepository.cs]"]
  node_m_model["Todo model<br/>[Todo.cs]"]
  node_m_swagger["Swagger support"]
  node_m_version["API versioning"]
end

subgraph group_openapi["OpenAPI generation"]
  node_oas["Build-time OpenAPI<br/>[README.md]"]
end

node_caller(("API client"))

node_caller -->|"HTTP request"| node_c_routes
node_c_routes -->|"calls service"| node_c_service
node_c_service -->|"calls repository"| node_c_contract
node_c_repo -->|"implements"| node_c_contract
node_c_program -.->|"hosts API"| node_c_routes
node_c_swagger -.->|"supports generation"| node_oas
node_caller -->|"HTTP request"| node_m_routes
node_m_routes -->|"calls service"| node_m_service
node_m_service -->|"calls repository"| node_m_contract
node_m_repo -->|"implements"| node_m_contract
node_m_program -.->|"hosts API"| node_m_routes
node_m_swagger -.->|"supports generation"| node_oas
node_oas -->|"build-time generation"| node_c_program
node_oas -->|"build-time generation"| node_m_program

click node_c_program "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Program.cs"
click node_c_routes "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Controllers/TodosController.cs"
click node_c_service "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Application/Services/TodoService.cs"
click node_c_contract "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Application/Abstractions/ITodoRepository.cs"
click node_c_repo "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Infrastructure/Repositories/TodoRepository.cs"
click node_c_model "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Domain/Models/Todo.cs"
click node_c_swagger "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Extensions/SwaggerExtensions.cs"
click node_c_version "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Extensions/VersioningExtensions.cs"
click node_m_program "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Program.cs"
click node_m_routes "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs"
click node_m_service "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Application/Services/TodoService.cs"
click node_m_contract "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Application/Abstractions/ITodoRepository.cs"
click node_m_repo "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Infrastructure/Repositories/TodoRepository.cs"
click node_m_model "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Domain/Models/Todo.cs"
click node_m_swagger "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Extensions/SwaggerExtensions.cs"
click node_m_version "https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Extensions/VersioningExtensions.cs"
click node_oas "https://github.com/aimenux/swaggergenerationdemo/blob/main/README.md"

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_c_program,node_c_routes,node_c_service,node_c_contract,node_c_repo,node_c_model,node_c_swagger,node_c_version,node_caller toneBlue
class node_m_program,node_m_routes,node_m_service,node_m_contract,node_m_repo,node_m_model,node_m_swagger,node_m_version toneAmber
class node_oas toneMint
```

## Components

### Controller API

- [Controller host](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Program.cs): `src/ControllerApi/Presentation/Program.cs`
- [Todo controller](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Controllers/TodosController.cs): `src/ControllerApi/Presentation/Controllers/TodosController.cs`
- [Todo service](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Application/Services/TodoService.cs): `src/ControllerApi/Application/Services/TodoService.cs`
- [Repository contract](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Application/Abstractions/ITodoRepository.cs): `src/ControllerApi/Application/Abstractions/ITodoRepository.cs`
- [Sample data repository](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Infrastructure/Repositories/TodoRepository.cs): `src/ControllerApi/Infrastructure/Repositories/TodoRepository.cs`
- [Todo model](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Domain/Models/Todo.cs): `src/ControllerApi/Domain/Models/Todo.cs`
- [Swagger support](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Extensions/SwaggerExtensions.cs): `src/ControllerApi/Presentation/Extensions/SwaggerExtensions.cs`
- [API versioning](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/ControllerApi/Presentation/Extensions/VersioningExtensions.cs): `src/ControllerApi/Presentation/Extensions/VersioningExtensions.cs`

### Minimal API

- [Minimal host](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Program.cs): `src/MinimalApi/Presentation/Program.cs`
- [Todo endpoints](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs): `src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs`
- [Todo service](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Application/Services/TodoService.cs): `src/MinimalApi/Application/Services/TodoService.cs`
- [Repository contract](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Application/Abstractions/ITodoRepository.cs): `src/MinimalApi/Application/Abstractions/ITodoRepository.cs`
- [Sample data repository](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Infrastructure/Repositories/TodoRepository.cs): `src/MinimalApi/Infrastructure/Repositories/TodoRepository.cs`
- [Todo model](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Domain/Models/Todo.cs): `src/MinimalApi/Domain/Models/Todo.cs`
- [Swagger support](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Extensions/SwaggerExtensions.cs): `src/MinimalApi/Presentation/Extensions/SwaggerExtensions.cs`
- [API versioning](https://github.com/aimenux/swaggergenerationdemo/blob/main/src/MinimalApi/Presentation/Extensions/VersioningExtensions.cs): `src/MinimalApi/Presentation/Extensions/VersioningExtensions.cs`

### OpenAPI generation

- [Build-time OpenAPI](https://github.com/aimenux/swaggergenerationdemo/blob/main/README.md): `README.md`

### Other components

- **API client**

## Connections

- API client → Todo controller: HTTP request (evidence: `src/ControllerApi/Presentation/Controllers/TodosController.cs`)
- Todo controller → Todo service: calls service (evidence: `src/ControllerApi/Presentation/Controllers/TodosController.cs`)
- Todo service → Repository contract: calls repository (evidence: `src/ControllerApi/Application/Services/TodoService.cs`)
- Sample data repository → Repository contract: implements (evidence: `src/ControllerApi/Infrastructure/Repositories/TodoRepository.cs`)
- Controller host → Todo controller: hosts API
- Swagger support → Build-time OpenAPI: supports generation
- API client → Todo endpoints: HTTP request (evidence: `src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs`)
- Todo endpoints → Todo service: calls service (evidence: `src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs`)
- Todo service → Repository contract: calls repository (evidence: `src/MinimalApi/Application/Services/TodoService.cs`)
- Sample data repository → Repository contract: implements (evidence: `src/MinimalApi/Infrastructure/Repositories/TodoRepository.cs`)
- Minimal host → Todo endpoints: hosts API
- Swagger support → Build-time OpenAPI: supports generation
- Build-time OpenAPI → Controller host: build-time generation (evidence: `README.md`)
- Build-time OpenAPI → Minimal host: build-time generation (evidence: `README.md`)
