presentation.routers.api.v1.routes.registry¶
API Route Registry - Single Source of Truth for all routes.
This module contains ROUTE_REGISTRY, the authoritative list of all API endpoints. The registry is used to generate FastAPI routes, rate limit rules, auth dependencies, and OpenAPI metadata at application startup.
Registry structure
- 37 total endpoints across 13 resource categories
- Each entry is a RouteMetadata instance with complete specification
- Handlers reference actual functions from router modules
- Auth policies explicitly declared (PUBLIC, AUTHENTICATED, ADMIN, MANUAL_AUTH)
- Rate limit policies assigned based on endpoint sensitivity
Usage
from src.presentation.routers.api.v1.routes.registry import ROUTE_REGISTRY from src.presentation.routers.api.v1.routes.generator import register_routes_from_registry
router = APIRouter(prefix="/api/v1") register_routes_from_registry(router, ROUTE_REGISTRY)
Reference
- docs/architecture/registry-pattern-architecture.md