How to add a new endpoint

This is a more detailed, task-style version of the “Your first API” guide.

Checklist

• Choose the owning module and create or reuse contracts.
• Add a Mediator command/query and handler.
• Map the Minimal API endpoint with versioning, authorization, and tags.
• Add tests where appropriate and run the architecture suite.