feat(agent): log answer comments

docs/API.md

@@ -24,6 +24,7 @@ Aufbewahrung. Ein allgemeiner API-Key allein reicht dafür nicht aus.
 | `GET` | `/` | Eingabe im UI | Test-Frontend |
 | `POST` | `/v1/ask` | Service-Key | belegte Wissensantwort |
 | `POST` | `/v1/ratings` | Service-Key | Antwort bewerten |
+| `POST` | `/v1/comments` | Service-Key | Kommentar zu einer Antwort protokollieren |
 | `GET` | `/v1/health` | öffentlich | Readiness ohne interne Hostdetails |
 | `POST` | `/v1/reindex` | Admin-Key | Index nach KB-Änderung neu aufbauen |
 
@@ -172,10 +173,27 @@ aktualisiert sie. Unbekannte Request-IDs liefern `404`, deaktiviertes Audit
 `503`. Das Frontend blendet die Bewertungsfunktion nur bei
 `ratings_enabled=true` ein.
 
+## `POST /v1/comments`
+
+Kommentare sind von der Daumenbewertung unabhängig. Pro Antwort können mehrere
+Kommentare protokolliert werden:
+
+```json
+{
+  "request_id": "odoo-request-123",
+  "comment": "Bitte diesen Fall in das Goldset aufnehmen."
+}
+```
+
+Der Kommentar wird getrimmt, darf nicht leer sein und ist auf 2.000 Zeichen
+begrenzt. Die Antwort enthält eine fortlaufende `comment_id`. Unbekannte
+Request-IDs liefern `404`, deaktiviertes Audit `503`.
+
 ## Audit-Protokoll
 
 Bei `PV_AUDIT_ENABLED=true` werden Interaktionen und Bewertungen in der über
-`PV_AUDIT_DB_PATH` festgelegten SQLite-Datei gespeichert. Mit
+`PV_AUDIT_DB_PATH` festgelegten SQLite-Datei gespeichert. Mehrere Kommentare pro Antwort liegen
+in der Tabelle `comments`. Mit
 `PV_AUDIT_STDOUT=true` werden strukturierte JSON-Ereignisse zusätzlich mit dem
 Präfix `AUDIT ` nach stdout geschrieben. `PV_AUDIT_LOG_CONTENT=false` entfernt
 Freitext einschließlich Frage, Antwort, Quellenbeschreibungen, Konflikten,

docs/DOCKER.md

@@ -128,7 +128,8 @@ Compose aktiviert standardmäßig ein detailliertes Audit:
 - `data/audit.db`: persistente SQLite-Datenbank mit Request-ID, Frage, Antwort,
   Status, Zitaten, Quellen, Konflikten, Suchplan, Modell, Laufzeit und
   Regenerierungen;
-- Tabelle `ratings`: Daumen hoch/runter plus optionaler Kommentar;
+- Tabelle `ratings`: Daumen hoch/runter plus optionales Bewertungsfeedback;
+- Tabelle `comments`: mehrere unabhängige Kommentare pro Antwort;
 - `docker compose logs --follow pv-agent`: dieselben Ereignisse als mit
   `AUDIT ` präfixierte JSON-Zeilen für die Betriebsdiagnose; Docker rotiert
   diese Logs bei 50 MB und behält fünf Dateien.
@@ -153,7 +154,7 @@ Fragen und Antworten können sensible Freitexte enthalten. Zugriff auf
 `data/audit.db`, Backups und Docker-Logs ist deshalb auf Administratoren zu
 beschränken. Mit `PV_AUDIT_LOG_CONTENT=false` bleiben nur technische Metadaten
 und KB-IDs erhalten; Frage, Antwort, Quellenbeschreibungen, Konflikttext,
-Suchplan und Bewertungskommentar werden dann nicht gespeichert oder nach stdout
+Suchplan, Bewertungsfeedback und Kommentare werden dann nicht gespeichert oder nach stdout
 geschrieben. API-Keys und Authorization-Header werden nie protokolliert.
 
 ## Sicherheitsprofil