feat(interface): add routing over controllers

src/app/interface/http/asgi.py

@@ -10,15 +10,13 @@
 from app.interface.http.controller.system import SystemController
 from app.interface.http.lifespan import lifespan
 from app.interface.http.middleware import RequestLoggingMiddleware
+from app.interface.http.router import api_v1_router
 from app.interface.http.util import (
     create_exception_handlers,
     get_all_application_error_mappings,
     get_all_dependencies,
     get_all_domain_error_mappings,
 )
-from app.module.identity.interface.http.controller.auth import AuthController
-from app.module.identity.interface.http.controller.user import UserController
-from app.module.parcel.interface.http.controller.parcel import ParcelController
 
 
 def create_asgi_application() -> Litestar:
@@ -32,9 +30,7 @@ def create_asgi_application() -> Litestar:
     app = Litestar(
         route_handlers=[
             SystemController,
-            AuthController,
-            UserController,
-            ParcelController,
+            api_v1_router,
         ],
         dependencies=get_all_dependencies(),
         openapi_config=OpenAPIConfig(

src/app/interface/http/controller/system.py

@@ -8,7 +8,7 @@
 class SystemController(Controller):
     """System management endpoints."""
 
-    path = "api/v1/system"
+    path = "/system"
     tags = ("system",)
 
     @get(

src/app/interface/http/router.py

@@ -0,0 +1,22 @@
+"""API v1 router.
+
+Groups all module routers under the ``/api/v1`` prefix.
+"""
+
+from __future__ import annotations
+
+from litestar import Router
+
+from app.module.identity.interface.http.router import identity_router
+from app.module.parcel.interface.http.router import parcel_router
+
+
+api_v1_router = Router(
+    path="/api/v1",
+    route_handlers=[
+        identity_router,
+        parcel_router,
+    ],
+)
+
+__all__ = ("api_v1_router",)

src/app/module/identity/interface/http/controller/auth.py

@@ -32,7 +32,7 @@
 class AuthController(Controller):
     """Authentication and user management endpoints."""
 
-    path = "/api/v1/auth"
+    path = "/auth"
     tags = ("auth",)
 
     @post(
@@ -40,7 +40,7 @@
         status_code=HTTP_201_CREATED,
         description="Register a new user.",
     )
     async def register(
         self,
         data: RegisterRequest,
         register_user_use_case: NamedDependency[RegisterUserUseCase],
@@ -75,7 +75,7 @@
         status_code=HTTP_200_OK,
         description="Authenticate a user and return JWT tokens.",
     )
     async def login(
         self,
         data: LoginRequest,
         authenticate_user_use_case: NamedDependency[AuthenticateUserUseCase],
@@ -133,7 +133,7 @@
         status_code=HTTP_200_OK,
         description="Refresh access token using a refresh token.",
     )
     async def refresh(
         self,
         refresh_token_use_case: NamedDependency[RefreshTokenUseCase],
         refresh_token: Annotated[str, CookieParameter(name="refresh_token", required=True)],

src/app/module/identity/interface/http/controller/user.py

@@ -15,7 +15,7 @@
 class UserController(Controller):
     """User profile endpoints."""
 
-    path = "/api/v1/users"
+    path = "/users"
     tags = ("users",)
     guards = [require_authorization]  # noqa: RUF012
 
@@ -24,7 +24,7 @@
         status_code=HTTP_200_OK,
         description="Get the profile of the currently authenticated user.",
     )
     async def get_profile(
         self,
         get_user_use_case: NamedDependency[GetUserUseCase],
         current_user: CurrentUser,

src/app/module/identity/interface/http/router.py

@@ -0,0 +1,19 @@
+"""Identity module HTTP router."""
+
+from __future__ import annotations
+
+from litestar import Router
+
+from app.module.identity.interface.http.controller.auth import AuthController
+from app.module.identity.interface.http.controller.user import UserController
+
+
+identity_router = Router(
+    path="/identity",
+    route_handlers=[
+        AuthController,
+        UserController,
+    ],
+)
+
+__all__ = ("identity_router",)

src/app/module/parcel/interface/http/controller/parcel.py

@@ -30,7 +30,7 @@
 class ParcelController(Controller):
     """Parcel management endpoints."""
 
-    path = "/api/v1/parcels"
+    path = "/"
     tags = ("parcels",)
     guards = [require_authorization]  # noqa: RUF012
 
@@ -39,7 +39,7 @@
         status_code=HTTP_201_CREATED,
         description="Create a new parcel.",
     )
     async def create_parcel(
         self,
         data: CreateParcelRequest,
         create_parcel_use_case: NamedDependency[CreateParcelUseCase],
@@ -82,7 +82,7 @@
         status_code=HTTP_200_OK,
         description="List all parcels owned by the current user.",
     )
     async def list_user_parcels(
         self,
         list_user_parcels_use_case: NamedDependency[ListUserParcelsUseCase],
         current_user: CurrentUser,

src/app/module/parcel/interface/http/router.py

@@ -0,0 +1,17 @@
+"""Parcel module HTTP router."""
+
+from __future__ import annotations
+
+from litestar import Router
+
+from app.module.parcel.interface.http.controller.parcel import ParcelController
+
+
+parcel_router = Router(
+    path="/parcels",
+    route_handlers=[
+        ParcelController,
+    ],
+)
+
+__all__ = ("parcel_router",)