User guide
The Workflow Editor is a single web app. After logging in through Keycloak you land on the Warehouse.
Layout
- Header — project name, a Documentation button (opens this site), a theme toggle (light / dark / system), logout and your initials (click to open Settings).
- Navigation rail (left) — one icon per page, in this order:
| Page | What it is for |
|---|---|
| Warehouse | Your catalogue: workflows, digital resources, workers, data kinds, processor definitions and (admins) data interface types. |
| Workflow Lab | Design, configure, save, run and monitor one workflow. |
| Workflow Assistant (Preview) | Draft workflows and resources by chatting. |
| Kibana Visualizations | Open Elasticsearch resources in Kibana with ready-made dashboards. |
| Worker Runtime | Containers per worker: health, logs, start / stop / restart. |
| Logstash Monitor | Status and event counters of every Logstash pipeline. |
| Airflow DAGs | The Airflow UI (administrators only). |
| Settings | Theme, credentials, GitHub tokens, AI provider, initialization. |
Roles
Everyone sees their own catalogue objects plus shared and built-in ones. Users whose Keycloak roles contain admin additionally get the Data Interface Types tab, the Airflow DAGs page and the Initialize Resources action, and can edit or delete any workflow template.
Typical order of work
- Initialize resources (once per user).
- Register workers.
- Add or reuse processor definitions.
- Describe data with data kinds and digital resources.
- Compose and run a workflow in the Workflow Lab.
- Observe and operate: Observations, Kibana, Worker Runtime.
Stuck? See Troubleshooting & FAQ.