Timeout, Exitcode, Ausgabegrenze und Fallback-Regel verbinden.
Ein Adapter bildet die Grenze zu einem externen Werkzeug. Sein Vertrag umfasst eine Argumentliste, ein Zeitbudget, eine Ausgabegrenze und beobachtbare Fehlerarten. Timeout, Exitcode ungleich null und erfolgreich leere Ausgabe sind verschiedene Fälle. Eine sichere Argumentliste vermeidet die Auswertung von Dateinamen als Shellcode; sie ersetzt weder Eingabeprüfung noch Ressourcenbegrenzung. Der OCR-Fallback startet nur nach einer erklärten Regel, etwa nach erfolgreicher direkter Extraktion ohne Text bei einem unterstützten Dokument. Ein Timeout allein begründet keine stille Wiederholung mit einem teureren Werkzeug. Im Tutorial liefert ein Fake die Resultate. Er prüft Entscheidungen, aber weder die Installation echter Werkzeuge noch deren Verhalten.
Ein Beispiel
Der Fake liefert nacheinander {status:ok,text:Atlas}, {status:failed,error:timeout} und {status:failed,error:exit,returncode:2}. Der erste Fall geht zur Feldprüfung. Die beiden anderen werden als fehlgeschlagene Extraktion angezeigt. Eine vierte Probe mit ok und leerem Text testet separat die OCR-Regel.
