How yasir2000/bpmninja works
BPMNinja is a Rust BPMN 2.0 workflow engine with a REST server, persistence backends, a Tauri desktop UI, and an external-task client. The principal workflow is BPMN XML parsing and validation, deployment/model checking, process execution, and interaction through API/UI or service-task workers, with state and history persisted. The graph also preserves timer/message handling, monitoring, archived history, and desktop push updates. Several subsystem links reflect README documentation; unsampled implementation details are not asserted beyond those documented relationships.
Main entry points: server/mod.rs REST API server · App.tsx Operations UI · engine/mod.rs Workflow engine · executor/mod.rs Token executor
Components 23
Model and deploy
- BPMN parser
bpmn-parser/src/parser.rs - Collaboration metadata
bpmn-parser/src/collaboration.rs - Deploy model check
engine-server/src/server/model_check.rs
Workflow runtime
- Workflow engine
engine-core/src/engine/mod.rs - Token executor
engine-core/src/engine/executor/mod.rs - Events and boundaries
engine-core/src/engine/event_subprocess.rs - Service tasks
engine-core/src/engine/service_task.rs - Timer scheduler
engine-core/src/engine/timer_processor.rs
Persistence and history
- Instance history
engine-core/src/history/mod.rs - Memory persistence
persistence-memory/src/lib.rs - NATS persistence
persistence-nats/src/client.rs
API and workers
- REST API server
engine-server/src/server/mod.rs - Task client
bpmn-ninja-external-task-client/src/ExternalTaskClient.ts - Sample worker
agent-orchestrator/src/main.rs
Desktop operations
- Desktop bridge
desktop-tauri/src-tauri/src/sse_consumer.rs - Operations UI
desktop-tauri/src/App.tsx - BPMN modeler
desktop-tauri/src/features/modeler/ModelerPage.tsx - Instance tracking
desktop-tauri/src/features/instances/InstancesPage.tsx - User tasks
desktop-tauri/src/features/tasks/PendingTasksPage.tsx - Monitoring and logs
desktop-tauri/src/features/monitoring/MonitoringPage.tsx - History search
desktop-tauri/src/features/history/HistoryPage.tsx
Other components
- Workflow operator
- External worker
Connections 25
- Workflow operator → BPMN modeler: models processes
- BPMN modeler → REST API server: deploys definitions
- REST API server → BPMN parser: parses deployments
- BPMN parser → Collaboration metadata: parses collaboration
bpmn-parser/src/lib.rs - REST API server → Deploy model check: checks deployments
- REST API server → Workflow engine: routes workflow API
- Workflow engine → Token executor: executes tokens
engine-core/src/engine/mod.rs - Token executor → Events and boundaries: handles event work
engine-core/src/engine/executor/mod.rs - Token executor → Service tasks: runs service tasks
engine-core/src/engine/executor/mod.rs - Workflow engine → Timer scheduler: schedules timers
engine-core/src/engine/mod.rs - Workflow engine → Instance history: records lifecycle
engine-core/src/engine/executor/mod.rs - Workflow engine → Memory persistence: persists state
- Workflow engine → NATS persistence: persists state
- External worker → Task client: processes work
- Task client → REST API server: fetches and locks
- Sample worker → REST API server: requests tasks
- Workflow operator → Operations UI: operates workflows
- Operations UI → BPMN modeler: opens modeler
desktop-tauri/src/App.tsx - Operations UI → Instance tracking: opens instances
desktop-tauri/src/App.tsx - Operations UI → User tasks: opens tasks
desktop-tauri/src/App.tsx - Operations UI → Monitoring and logs: opens monitoring
desktop-tauri/src/App.tsx - Operations UI → History search: opens history
desktop-tauri/src/App.tsx - REST API server → Desktop bridge: streams SSE updates
- Desktop bridge → Operations UI: emits UI events
- REST API server → History search: serves archived history