docs: add comprehensive technical wiki documentation and flaws analysis; remove legacy BRAIN.md

Doku/modules/triage.md

@@ -0,0 +1,88 @@
+# 📥 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
+
+```mermaid
+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`](../../frontend/src/features/capture/InstantCaptureBar.tsx)) sowie im mobilen Triage-Modal ([`App.tsx`](../../frontend/src/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.