querylenshq/ef-querylens/tsp-csharp

C# & .NET — TSP Standards

Target .NET 8+ / C# 12+. Use the reference files below for detailed guidance per domain.

Reference Files

Read the relevant reference(s) based on the current task:

Decision Tables

Result vs Exception

IOptions Selection

Service Lifetime

Default Patterns

API Endpoint Conventions

• Dedicated request and response models per endpoint — never bind directly to entities
• Explicit parameter binding: [FromQuery], [FromBody], [FromRoute] — no ambiguous model binding
• OpenAPI annotations on every endpoint: Produces<T>() / [ProducesResponseType] for all response codes
• Use enums for status fields and other enumerations — never raw strings or magic integers
• No business logic in endpoint methods — delegate to services
• Return ProblemDetails for all error responses (4xx and 5xx)

Anti-Patterns Quick Reference

Middleware Ordering (ASP.NET Core)

Order matters. Follow this sequence:

1. UseExceptionHandler()          // Catch everything downstream
2. UseStatusCodePages()
3. UseHttpsRedirection()
4. UseStaticFiles()               // If applicable
5. UseRouting()                   // Before auth
6. UseCors()                      // After routing, before auth
7. UseRateLimiter()
8. UseAuthentication()            // Identify user
9. UseAuthorization()             // Check permissions
10. UseOutputCache()              // After auth
11. MapEndpoints()                // Last

Reference Contract

All reference files follow a consistent structure. See _contract.md for details.