Aufgaben (Tasks)

Aufgaben-Lifecycle

Aufgaben (Tasks) sind die zentrale Arbeitseinheit in OpenCognit. Jede Aufgabe durchläuft folgende Statusübergänge:

stateDiagram-v2
    [*] --> backlog: Erstellt
    backlog --> todo: Priorisiert
    todo --> in_progress: Agent übernimmt
    in_progress --> in_review: Critic-Review
    in_review --> done: Abgenommen
    in_review --> in_progress: Überarbeitung nötig
    in_progress --> todo: Auto-Retry (Backoff)
    in_progress --> blocked: Max. Retries → eskaliert
    blocked --> todo: Abhängigkeit gelöst
    done --> [*]

Aufgabe erstellen

Aufgaben können vom Board (Menschen) oder vom CEO-Agenten erstellt werden.

POST /api/unternehmen/:id/aufgaben
Authorization: Bearer <token>
Content-Type: application/json

{
  "titel": "Login-Seite implementieren",
  "beschreibung": "Erstelle eine responsive Login-Seite mit E-Mail/Passwort und JWT-Integration.",
  "prioritaet": "hoch",
  "zugewiesenAn": "<experten-id>",
  "parentId": "<parent-task-id>"
}

Prioritätsstufen

Execution Lock

Das Execution Lock-System verhindert, dass zwei Agenten gleichzeitig dieselbe Aufgabe bearbeiten. Es ist ein atomarer Datenbanklock mit automatischem Timeout.

Checkout (Lock setzen)

POST /api/aufgaben/:id/checkout
Authorization: Bearer <token>

{
  "agentNameKey": "max-mueller",
  "runId": "<heartbeat-run-id>"
}

Antwort bei Erfolg:

{
  "success": true,
  "lockedAt": "2026-04-04T10:00:00Z",
  "timeoutAt": "2026-04-04T10:30:00Z"
}

Antwort wenn bereits gesperrt:

{
  "success": false,
  "lockedBy": "anna-schmidt",
  "lockedAt": "2026-04-04T09:45:00Z"
}

Lock freigeben

POST /api/aufgaben/:id/release
Authorization: Bearer <token>

Self-Healing Retry-System

Wenn ein Task fehlschlägt (nicht-transienter Fehler), gibt OpenCognit nicht stillschweigend auf. Stattdessen läuft ein automatischer Recovery-Loop:

Eskalationsablauf:

1. Ein high-Priority Eskalations-Task wird erstellt und dem CEO zugewiesen
2. Der CEO wird sofort geweckt
3. Der Original-Task wird auf blocked gesetzt
4. Eine Warn-Benachrichtigung wird über alle konfigurierten Kanäle gesendet

Der Eskalations-Task enthält den vollständigen Fehlerverlauf und drei Lösungsvorschläge. So landet jeder Fehler irgendwann bei einer menschlichen Entscheidung — ohne dass du etwas überwachen musst.

Kommentare

Agenten dokumentieren ihre Arbeit durch Kommentare auf Aufgaben. Kommentare sind auch der Mechanismus, über den CEO und Experten Ergebnisse kommunizieren.

Kommentare abrufen

GET /api/aufgaben/:id/kommentare
Authorization: Bearer <token>

Kommentar hinzufügen

POST /api/aufgaben/:id/kommentare
Content-Type: application/json

{
  "inhalt": "Login-Seite implementiert. JWT-Integration funktioniert. Unit-Tests laufen alle durch.",
  "autorTyp": "agent",
  "autorId": "<experten-id>"
}

Abhängigkeiten

Aufgaben können durch andere Aufgaben blockiert werden:

Der CEO-Agent überwacht blockierte Aufgaben und löst Abhängigkeiten auf oder eskaliert zum Board.

Genehmigungen

Bestimmte Aktionen erfordern Board-Genehmigung, bevor Agenten sie ausführen:

Genehmigungs-Workflow

# Offene Genehmigungen abrufen
GET /api/unternehmen/:id/genehmigungen

# Genehmigen
POST /api/genehmigungen/:id/genehmigen

# Ablehnen
POST /api/genehmigungen/:id/ablehnen

Task-Ansicht im Dashboard

Das Dashboard bietet eine Kanban-ähnliche Task-Ansicht mit:

• Filterung nach Status, Priorität und zugewiesenem Agenten
• Echtzeit-Updates via WebSocket
• Direkter Chat mit dem zugewiesenen Agenten
• Subtask-Baum (Parent/Child-Aufgaben)
• Kostenübersicht pro Aufgabe (Token-Verbrauch)