Add Workflow Manager script for managing BPMN workflows in EspoCRM

README.md

@@ -195,3 +195,29 @@ Um EspoCRM anzupassen, bearbeite JSON-Dateien im custom/-Verzeichnis. Änderunge
         Alternative: Web-Interface > Administration > Clear Cache & Rebuild.
         Effekt: Aktualisiert DB-Schema, Views und entfernt alte Caches. Ohne Rebuild sind Änderungen unsichtbar.
         Hinweis: Führe den Befehl auf dem Host aus, da der Container den PHP-Zugang hat.
+
+## 7. Custom Scripts und Tools
+
+Um die Entwicklung und Wartung zu erleichtern, wurden benutzerdefinierte Scripts im `custom/scripts/`-Ordner abgelegt. Diese Scripts überleben EspoCRM-Updates, da sie außerhalb der Core-Dateien liegen.
+
+### Verfügbare Scripts:
+
+#### workflow_manager.php
+- **Zweck**: Verwaltung von BPMN-Workflows in EspoCRM. Ermöglicht das Lesen, Bearbeiten, Löschen, Ausführen und Testen von Workflows direkt über die Datenbank.
+- **Bedienung**:
+  - Ausführen im EspoCRM-Container: `docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php <aktion> [parameter]`
+  - Aktionen:
+    - `list`: Listet alle verfügbaren Workflows auf (ID und Name).
+    - `read <id>`: Zeigt detaillierte Informationen zu einem Workflow (inkl. JSON-Data).
+    - `delete <id>`: Löscht einen Workflow (mit Bestätigung).
+    - `edit <id> <json_data>`: Bearbeitet die Workflow-Data (übergib gültiges JSON).
+    - `execute <workflow_id> <record_id>`: Führt einen Workflow manuell für einen Record aus (simuliert Trigger).
+    - `test <id>`: Testet Workflow-Bedingungen (simuliert Auswertung).
+- **Beispiele**:
+  - `docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php list`
+  - `docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php read 68df9eb6b8d460186`
+  - `docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php execute 68df9eb6b8d460186 some_record_id`
+- **Hinweise**:
+  - Sichere Backups vor Lösch- oder Edit-Operationen.
+  - Für komplexe Änderungen die EspoCRM-UI verwenden.
+  - Execute simuliert nur einfache Aktionen; für vollständige Ausführung EspoCRM-API nutzen.