Project structure
Directorysrc/
DirectoryApplication/ the domain and the rules
DirectoryAuthors/ queries and entities for authors
- …
DirectoryMovies/ queries and entities for movies
- …
DirectoryReviews/ queries, commands and entities for reviews
- …
DirectoryVersions/ the version query
- …
DirectoryCommon/
DirectoryBehaviours/ the logging and validation pipeline behaviours
- …
DirectoryEnums/ the entity types NotFoundException names
- …
DirectoryExceptions/ NotFoundException
- …
DirectoryPaging/ shared paging rules
- …
DirectoryTelemetry/ the activity source for the use case spans
- …
- DependencyInjection.cs
DirectoryInfrastructure/ the data
DirectoryDatabases/MovieReviews/ the EF Core context, models, mapping, migrations and repositories
- …
- DependencyInjection.cs
DirectoryPresentation/ the Web API
DirectoryControllers/
DirectoryCommon/ ApiControllerBase, which every controller inherits
- …
- Authors/, Movies/, Reviews/, Version/ one controller per feature, with the review request bodies
DirectoryErrors/ ApplicationExceptionHandler, Application exceptions to Problem Details
- …
DirectoryOpenApi/ document and security transformers
- …
DirectoryAuthentication/ the JWT bearer settings, only with
--include-auth- …
DirectoryTelemetry/ the OpenTelemetry settings
- …
DirectoryExtensions/ builder and app configuration
- …
- Program.cs
- appsettings.json, appsettings.local.json, appsettings.docker.json
Directorytests/
DirectoryApplication.Tests.Unit/
- …
DirectoryInfrastructure.Tests.Integration/
- …
DirectoryPresentation.Tests.Integration/
- …
DirectoryPresentation.Tests.Unit/
- …
Directory.agents/ Jacques and the skills your coding agent reads
- …
- .github/workflows/ci.yml formats, builds and tests with the 95% coverage bar
- docs/RUN.md
- README.md
- AGENTS.md the map for coding agents
- CLAUDE.md points Claude Code at AGENTS.md
- WorksOnMyMachine.Movies.slnx
- Directory.Build.props build rules and analyzers for every project
- Directory.Packages.props every package version, in one place
- Dockerfile
- docker-compose.yml the API, an OpenTelemetry Collector and the Aspire dashboard
- otel-collector.yaml where the collector sends logs, traces and metrics
- global.json
- NuGet.config
| Project | References | Notes |
|---|---|---|
| Presentation | Application, Infrastructure | References Infrastructure only to wire up dependency injection |
| Application | none | Owns the entities, the repository interfaces and the rules |
| Infrastructure | Application | Every class but DependencyInjection is internal |