From 7631b93900b0f2dba9d6ea240e7007974dcc11d4 Mon Sep 17 00:00:00 2001 From: Lars Date: Mon, 8 Dec 2025 06:53:04 +0100 Subject: [PATCH] =?UTF-8?q?Programmmanagement/ARCHITECTURE=5FSNAPSHOT=5Fv2?= =?UTF-8?q?.2.1.md=20hinzugef=C3=BCgt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ARCHITECTURE_SNAPSHOT_v2.2.1.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 Programmmanagement/ARCHITECTURE_SNAPSHOT_v2.2.1.md diff --git a/Programmmanagement/ARCHITECTURE_SNAPSHOT_v2.2.1.md b/Programmmanagement/ARCHITECTURE_SNAPSHOT_v2.2.1.md new file mode 100644 index 0000000..1960599 --- /dev/null +++ b/Programmmanagement/ARCHITECTURE_SNAPSHOT_v2.2.1.md @@ -0,0 +1,27 @@ +# Architecture Snapshot v2.2.1 +**Stand:** Nach Abschluss von WP-04c +**Kontext:** Wichtig für WP-05 Entwicklung. + +## 1. Neue Komponenten (Seit v2.2.0) + +### A. Feedback Service (`app/services/feedback_service.py`) +- **Zweck:** Logging von Trainingsdaten für späteres Self-Tuning (WP-08). +- **Storage:** Lokale JSONL-Dateien in `data/logs/` (Append-Only). + - `search_history.jsonl`: Query + Snapshot der Ergebnisse (Scores). + - `feedback.jsonl`: User-Rating zu spezifischer `node_id`. + +### B. Explanation Layer (`app/core/retriever.py`) +- **Logik:** Der Retriever berechnet nicht nur Scores, sondern generiert `Explanation`-Objekte. +- **Graph:** `Subgraph` (in `graph_adapter.py`) führt jetzt auch `reverse_adj` (Incoming Edges), um zu erklären, warum ein Knoten wichtig ist ("Referenziert von..."). + +### C. DTOs (`app/models/dto.py`) +Das Datenmodell wurde massiv erweitert. Wichtige Klassen für WP-05: +- `QueryResponse`: Enthält jetzt `query_id` (UUID). +- `QueryHit`: Enthält optional `explanation` (Typ `Explanation`). +- `FeedbackRequest`: Für den Feedback-Loop. + +## 2. Implikationen für WP-05 (Chat) + +1. **Logging:** Auch der neue `/chat` Endpoint sollte idealerweise die `query_id` loggen oder nutzen, um Konsistenz zu wahren. +2. **DTO-Nutzung:** Der Chat-Service wird intern den Retriever aufrufen. Er muss mit den `QueryHit`-Objekten arbeiten, um den Kontext für das LLM zu bauen. +3. **Config:** Die Persönlichkeit wird in `config/prompts.yaml` definiert (Late Binding), nicht im Python-Code hardcodiert. \ No newline at end of file