new-handler

What problem does it solve?

Enables teams to add a new HTTP API endpoint following the hexagonal architecture pattern, ensuring clean separation between adapters, domain services, and routing.

Core Features & Use Cases

• Handler placement: add the new endpoint logic to the appropriate internal/adapters/httpserver/handlers/{domain}.go file.
• Route wiring: register the new route in internal/adapters/httpserver/routes.go with the correct authentication level.
• Data contracts & testing: define request/response types, implement handler tests using domain services, and utilize mocks for isolation.
• Consistency & safety: ensure handlers delegate to domain services and avoid direct database access.

Quick Start

Create a new HTTP API endpoint following the hexagonal architecture pattern by adding a new handler, wiring its route, and implementing tests.