Module Structure - serviceAi

Übersicht

Das mainServiceAi.py Modul wurde in mehrere Submodule aufgeteilt, um die Übersichtlichkeit zu verbessern.

Modulstruktur

Hauptmodul

mainServiceAi.py (~800 Zeilen)
- Initialisierung (__init__, create, ensureAiObjectsInitialized)
- Public API (callAiPlanning, callAiContent)
- Routing zu Submodulen
- Helper-Methoden

Submodule

subJsonResponseHandling.py (bereits vorhanden)
- JSON Response Merging
- Section Merging
- Fragment Detection
subResponseParsing.py (~200 Zeilen)
- ResponseParser.extractSectionsFromResponse() - Extrahiert Sections aus AI-Responses
- ResponseParser.shouldContinueGeneration() - Entscheidet ob Generation fortgesetzt werden soll
- ResponseParser._isStuckInLoop() - Loop-Detection
- ResponseParser.extractDocumentMetadata() - Extrahiert Metadaten
- ResponseParser.buildFinalResultFromSections() - Baut finales JSON
subDocumentIntents.py (~300 Zeilen)
- DocumentIntentAnalyzer.clarifyDocumentIntents() - Analysiert Dokument-Intents
- DocumentIntentAnalyzer.resolvePreExtractedDocument() - Löst pre-extracted Dokumente auf
- DocumentIntentAnalyzer._buildIntentAnalysisPrompt() - Baut Intent-Analyse-Prompt
subContentExtraction.py (~600 Zeilen)
- ContentExtractor.extractAndPrepareContent() - Extrahiert und bereitet Content vor
- ContentExtractor.extractTextFromImage() - Vision AI für Bilder
- ContentExtractor.processTextContentWithAi() - AI-Verarbeitung von Text
- ContentExtractor._isBinary() - Helper für Binary-Check
subStructureGeneration.py (~200 Zeilen)
- StructureGenerator.generateStructure() - Generiert Dokument-Struktur
- StructureGenerator._buildStructurePrompt() - Baut Struktur-Prompt
subStructureFilling.py (~400 Zeilen)
- StructureFiller.fillStructure() - Füllt Struktur mit Content
- StructureFiller._buildSectionGenerationPrompt() - Baut Section-Generation-Prompt
- StructureFiller._findContentPartById() - Helper für ContentPart-Suche
- StructureFiller._needsAggregation() - Entscheidet ob Aggregation nötig
subAiCallLooping.py (~400 Zeilen)
- AiCallLooper.callAiWithLooping() - Haupt-Looping-Logik
- AiCallLooper._defineKpisFromPrompt() - KPI-Definition

Verwendung

Alle Submodule werden über das Hauptmodul AiService verwendet:

# Initialisierung
aiService = await AiService.create(serviceCenter)

# Submodule werden automatisch initialisiert
# aiService.responseParser
# aiService.intentAnalyzer
# aiService.contentExtractor
# etc.

Migration

Die öffentliche API bleibt unverändert. Interne Methoden wurden in Submodule verschoben:

_extractSectionsFromResponse → responseParser.extractSectionsFromResponse
_clarifyDocumentIntents → intentAnalyzer.clarifyDocumentIntents
_extractAndPrepareContent → contentExtractor.extractAndPrepareContent
etc.

2.9 KiB Raw Blame History