docs: rewrite documentation and README from current codebase, add flaw analysis

Remove outdated claims (CRDT, DocRooms, presence, .md files on disk) and
document the actual architecture, API, permissions and known flaws.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Doku/modules/tasks.md

@@ -1,86 +1,38 @@
-# 📋 Kernmodul 2: Aufgaben & Kanban-System
+# Modul: Aufgaben, Kanban & Alarme
 
-Das Aufgaben-Modul ([`TasksView.tsx`](../../frontend/src/features/triage/TasksView.tsx)) bietet eine flexible Aufgabenverwaltung mit frei konfigurierbaren Listen, Kanban-Boards, Subtask-Checklisten und einem automatisierten Multi-Channel Alarm-System.
+Code: [TasksView.tsx](../../frontend/src/features/triage/TasksView.tsx), [TaskDetailModal.tsx](../../frontend/src/features/triage/TaskDetailModal.tsx), [ManageColumnsModal.tsx](../../frontend/src/features/triage/ManageColumnsModal.tsx); Backend: `handleUpdateThought`, `handleReorderTasks`, `*TaskList*`-Handler, `startAlarmTicker`.
 
----
+## Datenmodell
 
-## 🗂️ 1. Datenmodell & Listen-Hierarchie
+Eine Aufgabe ist ein `thought` ([database.md](../database.md)) mit `kanbanStatus`, `priority` (`low`/`normal`/`high`/`urgent`), `dueDate` (nur Datum), `notes` (Markdown), `subtasks` (`[{id, title, isCompleted}]`), `tags`, `taskListId` und `sortOrder`. Aufgaben ohne Liste sind persönlich.
 
-Aufgaben basieren technisch auf der Tabelle **`thoughts`** in SQLite. Ein Eintrag gilt als Aufgabe, wenn `status = 'kept'` oder `(status = 'converted' AND converted_type = 'task')` zutrifft.
+## Ansichten
 
-```
-Benutzer (users)
-  └── Aufgabenlisten (task_lists)
-        ├── Eigene Listen (z.B. "Privat", "Homelab")
-        └── Mit Teams geteilte Listen (task_list_shares)
-              └── Aufgaben (thoughts)
-                    ├── Kanban-Status (todo, in_progress, done)
-                    ├── Priorität (low, normal, high, urgent)
-                    ├── Fälligkeitsdatum (dueDate)
-                    ├── Notizen (notes)
-                    └── Subtasks (JSON Array von Teilaufgaben)
-```
+- **Liste** mit Filtern (offen, erledigt, Papierkorb), Gruppierung (z. B. nach Status oder Fälligkeit), Sortierung und Hashtag-Filter.
+- **Kanban:** Spalten pro Liste frei konfigurierbar (Name, Farbe, „Erledigt“-Spalte). Standard: *Zu erledigen*, *In Bearbeitung*, *Wartet auf andere*, *Erledigt*. Eine Karte in eine „Erledigt“-Spalte zu ziehen setzt `isCompleted`.
+- Drag & Drop sortiert in der Liste und zwischen Spalten; ein Klick öffnet das Detail-Fenster (Titel, Status, Priorität, Fälligkeit mit Schnellwahl, Liste, Hashtags, Unteraufgaben mit Fortschrittsbalken, Notizen).
+- Aufgaben lassen sich in eine Notiz umwandeln („Als Notiz vertiefen“). Aufgaben aus Notiz-Checkboxen (`enhanced-task`) bleiben verknüpft: Abhaken wirkt in beide Richtungen (`SyncDocBlockAndTask`), „In Notiz öffnen“ springt zum Block.
 
-### Listen-Sharing & Avatar-Stack
-Aufgabenlisten können für Gruppen/Teams freigegeben werden. Ein Avatar-Stack im Listen-Header und in der Tab-Leiste visualisiert alle Mitglieder, die Zugriff auf die jeweilige Liste haben.
+## Aufgabenlisten und Freigabe
 
----
+- Jede Liste hat Eigentümer, Titel, Symbol, Farbe und eigene Kanban-Spalten.
+- Freigabe an Gruppen oder Benutzer über den Dialog `UnifiedShareModal` (Stufe pro Freigabe):
+  - **Bearbeiter:** darf Aufgaben anlegen, ändern, abhaken, verschieben, löschen sowie Liste umbenennen und Spalten ändern.
+  - **Leser:** sieht alles, kann nichts ändern. Der Server antwortet mit `403`; die Oberfläche blendet Eingaben aus und zeigt „Nur Lesen“.
+  - Gruppenmitglieder mit mehreren Wegen erhalten die höchste Stufe. Nur der Eigentümer legt Freigaben an oder entfernt sie und kann die Liste löschen.
+- Umsetzung: `Store.GetTaskListPermission` liefert `owner`/`editor`/`viewer`/`""`; `ensureTaskListWritable` schützt Schreibpfade.
+- Bekannte Lücken: [FLAW-03](../flaws.md) (Umsortieren per ID), [FLAW-06](../flaws.md) (Editor kann weiterteilen).
 
-## 🖥️ 2. Ansichten: Liste vs. Kanban-Board
+## Alarme
 
