Routing

Execution Workflow

1. Decide whether the endpoint layer should be service-backed or repository-only.
2. Separate read schemas from write schemas when API contracts differ from the ORM model.
3. Standardize collection routes around filtering and LimitOffset pagination.
4. Keep item routes explicit for get, patch, and delete, including typed identifiers.
5. Commit writes through the framework integration or explicit service options, not ad hoc controller code.

Implementation Rules

• Prefer thin handlers that delegate to services or repositories immediately.
• Avoid returning ORM instances directly when the framework expects serialized schema objects.
• Keep pagination, filters, and loader options consistent across list and detail handlers.
• Fall back to repository-only handlers only when a service layer adds no value.

Example Pattern