docs/05_Development/05_developer_guide.md

@@ -69,13 +69,47 @@ graph TD
 
 ### 2.2 Datenfluss-Muster
 
-1.  **Ingestion (Write):**
+#### A. Ingestion (Write)
-    `Markdown` -> `Parser` -> `Chunker` -> `SemanticAnalyzer (LLM)` -> `Embedder` -> `Qdrant (Points)`
+Vom Markdown zur Vektor-Datenbank.
-2.  **Retrieval (Read):**
+```mermaid
-    `Query` -> `Embedding` -> `Hybrid Search (Vector + Graph)` -> `Re-Ranking` -> `LLM Context`
+graph LR
-3.  **Visualisierung (Graph):**
+    MD[Markdown File] --> Parser(Parser)
-    `UI` -> `GraphService` -> `Qdrant (Edges Collection)` -> `Cytoscape`
+    Parser --> Chunker(Chunker)
+    Chunker -- "Text Chunks" --> SemAn{SemanticAnalyzer<br/>(LLM)}
+    SemAn -- "Smart Edges" --> Embedder(Embedder)
+    Embedder --> DB[(Qdrant<br/>Points)]
     
+    style DB fill:#f9f,stroke:#333,stroke-width:2px
+    style SemAn fill:#ff9,stroke:#333,stroke-width:2px
+```
+
+#### B. Retrieval (Read)
+Die hybride Suche für Chat & RAG.
+```mermaid
+graph LR
+    Query([Query]) --> Embed(Embedding)
+    Embed --> Hybrid{Hybrid Search}
+    
+    subgraph Search Components
+        Vec[Vector Score]
+        Graph[Graph/Edge Bonus]
+    end
+    
+    Vec --> Hybrid
+    Graph --> Hybrid
+    
+    Hybrid --> Rank(Re-Ranking)
+    Rank --> Ctx[LLM Context]
+```
+
+#### C. Visualisierung (Graph)
+Der optimierte Pfad für das Frontend.
+```mermaid
+graph LR
+    UI[Frontend UI] --> Service(GraphService)
+    Service -- "Direct Read" --> DB[(Qdrant<br/>Edges Collection)]
+    DB --> Cyto[Cytoscape<br/>Rendering]
+```
 ---
 
 ## 3. Physische Architektur