Refactor backend services and utilities

- Update service layer implementations
- Improve configuration handling utilities
- Update documentation tasks

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

backend/app/services/server_service.py

@@ -16,6 +16,7 @@ import structlog
 
 from app.exceptions import ServerOperationError
 from app.models.server import ServerSettings, ServerSettingsResponse, ServerSettingsUpdate
+from app.utils.constants import FAIL2BAN_SOCKET_TIMEOUT
 from app.utils.fail2ban_client import Fail2BanClient, Fail2BanCommand, Fail2BanResponse
 from app.utils.fail2ban_response import ok
 
@@ -28,8 +29,6 @@ type Fail2BanSettingValue = str | int | bool
 
 log: structlog.stdlib.BoundLogger = structlog.get_logger()
 
-_SOCKET_TIMEOUT: float = 10.0
-
 
 def _to_int(value: object | None, default: int) -> int:
     """Convert a raw value to an int, falling back to a default.
@@ -105,7 +104,7 @@ async def get_settings(socket_path: str) -> ServerSettingsResponse:
     """
     import asyncio
 
-    client = Fail2BanClient(socket_path=socket_path, timeout=_SOCKET_TIMEOUT)
+    client = Fail2BanClient(socket_path=socket_path, timeout=FAIL2BAN_SOCKET_TIMEOUT)
 
     (
         log_level_raw,
@@ -160,7 +159,7 @@ async def update_settings(socket_path: str, update: ServerSettingsUpdate) -> Non
         ServerOperationError: If any ``set`` command is rejected.
         ~app.utils.fail2ban_client.Fail2BanConnectionError: Socket unreachable.
     """
-    client = Fail2BanClient(socket_path=socket_path, timeout=_SOCKET_TIMEOUT)
+    client = Fail2BanClient(socket_path=socket_path, timeout=FAIL2BAN_SOCKET_TIMEOUT)
 
     async def _set(key: str, value: Fail2BanSettingValue) -> None:
         try:
@@ -197,7 +196,7 @@ async def flush_logs(socket_path: str) -> str:
         ServerOperationError: If the command is rejected.
         ~app.utils.fail2ban_client.Fail2BanConnectionError: Socket unreachable.
     """
-    client = Fail2BanClient(socket_path=socket_path, timeout=_SOCKET_TIMEOUT)
+    client = Fail2BanClient(socket_path=socket_path, timeout=FAIL2BAN_SOCKET_TIMEOUT)
     try:
         response = await client.send(["flushlogs"])
         result = ok(cast("Fail2BanResponse", response))