001 Project structure

app/adapters/__init__.py

@@ -0,0 +1 @@
+"""External adapters."""

app/adapters/delivery_providers/__init__.py

@@ -0,0 +1 @@
+"""Delivery provider adapters."""

app/adapters/delivery_providers/base.py

@@ -0,0 +1,16 @@
+"""Base interface for delivery providers."""
+
+from abc import ABC, abstractmethod
+
+from app.schemas.request import DeliveryRequest
+from app.schemas.response import DeliveryPrice
+
+
+class DeliveryProvider(ABC):
+    name: str
+
+    @abstractmethod
+    async def get_price(self, request: DeliveryRequest) -> DeliveryPrice:
+        """Fetch one quote from an external provider."""
+
+        raise NotImplementedError

app/adapters/delivery_providers/cdek/__init__.py

@@ -0,0 +1 @@
+"""CDEK adapter package."""

app/adapters/delivery_providers/cdek/auth.py

@@ -0,0 +1,6 @@
+"""CDEK auth adapter skeleton."""
+
+
+class CDEKAuthClient:
+    async def get_access_token(self) -> str:
+        raise NotImplementedError("CDEK auth implementation is added in task 003.")

app/adapters/delivery_providers/cdek/client.py

@@ -0,0 +1,9 @@
+"""CDEK HTTP client adapter skeleton."""
+
+from app.schemas.request import DeliveryRequest
+
+
+class CDEKClient:
+    async def get_raw_price(self, request: DeliveryRequest) -> dict:
+        _ = request
+        raise NotImplementedError("CDEK client implementation is added in task 003.")

app/adapters/delivery_providers/cdek/mapper.py

@@ -0,0 +1,8 @@
+"""CDEK response mapper skeleton."""
+
+from app.schemas.response import DeliveryPrice
+
+
+def map_cdek_response(payload: dict) -> DeliveryPrice:
+    _ = payload
+    raise NotImplementedError("CDEK mapper implementation is added in task 003.")