MindSift/Doku/modules/triage.md

📥 Kernmodul 1: Triage & Quick-Dump Engine

Das Triage-Modul von MindSift basiert auf dem Getting Things Done (GTD)-Prinzip. Es trennt die Erfassung von Gedanken strikt von der Entscheidung, was damit geschehen soll.

---

💡 1. Das 2-Phasen-Konzept

1. Phase 1: Schnelles Erfassen (Instant Dump)
   Ein Gedanke, ein Anruf, eine Idee oder ein Server-Alarm wird ohne Reibung erfasst. Der Benutzer muss in diesem Moment weder ein Projekt auswählen, noch Fälligkeitsdaten eingeben oder Ordner durchsuchen.
2. Phase 2: Fokussierte Triage (Inbox Zero)
   Zu einem späteren Zeitpunkt (z.B. morgens oder beim Feierabend) sichtet der Benutzer den Stapel im Triage-Deck Karte für Karte und trifft für jeden Eintrag eine eindeutige Entscheidung.

---

🔄 2. Triage State Machine

stateDiagram-v2
    [*] --> Capture: Gedanke erfasst (Desktop / Mobile / Webhook)
    
    Capture --> Inbox: Standard (status: 'inbox')
    Capture --> Task: Direkt als Aufgabe (target: 'task')
    Capture --> Document: Direkt als Notiz (target: 'document')
    Capture --> ListItem: Direkt auf Liste (target: 'list_item')

    state Inbox {
        [*] --> ActiveCard: Oben auf Stapel
        ActiveCard --> Skipped: Leertaste / Später (Ans Ende)
        Skipped --> ActiveCard
    }

    ActiveCard --> Discarded: Swipe links / H (Wegwerfen)
    ActiveCard --> Task: Swipe rechts / L (Als Aufgabe)
    ActiveCard --> TaskDated: T (Mit Fälligkeitsdatum)
    ActiveCard --> Document: D (In Notiz umwandeln)
    ActiveCard --> ListItem: Auf Liste schieben

    Discarded --> Trash: status: 'discarded'
    Task --> TasksModule: status: 'kept', converted: 'task'
    TaskDated --> TasksModule: status: 'kept', converted: 'task', dueDate
    Document --> WorkspaceModule: status: 'converted', converted: 'document'
    ListItem --> ListsModule: status: 'converted', converted: 'list_item'

---

🖐️ 3. Steuerung & Gesten (Mobile vs. Desktop)

Desktop-Bedienung (Tastatur-First)

• C oder /: Fokussiert sofort die Eingabeleiste oben im Header.
• Enter: Speichert den Gedanken sofort im Deck.
• ← oder H: Aktive Karte wegwerfen (discard).
• → oder L: Aktive Karte sofort zur Aufgabe machen (task).
• T: Datumsauswahl für Termin-Aufgabe öffnen.
• D: Aktive Karte in eine vollwertige Workspace-Notiz umwandeln.
• Leertaste: Karte überspringen und ans Ende des Stapels schieben („Später").

Mobile Bedienung (Touch & Swipe)

• Mittlerer Plus-Button (+): Öffnet das design-angeglichene Bottom-Sheet mit Spracheingabe, 4 Prioritäts-Buttons (Niedrig, Normal, Wichtig, Dringend) und Fälligkeitsdatum.
• Wischgeste nach links (Swipe Left): Roter Indikator erscheint, Karte wird verworfen.
• Wischgeste nach rechts (Swipe Right): Grüner Indikator erscheint, Karte wird sofort zur Aufgabe.
• Long-Press (Langes Drücken auf Karte): Öffnet das Schnell-Aktions-Menü (Auf Liste, Mit Termin, Als Notiz, Später).

---

🎙️ 4. Spracheingabe (Speech-to-Text)

In der Desktop-Schnelleingabeleiste (InstantCaptureBar.tsx) sowie im mobilen Triage-Modal (App.tsx) ist ein nativer Browser-Sprachassistent integriert:

• Verwendet die standardisierte SpeechRecognition bzw. webkitSpeechRecognition API.
• Erkennt Sprache auf Deutsch (lang: 'de-DE').
• Live-Transkription: Gesprochener Text wird in Echtzeit in das Textfeld eingefügt.
• Haptisches Feedback: Vibrieren beim Starten und Stoppen der Aufnahme.
• Markiert erfasste Gedanken automatisch mit dem Herkunfts-Attribut source: 'voice' (Diktat-Badge).

---

⚡ 5. Webhook-Ingestion & Smarthome-Pille

MindSift kann externe Alarme (Home Assistant, Zigbee2MQTT, n8n, Proxmox, Monitoring) automatisch ins Triage-Deck einspeisen:

Herkunftserkennung

1. Wird ein Gedanke über /api/v1/inbox mit X-API-Key oder über /api/v1/webhooks/ingest eingeliefert, setzt das Backend automatisch source = "webhook".
2. Im Frontend visualisiert die Triage-Karte eine dezente Webhook-Pille (<Webhook className="w-3 h-3 text-accent" /> Webhook).
3. Diese Kennzeichnung bleibt auch erhalten, wenn die Karte später zu einer Aufgabe umgewandelt wird.

Live-WebSocket Update

Nach erfolgreichem Ingest sendet der Server sofort ein TASK_CREATED Event über den WebSocket-Hub. Das geöffnete Triage-Deck fügt die neue Alarm-Karte sofort oben in den Stapel ein – ohne dass der Benutzer die Seite neu laden muss.