WorkDesk
Integration Overview
WorkDesk integrates with six other BizFirstGO products to deliver a complete employee workspace. This guide maps each integration — the mechanism, direction, and key implementation details — for platform engineers and architects.
Integration Map
Integration Summary Table
| Product | Mechanism | WorkDesk Component |
|---|---|---|
| Atlas Forms | FormRenderer React component; formId from task record | FormTaskCard.tsx |
| Flow Studio | Process_HILTasks DB + POST /resume API | HILTaskSyncService.cs |
| Octopus | ChatWidget embedded in WorkDesk pages | WorkDeskShell.tsx |
| App Studio | Micro-frontend or iframe in WorkDesk content area | AppShellHost.tsx |
| EdgeStream | useSubscription hook on two topics | WorkDeskShell.tsx |
| Passport | JWT bearer token on all REST API calls | Axios interceptor, authStore.ts |
The Core Loop
The central integration pattern in WorkDesk is the HIL task loop:
1
Flow Studio
Workflow reaches HIL node → suspends → writes to Process_HILTasks
2
WorkDesk Backend
HILTaskSyncService detects new task → creates WorkDesk task record → publishes EdgeStream event
3
EdgeStream
Pushes to tasks.{userId} topic → WorkDesk browser receives event → inbox badge increments
4
Atlas Forms (if form task)
Employee opens task → FormRenderer renders the form with initialValues
5
Flow Studio
WorkDesk POSTs response to /resume → workflow continues from HIL node