====== Workflow Canvas ======

===== Overview =====

The **Workflow Canvas** is a visual jsPlumb-based interface for designing learning journeys, managing system functions, and building content workflows. LEAST has 19 canvases across functional areas — each is a purpose-specific view of the workflow engine with a matching mobile tile view on screens below 768px.

===== Canvas Reference =====

^ Canvas ^ URL ^ Purpose ^
| Educator Creator | ''/educator/workflow_creator.php'' | Lesson and material creation tools |
| Educator Workflow | ''/educator/workflow_educator.php'' | Teaching tools (courses, rollcall, diary) |
| System Settings | ''/system/workflow_settings.php'' | Admin: users, audit, DB, email, security, workflows |
| System Content | ''/system/workflow_content.php'' | Admin: curriculum, EKOS, UDC, IFQ, IWTB |
| Collection | ''/collection/workflow.php'' | Collection engine administration |
| Workflow Designer | ''/admin/workflow-designer.php'' | BPMN visual process designer |
| Cron Engine | ''/system/workflow_cron.php'' | Cron job scheduling and monitoring |
| KeyRing | ''/educator/keyring_select.php'' | KeyRing management |
| Organisation | ''/organisation/workflow.php'' | Organisation management |
| Meetings | ''/organisation/workflow_meetings.php?ref=...'' | Meeting lifecycle management |
| Curriculum | ''/system/workflow_curriculum.php'' | Curriculum hierarchy |
| Subject | ''/system/workflow_subject.php'' | Subject management |
| Learning Objective | ''/system/workflow_learningobjective.php'' | Learning objective management |
| Education | ''/system/workflow_education.php'' | Education settings |
| Open Badge | ''/admin/workflow_openbadge.php'' | Badge class and issuance |
| Entrepreneur | ''/entrepreneur/workflow.php'' | Entrepreneur module |
| Leading Questions | ''/educator/workflow_leadingqs.php'' | Leading Questions builder |
| Logic Tree | ''/system/workflow_logictree.php'' | Logic Tree management |
| Activity Feed | ''/system/workflow_activity_feed.php'' | Activity feed administration |

===== BPMN Workflow Designer =====

The **Workflow Designer** at ''/admin/workflow-designer.php'' provides a full BPMN-compatible visual process designer:

  * Node types: Start, End, Task, Decision (Gateway), **Timer**, Webhook, Notification
  * Drag-and-drop connections between nodes
  * Export/import workflow definitions
  * Live instance monitoring at ''/admin/workflow-instances.php''
  * Process monitoring and control at ''/admin/workflow-monitor.php''
  * Dead Letter Queue at ''/admin/workflow-dlq.php''

===== Timer Node =====

The **Timer node** pauses a workflow execution for a defined duration before continuing. Use cases:

  * Delayed notifications (e.g. "Send reminder 3 days after enrolment")
  * Spaced learning sequences
  * SLA escalation after timeout

Timer nodes are processed by the ''workflow_timers'' cron job (runs every minute).

===== Meeting Canvas =====

The Meetings canvas (''/organisation/workflow_meetings.php?ref=...'') requires an organisation reference and provides:

^ Button ^ Action ^
| Create | Create a new meeting |
| Manage | Edit meeting details |
| Attendees | Manage who is invited |
| Minutes | Record meeting minutes |
| Actions | Track action items |
| Report | View meeting report |
| Export | Export meeting data |
| Delete | Delete a meeting |

===== Mobile Tile View =====

All 19 canvases render a **mobile tile view** on screens below 768px. Tiles are grouped by functional area and are touch-friendly. Groups are defined in the canvas PHP function (e.g. "Users", "Database", "Security").

===== Educator Creator — Node Types =====

^ Node ^ Purpose ^
| Lesson | Create or edit a lesson |
| Material | Create or edit a material |
| Quiz | Create a quiz |
| KeyRing | Create or select a KeyRing |
| SCORM Export | Export a lesson as SCORM |
| My Materials | Navigate to material library |
| Mindful Writing | Open mindful writing module |

===== Building a Workflow =====

  - Navigate to **Admin → Workflow Designer**
  - Click **New Workflow** and give it a name
  - Drag nodes onto the canvas and connect them
  - Configure each node (task type, assignee, timer duration)
  - Save and activate the workflow
  - Monitor running instances at **Admin → Workflow Instances**