Rezept: Monatlicher Prozess mit Freigaben und Erinnerungen
Ein Ablauf, der jeden Monat von selbst startet, eine Person um Freigabe bittet, freundlich erinnert, erst nach dem Klick handelt und das Ergebnis mit den offenen Fällen zurückmeldet.
Manche Arbeit soll automatisch laufen, aber nicht ohne einen Menschen: Gutschriften buchen, nachdem jemand die Liste geprüft hat. Offene Posten durchgehen, bevor der Monat abgeschlossen wird. Dieses Rezept zeigt, wie TaskMonkey so einen Ablauf führt: Er fragt die richtige Person, erinnert, wartet auf die Freigabe und meldet danach, was passiert ist und was noch zu tun bleibt.
Ziel
- Jeden Monat startet der Ablauf von selbst, zum Beispiel am 1. um 8 Uhr.
- Eine bestimmte Person (oder jedes Admin-/Manager-Mitglied) bekommt eine Mail mit Link auf die Liste und einem Freigabe-Button.
- Ohne Reaktion: tägliche Erinnerung, ab der Frist mit Kopie an eine zweite Person, danach ein letzter Hinweis.
- Nichts passiert ohne Freigabe. Nach dem Klick handelt TaskMonkey genau einmal, frühestens ab einem festen Tag.
- Danach eine Ergebnis-Mail mit Zahlen und den Fällen, die jemand ansehen muss, verständlich formuliert („Betrag in Spalte F fehlt“).
- Sind Fälle offen: ein zweiter Button „Korrigiert – nachbuchen“. Beliebig oft wiederholbar.
So sieht der Ablauf aus
01. 08:00 Karte im Chat der Prüfenden: „Bitte bis 04. freigeben“ (Buttons Freigeben/Ablehnen);
Mail nur, wenn die Karte nach 2 Arbeitsstunden ungelesen ist
02.–03. Erinnerung je Tag um 08:00
04. 10:00 Frist: Erinnerung mit Kopie an die Geschäftsführung, weiter täglich bis 10.
11. letzter Hinweis an die Geschäftsführung, keine Erinnerungen mehr
Freigabe frühestens ab 04. 08:00: Buchung in Paketen, bis nichts mehr offen ist
danach Ergebnis im Chat (Vorgangs-Block); bei offenen Fällen neue Karte „Korrigiert – nachbuchen“
Nachbuchen wieder Buchung nur für diesen Monat, wieder Ergebnis im Chat
ungelesen nach 1 Arbeitstag Zusammenfassung „Ungelesen bei TaskMonkey“ per Mail (höchstens 1×/Tag)
Ablehnung Hinweis, der Monat ruht
Bausteine
| Baustein | Was er tut |
|---|---|
Prozess-Beschreibung processes.<name> |
Schritte, Adressat, Texte, Fristen, Erinnerungsplan, Testmodus – lesbar in einer Config-Datei des Workspaces |
Tool runProcess |
führt die Beschreibung aus; jeder Aufruf macht die nächsten Schritte bis zum ersten Warten |
| Geplante Aufgabe | ruft runProcess alle 15 Minuten auf; ohne offenen Schritt kostet das nichts |
Freigaben (/manage/approvals) |
dort klickt die Person „Freigeben“ oder „Ablehnen“; die erste Entscheidung gilt, wer entschieden hat, steht dabei |
| Hauptchat | jede Anfrage erscheint als Karte mit denselben Buttons, jeder Schritt als Zeile im Vorgangs-Block („Freigegeben von Iskra“, „Paket 1 – 20 gebucht“, Ergebnis). Die Karte zeigt den Stand live |
Benachrichtigungen (Profil → Benachrichtigungen, /users/notifications) |
Mail nur als Fallback: ungelesene Karte nach 2 (mit Frist) bzw. 4 Arbeitsstunden, ungelesene Meldungen nach 1 Arbeitstag als Zusammenfassung. Je Person abschaltbar; fristgebundene Freigaben an eine einzelne Person kommen immer |
Die Schritte eines Prozesses sind von drei Arten:
| Art | Bedeutung |
|---|---|
tool |
ein Werkzeug aufrufen, z. B. eine Liste bauen oder buchen. Mit repeat in Paketen über mehrere Läufe |
approval |
Freigabe-Anfrage als Karte im Chat, mit Erinnerungen, Frist und frühestem Start; nach der Freigabe genau einmal weiter (oder mit loop_to zurück, z. B. zum Nachbuchen) |
mail |
Bescheid geben, z. B. das Ergebnis: steht im Chat der Empfänger, per Mail nur an Empfänger ohne TaskMonkey-Konto bzw. als Fallback |
Jeder Schritt kann eine Bedingung when haben, etwa „nur wenn es Prüffälle gibt“.
Beispiel (gekürzt)
'processes' => [
'reklamationen' => [
'label' => 'Reklamationen buchen',
'start' => ['day' => 1, 'at' => '08:00'],
'audience' => ['user' => 'pruefung@example.de'],
'escalate_to' => ['chef@example.de'],
'steps' => [
['id' => 'freigabe', 'type' => 'approval',
'title' => 'Reklamationen {period_label} buchen',
'deadline' => ['day' => 4, 'at' => '10:00'],
'remind' => ['every' => '1 day', 'at' => '08:00', 'until' => ['day' => 10, 'at' => '23:59']],
'not_before' => ['day' => 4, 'at' => '08:00']],
['id' => 'buchen', 'type' => 'tool', 'tool' => 'processOpenReklamationen',
'args' => ['tabs' => ['{period_label}'], 'dryRun' => false],
'repeat' => ['until' => ['processed', '==', 0], 'collect' => ['bookings', 'results']]],
['id' => 'auswertung', 'type' => 'tool', 'tool' => 'summarizeReklamationRun', 'args' => ['run' => '{steps.buchen}']],
['id' => 'nachbuchen', 'type' => 'approval', 'when' => ['steps.auswertung.review_count', '>', 0],
'title' => 'Korrigierte Fälle nachbuchen', 'text' => ['{steps.auswertung.lines}'], 'loop_to' => 'buchen'],
],
],
],
Zeitangaben: ['day' => 4, 'at' => '10:00'] ist der 4. des Monats nach dem Zeitraum (Oktober-Reklamationen: 04.11.). '+6 minutes' zählt ab der Anfrage. 'end_of_month' ist das Monatsende.
Ausprobieren im Testmodus
Jeder Prozess kann einen Abschnitt test haben: fester Monat, Frist und Erinnerungen in Minuten statt Tagen, und für heikle Schritte eigene Argumente (zum Beispiel nur Vorschau statt Buchen). Gestartet wird per Kommandozeile:
bin/cake test_tool -t <workspace> --tool runProcess --args '{"process":"<name>","test":true}'
Test-Mails tragen [Test] im Betreff. Ein beendeter Testlauf startet mit "restart":true neu.
Sicherheit
- Gebucht oder versendet wird nur nach einer Freigabe in TaskMonkey (mit Anmeldung). Jede Freigabe wird genau einmal umgesetzt, auch wenn zwei Läufe gleichzeitig kommen.
- Ist die Anfrage an eine Person adressiert, kann nur diese Person entscheiden. Empfänger müssen aktive Admins oder Manager des Workspaces sein.
- Welche Prozesse Freigaben anfragen dürfen, legt der Workspace fest (
approvals.tools). Der Prozess läuft nur als geplante Aufgabe oder per Kommandozeile, nie aus einem Chat oder einer Kunden-Nachricht. - Prozess-Texte stehen in der Config, nicht im Code. Kommentare aus Listen landen nicht in Mails.
Grenzen
- Erinnerungen und Frist-Eskalation führt TaskMonkey zentral aus, wenn der Prozess
'reminders' => 'central'hat (Reklamationen, OPOS): an Arbeitstagen ohne Feiertage, am Fristtag erst zur Frist, Mail nur an Personen, die die Karte im Chat nicht gelesen haben. Ohne den Eintrag erinnert der Prozess wie bisher selbst. Entscheiden geht über die Buttons der Karte, die Seite oder/manage/approvals– nicht per Chat-Nachricht. - Wer alle Mails sofort will wie früher: Workspace-Config
approvals.mail = 'immediate'. - Klicklisten (TaskMonkey-Seiten) legt ein Prozess heute nur im Testmodus per Kommandozeile an; gelesen werden ihre Antworten auch im geplanten Lauf.
Verwandt: Freigaben & Rückfragen, Kreditkarten-Abrechnung als DATEV-Stapel (Versand nur nach Freigabe), Fehlende Belege.