-Der Benutzer kann jederzeit nahtlos zwischen zwei Ansichten umschalten:
+Der Ticker läuft jede Minute ([architecture.md](../architecture.md)). Für offene Aufgaben mit `due_date <= heute` und `alarm_sent = 0` sendet er an die Kanäle des Aufgaben-**Eigentümers**:
 
-### 1. Kompakte Listenansicht
-- Optimiert für schnelles Abarbeiten und Tastatursteuerung.
-- Zeigt Checkbox, Titel, Prioritäts-Badge, Herkunfts-Pille (`Webhook`, `Diktat`), Fälligkeitsdatum und Subtask-Zähler (`2/5`).
-- 1-Klick-Prioritäts-Wechsel: Klick auf ein Badge rotiert durch die Prioritäten.
+| Kanal | Ziel | Konfiguration |
+|---|---|---|
+| E-Mail | `alarmEmail` (sonst Konto-Adresse) | SMTP aus Admin-Einstellungen oder Umgebung (Port 465 mit TLS wird direkt unterstützt, sonst STARTTLS über `smtp.SendMail`) |
+| Discord | Webhook-URL | Benutzereinstellungen |
+| Webhook | beliebige URL (JSON: `event`, `title`, `notes`, `dueDate`, `priority`, `timestamp`) | Benutzereinstellungen |
 
-### 2. Kanban-Board (Drag & Drop)
-- Standardmäßig 3 Spalten: **Zu erledigen** (`todo`), **In Arbeit** (`in_progress`) und **Erledigt** (`done`).
-- **Freie Spalten-Konfiguration:** Über das Spalten-Menü können Spalten umbenannt, farblich markiert oder neue Spalten hinzugefügt werden.
-- **Drag & Drop:** Aufgaben können per HTML5 Drag & Drop zwischen Spalten verschoben werden. Das Backend speichert die relative Position (`sort_order`) und den neuen `kanban_status` automatisch.
+Danach wird `alarm_sent = 1` gesetzt, sobald mindestens ein Kanal erfolgreich war.
 
----
-
-## 🎯 3. Prioritäten & Subtasks
-
-### 4-Stufen-Prioritätensystem
-Aufgaben unterstützen vier einheitliche Prioritätsstufen:
-- **Niedrig (`low`):** Dezent grau hinterlegt.
-- **Normal (`normal`):** Akzentfarbe.
-- **Wichtig (`high`):** Gelb hervorgehoben mit Warndreieck (`⚠️ Wichtig`).
-- **Dringend (`urgent`):** Rot pulsierend mit Flammen-Icon (`🔥 Dringend`).
-
-### Subtasks (Teilaufgaben)
-Jede Aufgabe kann eine hierarchische Checkliste von Subtasks enthalten:
-- Gespeichert als JSON in der Spalte `subtasks`.
-- Fortschrittsanzeige im Kartenkopf (z.B. `3/5 erledigt`).
-- Einzelnes Abhaken synchronisiert direkt in die Datenbank.
-
----
-
-## ⏰ 4. Multi-Channel Alarm-Scheduler
-
-MindSift enthält einen serverseitigen Hintergrund-Ticker in Go ([`internal/api/server.go`](../../internal/api/server.go)), der fällige Aufgaben proaktiv an externe Kanäle meldet.
-
-```mermaid
-flowchart TD
-    Ticker["Go Background Ticker (alle 30s)"] --> Query["SELECT thoughts WHERE due_date <= now + Vorwarnzeit AND alarm_sent = 0"]
-    Query --> CheckChannels{"Welche Kanäle sind beim User aktiv?"}
-    
-    CheckChannels -->|email| SendSMTP["E-Mail via SMTP versenden"]
-    CheckChannels -->|discord| SendDiscord["Discord Webhook POST"]
-    CheckChannels -->|webhook| SendCustom["Custom HTTP POST Webhook"]
-    
-    SendSMTP --> MarkSent["UPDATE thoughts SET alarm_sent = 1"]
-    SendDiscord --> MarkSent
-    SendCustom --> MarkSent
-```
-
-### Alarm-Konfiguration
-1. **Vorwarnzeit:** Einstellbar in Minuten (z.B. 15, 30, 60 Minuten vor Fälligkeit).
-2. **Kanal-Multi-Select:** Benutzer können beliebig viele Kanäle parallel aktivieren:
-   - **E-Mail:** Versand über den in den Admin-Einstellungen hinterlegten SMTP-Server.
-   - **Discord:** Benachrichtigung mit formatierter Embed-Karte in einen Discord-Kanal.
-   - **Eigener Webhook:** Beliebige HTTP POST JSON Endpunkte (z.B. Gotify, Ntfy, Home Assistant).
-3. **Schutz vor Doppel-Alarmen:** Sobald ein Alarm abgesetzt wurde, wird `alarm_sent = 1` gesetzt. Wird das Datum der Aufgabe später geändert, setzt der Server `alarm_sent = 0` automatisch zurück.
+Einschränkungen ([FLAW-12](../flaws.md)): Fälligkeiten haben keine Uhrzeit, `notifyBeforeMinutes` wird ignoriert, die Serverzeit gilt, und ein verschobener Termin löst nicht erneut aus. URLs werden nicht geprüft ([FLAW-05](../flaws.md)).