Glossar
Ein Begriff, eine Bedeutung — identisch in Datenbank, Code, API und UI (ADR 0040). Die folgende Tabelle ist die einzige maßgebliche Quelle. Siehe auch die Erklärungsseite Workspaces und Organisationen für das konzeptionelle Modell.
| Begriff | Bedeutung | Hinweise |
|---|---|---|
| Organisation | Der übergeordnete Abrechnungs-Tenant. Verwaltet Seats, SSO-Konfiguration und Einladungen. Ein Benutzer gehört zu genau einer Organisation. | DB: organizations. Kind ist personal oder team (der gespeicherte Wert team trägt in der Benutzeroberfläche die Bezeichnung „Organisation“). |
| Workspace | Ein Ressourcen-Container innerhalb einer Organisation. Enthält Projekte, Aufgaben, Workflows, Runs, Secrets, Connectors, Schedules und API-Tokens. Die Mitgliedschaft ist benutzerbezogen. | DB: workspaces, FK workspace_id. Das Wort „team“ wird für dieses Konzept nicht verwendet. |
| Projekt | Eine benannte Arbeitseinheit innerhalb eines Workspaces. Gruppiert Aufgaben, Issues, Workflows sowie Git- und Tracker-Zugangsdaten. | DB: projects. |
| Aufgabe (Task) | Eine einzelne Agent-Ausführung, die gegen ein Projekt gestartet wird. Verfolgt Kosten, Dauer, Ereignisse und Ergebnis. Eine Aufgabe ist die Einheit, der du mit follow, logs, intervene oder cancel arbeitest. |
DB: tasks. |
| Run | Eine einzelne Ausführungsinstanz eines Workflows. Ein Workflow kann im Laufe der Zeit viele Runs erzeugen. | DB: runs. |
| Workflow | Ein deklarativer DAG aus Knoten (code, db_query, connector, human, …), der als Run ausgeführt wird. Speicherbar, versionierbar und per Schedule oder Webhook auslösbar. | DB: workflows. |
| Agent | Ein von SupaCloud gestarteter Claude-Code-Prozess, der eine Aufgabe ausführt. Kommuniziert über MCP-Tools zurück. | Konfiguriert über ein Agent-Profil. |
| Agent-Profil | Eine gespeicherte Konfiguration für einen Agenten: Modell, erlaubte MCP-Tiers, Pre-/Post-Flight-Checks, Ausführungsmodus. Wird auf Aufgaben angewendet, wenn es als Workspace-Standard festgelegt ist. | DB: agent_profiles. |
| Teammates | Eine Multi-Agenten-Gruppe, die für eine einzelne Aufgabe gestartet wird. „Team“ bezieht sich in diesem Kontext ausschließlich auf Agenten, niemals auf den Tenant. | Config-Schlüssel: agent_teams / max_teammates. |
| Connector | Eine Wasm-Komponente (WASI 0.2), die eine Drittanbieter-API oder einen Dienst kapselt. Wird aus dem Marketplace installiert oder individuell erstellt; vom Connector-Executor ausgeführt. | DB: marketplace_items (kind='node'). |
| Runner | Ein entkoppelter Worker-Knoten, der beim SupaCloud-Hub registriert ist (instanzweit, vom System-Administrator verwaltet; nicht auf einen Workspace begrenzt). Führt Aufgaben und optional Connector-Workloads aus, die von der Runner-Flotte verteilt werden. | DB: runners. |
| Schedule | Ein cron-basierter Auslöser, der an eine Workflow- oder Aufgabenvorlage gebunden ist. Verwaltbar über schedule add/pause/resume/delete im Web-Terminal. |
DB: task_schedules. |
| Ressource | Eine benannte, mit Zugangsdaten hinterlegte Integration (SMTP-Server, Telegram-Bot, Webhook-Endpunkt, Discord-Bot, Datenbankverbindung, …), die innerhalb eines Workspaces verfügbar ist. | DB: resources. |
| Delivery-Board | Die Agent-Profil-Übersichtsseite unter /delivery. Zeigt laufende Arbeit, gruppiert nach Profil und Lieferstatus. Kein Tenant-Konzept. |
Route: /delivery; i18n-Namespace: delivery_board_*. |
| Backlog | Eine automatisch gepflegte Warteschlange priorisierter Arbeitselemente, die aus dem Issue-Tracker eines Projekts abgeleitet wird. Verwaltet durch den autonomen Backlog-Modus (ADR 0039). | DB: backlog_items. |
| Konzept-Freigabemodus | Ein Autodev-Freigabemodus, in dem der Agent zuerst ein code-fundiertes Umsetzungs-Konzept zur menschlichen Prüfung erstellt und es nach Freigabe umsetzt — innerhalb eines einzigen Runs. | Wert concept von project_automations.approval_mode. |
| Abschlussaktion | Eine Einstellung pro Automatisierung dafür, was mit einem verknüpften Issue geschieht, wenn ein issue-verknüpfter Task fertig ist: Schließen (kommentieren und schließen/transitionieren), Kommentieren (kommentieren, aber offen lassen) oder Nichts (weder noch). | Spalte project_automations.completion_action. |
| Marketplace | Der Katalog installierbarer Primitive: Workflows, Scripts, Connectors und Bundles. Elemente können kostenlos oder kostenpflichtig sein und werden von verifizierten Erstellern veröffentlicht. | |
| MCP | Model Context Protocol — die Tool-Schnittstelle zwischen SupaCloud und dem Agentenprozess. Stellt supacloud.*-Tools auf vier Zugriffsebenen bereit (baseline, read, ops, deploy). |