No canonical snake_case/camelCase serialization policy

backend/app/models/geo.py

@@ -9,21 +9,20 @@ from collections.abc import Awaitable, Callable
 from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import Field
+
+from app.models.response import BanGuiBaseModel
 
 if TYPE_CHECKING:
     import aiohttp
     import aiosqlite
 
-
-class GeoDetail(BaseModel):
+class GeoDetail(BanGuiBaseModel):
     """Enriched geolocation data for an IP address.
 
     Populated from the ip-api.com free API.
     """
 
-    model_config = ConfigDict(strict=True)
-
     country_code: str | None = Field(
         default=None,
         description="ISO 3166-1 alpha-2 country code.",
@@ -41,15 +40,12 @@ class GeoDetail(BaseModel):
         description="Organisation associated with the ASN.",
     )
 
-
-class GeoCacheEntry(BaseModel):
+class GeoCacheEntry(BanGuiBaseModel):
     """A single cached geolocation entry for an IP address.
 
     Represents a row from the ``geo_cache`` table in the application database.
     """
 
-    model_config = ConfigDict(strict=True)
-
     ip: str = Field(..., description="IP address (IPv4 or IPv6).")
     country_code: str | None = Field(
         default=None,
@@ -68,43 +64,34 @@ class GeoCacheEntry(BaseModel):
         description="Organisation associated with the ASN.",
     )
 
-
-class GeoCacheStatsResponse(BaseModel):
+class GeoCacheStatsResponse(BanGuiBaseModel):
     """Response for ``GET /api/geo/stats``.
 
     Exposes diagnostic counters of the geo cache subsystem so operators
     can assess resolution health from the UI or CLI.
     """
 
-    model_config = ConfigDict(strict=True)
-
     cache_size: int = Field(..., description="Number of positive entries in the in-memory cache.")
     unresolved: int = Field(..., description="Number of geo_cache rows with country_code IS NULL.")
     neg_cache_size: int = Field(..., description="Number of entries in the in-memory negative cache.")
     dirty_size: int = Field(..., description="Number of newly resolved entries not yet flushed to disk.")
 
-
-class GeoReResolveResponse(BaseModel):
+class GeoReResolveResponse(BanGuiBaseModel):
     """Response for ``POST /api/geo/re-resolve``.
 
     Reports how many previously unresolved IPs were retried and how many
     gained a resolved country code after the re-resolve operation.
     """
 
-    model_config = ConfigDict(strict=True)
-
     resolved: int = Field(..., description="Number of IPs successfully resolved.")
     total: int = Field(..., description="Number of IPs retried.")
 
-
-class IpLookupResponse(BaseModel):
+class IpLookupResponse(BanGuiBaseModel):
     """Response for ``GET /api/geo/lookup/{ip}``.
 
     Aggregates current ban status and geographical information for an IP.
     """
 
-    model_config = ConfigDict(strict=True)
-
     ip: str = Field(..., description="The queried IP address.")
     currently_banned_in: list[str] = Field(
         default_factory=list,
@@ -115,12 +102,10 @@ class IpLookupResponse(BaseModel):
         description="Enriched geographical and network information.",
     )
 
-
 # ---------------------------------------------------------------------------
 # shared service types
 # ---------------------------------------------------------------------------
 
-
 @dataclass
 class GeoInfo:
     """Geo resolution result used throughout backend services."""
@@ -130,7 +115,6 @@ class GeoInfo:
     asn: str | None
     org: str | None
 
-
 GeoEnricher = Callable[[str], Awaitable[GeoInfo | None]]
 GeoBatchLookup = Callable[
     [list[str], "aiohttp.ClientSession", "aiosqlite.Connection | None"],