Persist processing-log retention settings and wire cleanup defaults

backend/app/api/routes_processing_logs.py

@@ -7,6 +7,7 @@ from sqlalchemy.orm import Session
 
 from app.db.base import get_session
 from app.schemas.processing_logs import ProcessingLogEntryResponse, ProcessingLogListResponse
+from app.services.app_settings import read_processing_log_retention_settings
 from app.services.processing_logs import (
     cleanup_processing_logs,
     clear_processing_logs,
@@ -42,16 +43,28 @@ def get_processing_logs(
 
 @router.post("/trim")
 def trim_processing_logs(
-    keep_document_sessions: int = Query(default=2, ge=0, le=20),
-    keep_unbound_entries: int = Query(default=80, ge=0, le=400),
+    keep_document_sessions: int | None = Query(default=None, ge=0, le=20),
+    keep_unbound_entries: int | None = Query(default=None, ge=0, le=400),
     session: Session = Depends(get_session),
 ) -> dict[str, int]:
-    """Deletes old processing logs while keeping recent document sessions and unbound events."""
+    """Deletes old processing logs using query values or persisted retention defaults."""
+
+    retention_defaults = read_processing_log_retention_settings()
+    resolved_keep_document_sessions = (
+        keep_document_sessions
+        if keep_document_sessions is not None
+        else int(retention_defaults.get("keep_document_sessions", 2))
+    )
+    resolved_keep_unbound_entries = (
+        keep_unbound_entries
+        if keep_unbound_entries is not None
+        else int(retention_defaults.get("keep_unbound_entries", 80))
+    )
 
     result = cleanup_processing_logs(
         session=session,
-        keep_document_sessions=keep_document_sessions,
-        keep_unbound_entries=keep_unbound_entries,
+        keep_document_sessions=resolved_keep_document_sessions,
+        keep_unbound_entries=resolved_keep_unbound_entries,
     )
     session.commit()
     return result

backend/app/api/routes_settings.py

@@ -10,6 +10,7 @@ from app.schemas.settings import (
     HandwritingStyleSettingsResponse,
     HandwritingSettingsUpdateRequest,
     OcrTaskSettingsResponse,
+    ProcessingLogRetentionSettingsResponse,
     ProviderSettingsResponse,
     RoutingTaskSettingsResponse,
     SummaryTaskSettingsResponse,
@@ -35,6 +36,7 @@ def _build_response(payload: dict) -> AppSettingsResponse:
 
     upload_defaults_payload = payload.get("upload_defaults", {})
     display_payload = payload.get("display", {})
+    processing_log_retention_payload = payload.get("processing_log_retention", {})
     providers_payload = payload.get("providers", [])
     tasks_payload = payload.get("tasks", {})
     handwriting_style_payload = payload.get("handwriting_style_clustering", {})
@@ -55,6 +57,10 @@ def _build_response(payload: dict) -> AppSettingsResponse:
             cards_per_page=int(display_payload.get("cards_per_page", 12)),
             log_typing_animation_enabled=bool(display_payload.get("log_typing_animation_enabled", True)),
         ),
+        processing_log_retention=ProcessingLogRetentionSettingsResponse(
+            keep_document_sessions=int(processing_log_retention_payload.get("keep_document_sessions", 2)),
+            keep_unbound_entries=int(processing_log_retention_payload.get("keep_unbound_entries", 80)),
+        ),
         handwriting_style_clustering=HandwritingStyleSettingsResponse(
             enabled=bool(handwriting_style_payload.get("enabled", True)),
             embed_model=str(handwriting_style_payload.get("embed_model", "ts/clip-vit-b-p32")),
@@ -159,6 +165,10 @@ def set_app_settings(payload: AppSettingsUpdateRequest) -> AppSettingsResponse:
     if payload.display is not None:
         display_payload = payload.display.model_dump(exclude_none=True)
 
+    processing_log_retention_payload = None
+    if payload.processing_log_retention is not None:
+        processing_log_retention_payload = payload.processing_log_retention.model_dump(exclude_none=True)
+
     handwriting_style_payload = None
     if payload.handwriting_style_clustering is not None:
         handwriting_style_payload = payload.handwriting_style_clustering.model_dump(exclude_none=True)
@@ -174,6 +184,7 @@ def set_app_settings(payload: AppSettingsUpdateRequest) -> AppSettingsResponse:
         tasks=tasks_payload,
         upload_defaults=upload_defaults_payload,
         display=display_payload,
+        processing_log_retention=processing_log_retention_payload,
         handwriting_style=handwriting_style_payload,
         predefined_paths=predefined_paths_payload,
         predefined_tags=predefined_tags_payload,