[split-required] Split final 43 files (500-668 LOC) to complete refactoring

klausur-service (11 files):
- cv_gutter_repair, ocr_pipeline_regression, upload_api
- ocr_pipeline_sessions, smart_spell, nru_worksheet_generator
- ocr_pipeline_overlays, mail/aggregator, zeugnis_api
- cv_syllable_detect, self_rag

backend-lehrer (17 files):
- classroom_engine/suggestions, generators/quiz_generator
- worksheets_api, llm_gateway/comparison, state_engine_api
- classroom/models (→ 4 submodules), services/file_processor
- alerts_agent/api/wizard+digests+routes, content_generators/pdf
- classroom/routes/sessions, llm_gateway/inference
- classroom_engine/analytics, auth/keycloak_auth
- alerts_agent/processing/rule_engine, ai_processor/print_versions

agent-core (5 files):
- brain/memory_store, brain/knowledge_graph, brain/context_manager
- orchestrator/supervisor, sessions/session_manager

admin-lehrer (5 components):
- GridOverlay, StepGridReview, DevOpsPipelineSidebar
- DataFlowDiagram, sbom/wizard/page

website (2 files):
- DependencyMap, lehrer/abitur-archiv

Other: nibis_ingestion, grid_detection_service, export-doclayout-onnx

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

backend-lehrer/worksheets_models.py

@@ -0,0 +1,135 @@
+"""
+Worksheets API - Pydantic Models und Helpers.
+
+Request-/Response-Models und Hilfsfunktionen fuer die
+Arbeitsblatt-Generierungs-API.
+"""
+
+import uuid
+from datetime import datetime
+from typing import List, Dict, Any, Optional
+from enum import Enum
+
+from pydantic import BaseModel, Field
+
+from generators.mc_generator import Difficulty
+from generators.cloze_generator import ClozeType
+from generators.quiz_generator import QuizType
+
+
+# ============================================================================
+# Pydantic Models
+# ============================================================================
+
+class ContentType(str, Enum):
+    """Verfügbare Content-Typen."""
+    MULTIPLE_CHOICE = "multiple_choice"
+    CLOZE = "cloze"
+    MINDMAP = "mindmap"
+    QUIZ = "quiz"
+
+
+class GenerateRequest(BaseModel):
+    """Basis-Request für Generierung."""
+    source_text: str = Field(..., min_length=50, description="Quelltext für Generierung")
+    topic: Optional[str] = Field(None, description="Thema/Titel")
+    subject: Optional[str] = Field(None, description="Fach")
+    grade_level: Optional[str] = Field(None, description="Klassenstufe")
+
+
+class MCGenerateRequest(GenerateRequest):
+    """Request für Multiple-Choice-Generierung."""
+    num_questions: int = Field(5, ge=1, le=20, description="Anzahl Fragen")
+    difficulty: str = Field("medium", description="easy, medium, hard")
+
+
+class ClozeGenerateRequest(GenerateRequest):
+    """Request für Lückentext-Generierung."""
+    num_gaps: int = Field(5, ge=1, le=15, description="Anzahl Lücken")
+    difficulty: str = Field("medium", description="easy, medium, hard")
+    cloze_type: str = Field("fill_in", description="fill_in, drag_drop, dropdown")
+
+
+class MindmapGenerateRequest(GenerateRequest):
+    """Request für Mindmap-Generierung."""
+    max_depth: int = Field(3, ge=2, le=5, description="Maximale Tiefe")
+
+
+class QuizGenerateRequest(GenerateRequest):
+    """Request für Quiz-Generierung."""
+    quiz_types: List[str] = Field(
+        ["true_false", "matching"],
+        description="Typen: true_false, matching, sorting, open_ended"
+    )
+    num_items: int = Field(5, ge=1, le=10, description="Items pro Typ")
+    difficulty: str = Field("medium", description="easy, medium, hard")
+
+
+class BatchGenerateRequest(BaseModel):
+    """Request für Batch-Generierung mehrerer Content-Typen."""
+    source_text: str = Field(..., min_length=50)
+    content_types: List[str] = Field(..., description="Liste von Content-Typen")
+    topic: Optional[str] = None
+    subject: Optional[str] = None
+    grade_level: Optional[str] = None
+    difficulty: str = "medium"
+
+
+class WorksheetContent(BaseModel):
+    """Generierter Content."""
+    id: str
+    content_type: str
+    data: Dict[str, Any]
+    h5p_format: Optional[Dict[str, Any]] = None
+    created_at: datetime
+    topic: Optional[str] = None
+    difficulty: Optional[str] = None
+
+
+class GenerateResponse(BaseModel):
+    """Response mit generiertem Content."""
+    success: bool
+    content: Optional[WorksheetContent] = None
+    error: Optional[str] = None
+
+
+class BatchGenerateResponse(BaseModel):
+    """Response für Batch-Generierung."""
+    success: bool
+    contents: List[WorksheetContent] = []
+    errors: List[str] = []
+
+
+# ============================================================================
+# Helper Functions
+# ============================================================================
+
+def parse_difficulty(difficulty_str: str) -> Difficulty:
+    """Konvertiert String zu Difficulty Enum."""
+    mapping = {
+        "easy": Difficulty.EASY,
+        "medium": Difficulty.MEDIUM,
+        "hard": Difficulty.HARD
+    }
+    return mapping.get(difficulty_str.lower(), Difficulty.MEDIUM)
+
+
+def parse_cloze_type(type_str: str) -> ClozeType:
+    """Konvertiert String zu ClozeType Enum."""
+    mapping = {
+        "fill_in": ClozeType.FILL_IN,
+        "drag_drop": ClozeType.DRAG_DROP,
+        "dropdown": ClozeType.DROPDOWN
+    }
+    return mapping.get(type_str.lower(), ClozeType.FILL_IN)
+
+
+def parse_quiz_types(type_strs: List[str]) -> List[QuizType]:
+    """Konvertiert String-Liste zu QuizType Enums."""
+    mapping = {
+        "true_false": QuizType.TRUE_FALSE,
+        "matching": QuizType.MATCHING,
+        "sorting": QuizType.SORTING,
+        "open_ended": QuizType.OPEN_ENDED
+    }
+    return [mapping.get(t.lower(), QuizType.TRUE_FALSE) for t in type_strs]