Refactor code structure for improved readability and maintainability

custom/docs/workflows/README.md

@@ -0,0 +1,72 @@
+# Workflow Definitions
+
+This directory contains workflow definitions in JSON format that can be imported into EspoCRM using the workflow manager script.
+
+## File Format
+
+### Simple Workflow
+```json
+{
+    "type": "simple",
+    "name": "workflow-name",
+    "entity_type": "EntityName",
+    "trigger_type": "afterRecordSaved",
+    "is_active": true,
+    "description": "Description of what this workflow does",
+    "category": "Category Name",
+    "conditions_all": [],
+    "conditions_any": [],
+    "conditions_formula": null,
+    "actions": []
+}
+```
+
+**Trigger Types:**
+- `afterRecordSaved` - After record is created or updated
+- `afterRecordCreated` - Only after record is created
+- `scheduled` - Runs on a schedule
+- `manual` - Manually triggered
+
+**Condition Types:**
+- `equals`, `notEquals`, `greaterThan`, `lessThan`, `contains`, `notContains`, `isEmpty`, `isNotEmpty`, `isTrue`, `isFalse`, `wasEqual`, `wasNotEqual`, `changed`, `notChanged`
+
+**Action Types:**
+- `sendEmail` - Send email to recipient
+- `createEntity` - Create a new record
+- `updateEntity` - Update current record
+- `relateTo` - Link to another record
+- `unrelateFrom` - Unlink from record
+- `applyAssignmentRule` - Apply assignment rules
+- `createNotification` - Create notification
+
+### BPM Flowchart
+```json
+{
+    "type": "bpm",
+    "name": "flowchart-name",
+    "target_type": "EntityName",
+    "is_active": true,
+    "description": "Description",
+    "data": {
+        "list": []
+    },
+    "elements_data_hash": {},
+    "event_start_all_id_list": []
+}
+```
+
+## Usage
+
+Import a workflow:
+```bash
+docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php import /var/www/html/custom/workflows/your-workflow.json
+```
+
+Export a workflow:
+```bash
+docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php export <workflow-id> /var/www/html/custom/workflows/exported.json
+```
+
+## Examples
+
+- `vmh-erstberatung-abschliessen.json` - Sends email and sets status when consultation is completed