No canonical snake_case/camelCase serialization policy

backend/app/models/server.py

@@ -1,16 +1,21 @@
 """Server status and health-check Pydantic models.
 
 Used by the dashboard router, health service, and server settings router.
+
+All models inherit from :class:`~app.models.response.BanGuiBaseModel` which
+enforces the project-wide **snake_case** API field naming policy: field names
+are identical in Python, JSON wire format, and the corresponding TypeScript
+interfaces.
 """
 
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import Field
+
+from app.models.response import BanGuiBaseModel
 
 
-class ServerStatus(BaseModel):
+class ServerStatus(BanGuiBaseModel):
     """Cached fail2ban server health snapshot."""
 
-    model_config = ConfigDict(strict=True)
-
     online: bool = Field(..., description="Whether fail2ban is reachable via its socket.")
     version: str | None = Field(default=None, description="fail2ban version string.")
     active_jails: int = Field(default=0, ge=0, description="Number of currently active jails.")
@@ -18,19 +23,15 @@ class ServerStatus(BaseModel):
     total_failures: int = Field(default=0, ge=0, description="Aggregated current failure count across all jails.")
 
 
-class ServerStatusResponse(BaseModel):
+class ServerStatusResponse(BanGuiBaseModel):
     """Response for ``GET /api/dashboard/status``."""
 
-    model_config = ConfigDict(strict=True)
-
     status: ServerStatus
 
 
-class ServerSettings(BaseModel):
+class ServerSettings(BanGuiBaseModel):
     """Domain model for fail2ban server-level settings."""
 
-    model_config = ConfigDict(strict=True)
-
     log_level: str = Field(..., description="fail2ban daemon log level.")
     log_target: str = Field(..., description="Log destination: STDOUT, STDERR, SYSLOG, or a file path.")
     syslog_socket: str | None = Field(default=None)
@@ -39,22 +40,18 @@ class ServerSettings(BaseModel):
     db_max_matches: int = Field(..., description="Maximum stored matches per ban record.")
 
 
-class ServerSettingsUpdate(BaseModel):
+class ServerSettingsUpdate(BanGuiBaseModel):
     """Payload for ``PUT /api/server/settings``."""
 
-    model_config = ConfigDict(strict=True)
-
     log_level: str | None = Field(default=None)
     log_target: str | None = Field(default=None)
     db_purge_age: int | None = Field(default=None, ge=0)
     db_max_matches: int | None = Field(default=None, ge=0)
 
 
-class ServerSettingsResponse(BaseModel):
+class ServerSettingsResponse(BanGuiBaseModel):
     """Response for ``GET /api/server/settings``."""
 
-    model_config = ConfigDict(strict=True)
-
     settings: ServerSettings
     warnings: dict[str, bool] = Field(
         default_factory=dict,