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.