refactor: complete Task 2/3 geo decouple + exceptions centralization; mark as done

backend/app/services/geo_service.py

@@ -41,13 +41,12 @@ from __future__ import annotations
 
 import asyncio
 import time
-from collections.abc import Awaitable, Callable
-from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
 import aiohttp
 import structlog
 
+from app.models.geo import GeoInfo
 from app.repositories import geo_cache_repo
 
 if TYPE_CHECKING:
@@ -94,40 +93,6 @@ _BATCH_DELAY: float = 1.5
 #: transient error (e.g. connection reset due to rate limiting).
 _BATCH_MAX_RETRIES: int = 2
 
-# ---------------------------------------------------------------------------
-# Domain model
-# ---------------------------------------------------------------------------
-
-
-@dataclass
-class GeoInfo:
-    """Geographical and network metadata for a single IP address.
-
-    All fields default to ``None`` when the information is unavailable or
-    the lookup fails gracefully.
-    """
-
-    country_code: str | None
-    """ISO 3166-1 alpha-2 country code, e.g. ``"DE"``."""
-
-    country_name: str | None
-    """Human-readable country name, e.g. ``"Germany"``."""
-
-    asn: str | None
-    """Autonomous System Number string, e.g. ``"AS3320"``."""
-
-    org: str | None
-    """Organisation name associated with the IP, e.g. ``"Deutsche Telekom"``."""
-
-
-type GeoEnricher = Callable[[str], Awaitable[GeoInfo | None]]
-"""Async callable used to enrich IPs with :class:`~app.services.geo_service.GeoInfo`.
-
-This is a shared type alias used by services that optionally accept a geo
-lookup callable (for example, :mod:`app.services.history_service`).
-"""
-
-
 # ---------------------------------------------------------------------------
 # Internal cache
 # ---------------------------------------------------------------------------