KFZ-Bozo Handbuch

Schnittstellen, API & Automationen › Überzogen-Erkennung (Cron)

Überzogen-Erkennung (Cron)

AutomationLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)

Erkennt automatisch, wenn ein gebuchter Werkstatttermin ohne Statuswechsel überzogen wurde, und markiert den Auftrag als 'überzogen' — alle 5 Minuten.

BüroWerkstatt

Bild folgt

Alle fünf Minuten sucht dieser Lauf Aufträge, die noch als „gebucht" oder „in Bearbeitung" gelten, deren geplantes Ende aber schon mehr als fünf Minuten zurückliegt, und setzt sie automatisch auf „überzogen". Das greift nur, wenn niemand rechtzeitig von Hand den nächsten Status gesetzt hat — ein bereits „fertig" oder „abgerechnet" gemeldeter Auftrag wird dadurch nie zurückgedreht. Importierte alte COMPOS-Termine und -Altaufträge sind bewusst ausgenommen, weil ihr geplantes Ende technisch oft schon in der Vergangenheit liegt, ohne dass das etwas bedeutet. Der Lauf kann beliebig oft im selben Zeitfenster laufen, ohne doppelt zu wirken — ein bereits überzogener Auftrag wird kein zweites Mal umgeschaltet.

  • Ein Auftrag bleibt trotz abgelaufener Zeit auf „gebucht" stehen → er ist entweder ein importierter COMPOS-Termin (bewusst ausgenommen) oder der Lauf steht gerade still; die Fünf-Minuten-Karenz einrechnen.
ErzeugtGeregelt dur…Überzogen-…Auftragsstatus…Cron-Endpunkte…
  • app/api/cron/overrun-detector/route.ts
  • lib/cron/job-candidates.ts
  • docs/SERVER-DEPLOY-PROMPT.md
zeitplanalle 5 Minuten, bestätigt durch die Server-Crontab
ausloeserAufträge im Status "gebucht" oder "in Bearbeitung", deren geplantes Ende mehr als 5 Minuten in der Vergangenheit liegt; importierte COMPOS-Altaufträge/-Termine sind ausgenommen
benachrichtigtniemanden direkt — der Statuswechsel selbst macht den Auftrag in den Listen als überzogen sichtbar
beruehrtJob-Status gebucht/in Bearbeitung -> überzogen
vault_filternein — kein Treffer auf "vaulted"; betrifft in der Praxis aber nur laufende, nicht archivierte Aufträge
mailnein

Beleg: app/api/cron/overrun-detector/route.ts — "Cadence-Empfehlung: alle 5 Minuten... Idempotent"; docs/SERVER-DEPLOY-PROMPT.md:208 bestätigt "*/5 * * * *" in der Server-Crontab

Schnittstellen, API & AutomationenSeite bearbeiten: wiki/seiten/schnittstellen-automation/auto-overrun-detector.md