KFZ-Bozo Handbuch

Schnittstellen, API & Automationen › Umsatzziel-Erinnerung (Cron)

Umsatzziel-Erinnerung (Cron)

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

Prüft täglich Tages-, Wochen- und Monatsziel und meldet dem Büro per Glocke, wenn ein Ziel gefährdet ist oder verfehlt wurde — nie, wenn es erreicht ist.

BüroChef

Bild folgt

Einmal am Tag vergleicht der Job den gestrigen Kassenbuch-Umsatz mit dem gesetzten Tagesziel; montags zusätzlich die vergangene Woche mit dem Wochenziel, und am ersten Tag des Monats den vergangenen Monat mit dem Monatsziel. Liegt der erreichte Umsatz unter dem Ziel — egal ob knapp oder deutlich —, legt der Job eine Meldung im Büro-Panel an. Wird das Ziel erreicht oder übertroffen, bleibt es still: Es gibt keine Erfolgsmeldung, nur die Warnung bei Verfehlung. Für jede Periode (ein Tag, eine Kalenderwoche, ein Monat) erscheint höchstens eine Meldung, auch wenn der Job mehrfach läuft. Bleibt der Job aus, bemerkt niemand automatisch, wenn ein Ziel verfehlt wurde — die Zahlen selbst bleiben in der Statistik trotzdem einsehbar.

  • Trotz verfehltem Ziel keine Meldung → für dieselbe Periode ist bereits eine Meldung hinterlegt; ein zweiter Lauf am selben Tag löst absichtlich nichts erneut aus.
  • Meldung erscheint, aber ohne Zahlen im Text → gewollt: die konkreten Beträge liegen bewusst erst hinter der Statistik-Ansicht, nicht in der frei sichtbaren Glocke.
LiestGeregelt dur…Umsatzziel…Rechnungen & Z…Cron-Endpunkte…
  • app/api/cron/umsatzziel-reminder/route.ts
  • lib/reminders/umsatzziel.ts
  • lib/db/revenue-goals.ts
zeitplangeplant 1×/Tag früh (docs/plan/hetzner-deploy-prompt-20260614.md:73), tatsächliche Crontab-Zeile nicht verifiziert; zusätzlich montags der Wochen- und am 1. des Monats der Monatscheck
ausloesercron (externer Zeitplan)
benachrichtigtBüro — In-App-Meldung ohne Zielrolle, sichtbar für alle Büro-Rollen; die zugehörigen Zahlen liegen erst hinter der Statistik-Ansicht
vault_filternein — wertet Kassenbuch-Summen aus, kein Bezug zu einzelnen Aufträgen
beruehrtUmsatzstatistik
mailnein — nur In-App-Benachrichtigung

Beleg: app/api/cron/umsatzziel-reminder/route.ts (Statuslogik über calcDeviation, feuert nur bei status != gruen); docs/plan/hetzner-deploy-prompt-20260614.md:73 nennt 1×/Tag früh als geplanten Zeitplan

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