types(backend): add TypedDict schemas; enable mypy in CI; type annotate basic analysis

Author: ergon73

.github/workflows/ci.yml

@@ -55,4 +55,9 @@ jobs:
           pip install pytest
           pytest -q
 
+      - name: Type-check backend (mypy)
+        run: |
+          pip install mypy
+          mypy backend
+
 

backend/pdf_server.py

@@ -12,6 +12,7 @@
 from flask_cors import CORS
 import logging
 from werkzeug.utils import secure_filename
+from backend.types import BasicAnalysis
 from bleach.sanitizer import Cleaner
 from backend.errors import register_error_handlers, ValidationError
 
@@ -68,12 +69,12 @@ def _block_external_url_fetcher(url):
     }
 })
 
-def perform_basic_analysis(df: pd.DataFrame) -> dict:
+def perform_basic_analysis(df: pd.DataFrame) -> BasicAnalysis:
     """Выполняет базовый анализ данных DataFrame."""
     logger.debug(f"Starting basic analysis. DataFrame shape: {df.shape}")
     logger.debug(f"DataFrame columns: {df.columns.tolist()}")
 
-    analysis = {
+    analysis: BasicAnalysis = {
         'numeric_columns': {},
         'string_columns': {}
     }

backend/types.py

@@ -0,0 +1,30 @@
+from typing import TypedDict, Dict, List, Any
+
+
+class NumericStats(TypedDict):
+    sum: float
+    mean: float
+    min: float
+    max: float
+
+
+class StringStats(TypedDict):
+    unique_values_count: int
+    unique_values: List[str]
+
+
+class BasicAnalysis(TypedDict):
+    numeric_columns: Dict[str, NumericStats]
+    string_columns: Dict[str, StringStats]
+
+
+class FileUploadResponse(TypedDict):
+    table_data: List[Dict[str, Any]]
+    columns: List[str]
+    total_rows: int
+    current_page: int
+    page_size: int
+    total_pages: int
+    basic_analysis: BasicAnalysis
+
+

mypy.ini

@@ -0,0 +1,13 @@
+[mypy]
+python_version = 3.12
+ignore_missing_imports = True
+warn_unused_ignores = True
+warn_redundant_casts = True
+warn_unused_configs = True
+strict_optional = True
+
+[mypy-backend.*]
+disallow_untyped_defs = True
+check_untyped_defs = True
+
+