How aimenux/swaggergenerationdemo works
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 Build-time OpenAPI · TodosController.cs Todo controller · TodosEndpoints.cs Todo endpoints · Program.cs Controller host
Components 18
Controller API
- Controller host
src/ControllerApi/Presentation/Program.cs - Todo controller
src/ControllerApi/Presentation/Controllers/TodosController.cs - Todo service
src/ControllerApi/Application/Services/TodoService.cs - Repository contract
src/ControllerApi/Application/Abstractions/ITodoRepository.cs - Sample data repository
src/ControllerApi/Infrastructure/Repositories/TodoRepository.cs - Todo model
src/ControllerApi/Domain/Models/Todo.cs - Swagger support
src/ControllerApi/Presentation/Extensions/SwaggerExtensions.cs - API versioning
src/ControllerApi/Presentation/Extensions/VersioningExtensions.cs
Minimal API
- Minimal host
src/MinimalApi/Presentation/Program.cs - Todo endpoints
src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs - Todo service
src/MinimalApi/Application/Services/TodoService.cs - Repository contract
src/MinimalApi/Application/Abstractions/ITodoRepository.cs - Sample data repository
src/MinimalApi/Infrastructure/Repositories/TodoRepository.cs - Todo model
src/MinimalApi/Domain/Models/Todo.cs - Swagger support
src/MinimalApi/Presentation/Extensions/SwaggerExtensions.cs - API versioning
src/MinimalApi/Presentation/Extensions/VersioningExtensions.cs
OpenAPI generation
- Build-time OpenAPI
README.md
Other components
- API client
Connections 14
- API client → Todo controller: HTTP request
src/ControllerApi/Presentation/Controllers/TodosController.cs - Todo controller → Todo service: calls service
src/ControllerApi/Presentation/Controllers/TodosController.cs - Todo service → Repository contract: calls repository
src/ControllerApi/Application/Services/TodoService.cs - Sample data repository → Repository contract: implements
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
src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs - Todo endpoints → Todo service: calls service
src/MinimalApi/Presentation/Endpoints/TodosEndpoints.cs - Todo service → Repository contract: calls repository
src/MinimalApi/Application/Services/TodoService.cs - Sample data repository → Repository contract: implements
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
README.md - Build-time OpenAPI → Minimal host: build-time generation
README.md