ADR: Getrennter Ergänzungslauf für neue Dokumente

Status: angenommen. Datum: 21.10.2026.

Nachträglich hochgeladene Unterlagen ergänzen den gespeicherten Kriterienbestand, ohne die ursprüngliche Extraktionspipeline erneut zu durchlaufen.

Ein separater Endpoint POST .../criteria-extraction-v2/{run_id}/supplements verarbeitet ausschließlich ausgewählte, noch nicht erfolgreich verarbeitete Dateivorkommen. Der initiale Endpoint und seine Prompts bleiben unverändert. Basis ist die gespeicherte menschliche Bearbeitung, andernfalls das abgeschlossene Extraktionsergebnis. Ein eigener Projekt-/Losprompt liefert ein typisiertes Delta oder JSON null: Lücken füllen, Listen ergänzen, Widersprüche protokollieren. Bekannte Werte und stabile Loskennungen bleiben erhalten. Eine belegte Ergänzung der ursprünglichen Losnummer aktualisiert nur die entsprechenden technischen Referenzen derselben Loskennung, nicht Kriterieninhalt oder Prüferangaben.

Der bestehende Dokumentprompt extrahiert ausschließlich die neuen Unterlagen. Große Dokumente starten zuerst, begrenzt durch dieselbe Parallelitätsgrenze. Ein separater Vergleich nutzt die vorhandenen fachlichen Matching-Regeln: alle Gruppen gemeinsam, getrennt nach Bestand und neuen Kriterien, ohne Quellen oder Prüfermetadaten. Die Antwort enthält neue IDs, ignorierte neue IDs und tatsächlich ergänzte Mergeobjekte. Unveränderte Bestandskriterien werden nicht ausgegeben. Quellen werden wie bisher aggregiert; Ausschluss Ja bleibt erhalten. Inhaltlich geänderte Kriterien sind erneut ungeprüft.

Eine zusätzliche Tabelle hält Fortschritt und Zwischenergebnisse privat. Erst nach erfolgreichem Abschluss veröffentlicht eine Datenbankfunktion Projektfelder, neue Dokumentergebnisse, kumulierten Merge und Reviewinhalt in einer Transaktion. Bestehende Dokumentergebnisse bleiben erhalten. Reviewrevision und technische Ergänzungsrevision verhindern das Überschreiben paralleler Bearbeitungen. Fehler ändern den veröffentlichten Stand nicht. Ein erneuter Versuch wird bewusst gestartet; Statusabfragen starten keine Modellaufrufe.

Die Reviewrevision steigt auch ohne menschlichen Abschluss: Neue Kriterien bleiben ungeprüft, bestehende Kriterien behalten ihre individuellen Prüferangaben. Alte Browserentwürfe erkennt der bestehende Revisionsschutz. Der Zurücksetzen-Button bezieht sich nach einer Ergänzung auf den kumulierten Ausgangsstand.

Wie die initiale Hintergrundpipeline ist dies für einen API-Prozess/eine Replik ausgelegt. Nach einem Neustart erscheinen verwaiste Ergänzungen als unterbrochen. Migration: 124_criteria_extraction_v2_supplements.sql.