task-manager/plan.md

# ADHS/ADS-Friendly Task Manager Enhancement Plan

> **Ziel**: Diese Anwendung zu einem führenden ADHS/ADS-freundlichen Task Manager machen, der die einzigartigen Herausforderungen neurodivergenter Menschen adressiert.

---

## Inhaltsverzeichnis

1. [Executive Summary](#executive-summary)
2. [Verständnis von ADHS/ADS](#verständnis-von-adhsads)
3. [Analyse bestehender Features](#analyse-bestehender-features)
4. [Feature-Roadmap](#feature-roadmap)
5. [Detaillierte Implementierungspläne](#detaillierte-implementierungspläne)
6. [Technische Architektur](#technische-architektur)
7. [UX/UI Design-Richtlinien](#uxui-design-richtlinien)
8. [Prioritäten und Phasen](#prioritäten-und-phasen)
9. [Quellen und Referenzen](#quellen-und-referenzen)

---

## Executive Summary

Menschen mit ADHS (Aufmerksamkeitsdefizit-Hyperaktivitätsstörung) und ADS (Aufmerksamkeitsdefizit-Störung) stehen vor einzigartigen Herausforderungen bei der Aufgabenverwaltung. Diese umfassen:

- **Zeitblindheit**: Schwierigkeiten bei der Wahrnehmung von Zeitabläufen
- **Exekutive Dysfunktion**: Probleme beim Planen, Priorisieren und Starten von Aufgaben
- **Dopamin-Defizit**: Geringere Motivation für Aufgaben ohne sofortige Belohnung
- **Hyperfokus**: Unkontrolliertes Vertiefen in interessante Aufgaben unter Vernachlässigung anderer Pflichten
- **Task-Paralyse**: Lähmung durch Überforderung oder zu viele Optionen
- **Working-Memory-Defizite**: Schwierigkeiten, Informationen im Kurzzeitgedächtnis zu halten

Diese Analyse zeigt, dass der bestehende Task-Manager bereits ein **solides Fundament** mit Gamification, Timer, AI-Integration und Routinen bietet. Mit gezielten Erweiterungen kann er zu einem **Best-in-Class ADHS-Tool** entwickelt werden.

---

## Verständnis von ADHS/ADS

### Kernherausforderungen

#### 1. Zeitblindheit (Time Blindness)
> "ADHD is fundamentally a disorder of time management" — Dr. Russell Barkley

Menschen mit ADHS haben oft eine verzerrte Zeitwahrnehmung:
- Schwierigkeiten, die Dauer von Aufgaben einzuschätzen
- "Jetzt" ist der einzige wahrgenommene Zeitpunkt
- Schwierigkeiten bei der Planung zukünftiger Aktivitäten

**Lösung**: Visuelle Timer, Zeitblöcke, Echtzeit-Feedback

#### 2. Exekutive Dysfunktion & Task-Paralyse
> "Task paralysis often occurs involuntarily—unlike procrastination, which is usually a choice."

Betroffene erleben:
- Überwältigung bei großen oder komplexen Aufgaben
- Entscheidungslähmung bei zu vielen Optionen (Hick's Law)
- Schwierigkeiten beim Starten von Aufgaben

**Lösung**: Task-Breakdown, 5-Minuten-Regel, klare Priorisierung, reduzierte Optionen

#### 3. Dopamin & Motivation
> "Studies suggest people with ADHD have lower levels of dopamine, making it challenging to stay motivated for tasks without immediate rewards."

Das ADHS-Gehirn:
- Hat geringere Dopamin-Produktion und -Rezeptoren
- Braucht externe Motivation und Belohnungen
- Reagiert stark auf sofortiges Feedback

**Lösung**: Gamification, Mikro-Belohnungen, Progress-Visualisierung, Streaks

#### 4. Hyperfokus-Management
> "Hyperfocus is a double-edged sword—it can unlock deep creativity but also lead to burnout and neglected responsibilities."

Risiken bei unkontrolliertem Hyperfokus:
- Überspringen von Mahlzeiten und Pausen
- Vernachlässigung anderer Aufgaben
- Burnout und Erschöpfung

**Lösung**: Break-Reminders, Zeitlimits, sanfte Unterbrechungen

#### 5. Kognitive Überlastung
> "Excess visual clutter can lead to cognitive overload."

ADHS-Gehirne sind besonders anfällig für:
- Visuelle Ablenkungen
- Zu viele Optionen gleichzeitig
- Komplexe Interfaces

**Lösung**: Clean UI, Progressive Disclosure, Focus Mode

---

## Analyse bestehender Features

### Stärken des aktuellen Systems

| Feature | ADHS-Relevanz | Status |
|---------|---------------|--------|
| **Gamification (XP/Level)** | ⭐⭐⭐⭐⭐ Dopamin-Boost | ✅ Vorhanden |
| **Streak-Tracking** | ⭐⭐⭐⭐⭐ Konsistenz-Motivation | ✅ Vorhanden |
| **Pomodoro Timer** | ⭐⭐⭐⭐⭐ Zeitstruktur | ✅ Vorhanden |
| **Focus Mode** | ⭐⭐⭐⭐ Ablenkungsreduktion | ✅ Vorhanden |
| **Morning/Evening Routines** | ⭐⭐⭐⭐ Struktur | ✅ Vorhanden |
| **AI Task Assistant** | ⭐⭐⭐⭐ Task-Breakdown möglich | ✅ Vorhanden |
| **Achievements** | ⭐⭐⭐⭐ Positive Verstärkung | ✅ Vorhanden |
| **Time Tracking** | ⭐⭐⭐⭐ Zeitbewusstsein | ✅ Vorhanden |
| **Notifications** | ⭐⭐⭐ Erinnerungen | ✅ Vorhanden |
| **Dark Mode** | ⭐⭐⭐ Reduzierte Stimulation | ✅ Vorhanden |
| **Subtasks** | ⭐⭐⭐ Task-Breakdown | ✅ Vorhanden |
| **Recurring Tasks** | ⭐⭐⭐ Routine-Aufbau | ✅ Vorhanden |
| **Energy Level** | ⭐⭐⭐ Selbstwahrnehmung | ✅ Vorhanden |
| **Estimated Duration** | ⭐⭐⭐ Zeitplanung | ✅ Vorhanden |
| **German Language** | ⭐⭐⭐ Lokalisierung | ✅ Vorhanden |

### Verbesserungspotenzial

| Feature | ADHS-Relevanz | Status |
|---------|---------------|--------|
| **Visueller Timer** | ⭐⭐⭐⭐⭐ Time Blindness | ❌ Fehlt |
| **AI Task-Breakdown** | ⭐⭐⭐⭐⭐ Executive Function | 🔄 Erweiterbar |
| **ADHS-Modus** | ⭐⭐⭐⭐⭐ Ganzheitliche Lösung | ❌ Fehlt |
| **Break Reminders** | ⭐⭐⭐⭐⭐ Hyperfokus-Schutz | ❌ Fehlt |
| **Dopamin-Menu** | ⭐⭐⭐⭐⭐ Sofortige Belohnungen | ❌ Fehlt |
| **Body Doubling** | ⭐⭐⭐⭐ Accountability | ❌ Fehlt |
| **Task Starter** | ⭐⭐⭐⭐ 5-Minuten-Regel | ❌ Fehlt |
| **Prioritätsfilter** | ⭐⭐⭐⭐ Fokus-Hilfe | 🔄 Erweiterbar |
| **Positive Affirmationen** | ⭐⭐⭐⭐ Selbstwert | ❌ Fehlt |
| **Visuelle Zeitleiste** | ⭐⭐⭐⭐ Tagesübersicht | 🔄 Erweiterbar |
| **Smart Single-Task View** | ⭐⭐⭐⭐ Reduzierte Überforderung | ❌ Fehlt |
| **Ambient Sounds** | ⭐⭐⭐ Fokus-Unterstützung | 🔄 Vorhanden (erweitern) |

---

## Feature-Roadmap

### Phase 1: Kern-ADHS-Features (Priorität: Hoch)

1. **ADHS-Modus (Global Toggle)**
2. **Visueller Timer mit Zeitanzeige**
3. **AI-gestützter Task-Breakdown**
4. **Break-Reminder-System**
5. **"Quick Win" Dopamin-Menu**
6. **Single-Task Focus View**

### Phase 2: Erweiterte Unterstützung (Priorität: Mittel)

7. **Body Doubling Integration**
8. **5-Minuten Task Starter**
9. **Positive Affirmationen & Encouragement**
10. **Verbesserte Gamification**
11. **Hyperfokus-Schutz**
12. **Energy-Based Scheduling**

### Phase 3: Personalisierung & Feintuning (Priorität: Normal)

13. **Personalisierte ADHS-Profile**
14. **Detaillierte Analytics für ADHS**
15. **Community & Social Features**
16. **Erweiterte AI-Coaching**
17. **Accessibility-Verbesserungen**

---

## Detaillierte Implementierungspläne

### 1. ADHS-Modus (Global Toggle)

**Konzept**: Ein zentraler Schalter, der die gesamte App für ADHS-Bedürfnisse optimiert.

**Änderungen bei Aktivierung**:
- Reduzierte UI-Komplexität
- Größere Buttons und Targets
- Weniger Animationen
- Automatische Break-Reminders
- Single-Task-Fokus als Standard
- Vereinfachte Navigation
- Positive Messaging statt Guilt-Triggers

**Betroffene Dateien**:
```
/shared/schema.ts
  - users Tabelle: Feld `adhdMode: boolean` hinzufügen
  - users Tabelle: Feld `adhdSettings: jsonb` für granulare Einstellungen

/client/src/components/AppSidebar.tsx
  - ADHS-Modus Toggle im Sidebar-Header
  - Visuelles Indikator wenn aktiv

/client/src/pages/settings.tsx
  - Neue Sektion "ADHS-Einstellungen"
  - Granulare Konfiguration:
    - Reduzierte Animationen
    - Größere Touch-Targets
    - Break-Reminder Intervall
    - Single-Task-Modus Standard
    - Positive Messaging Level

/client/src/App.tsx
  - ADHS-Context Provider
  - CSS-Klasse auf Root für globale Styles

/client/src/index.css
  - ADHS-spezifische CSS-Variablen
  - .adhd-mode Klasse mit angepassten Styles
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── ADHDModeProvider.tsx      # Context für ADHS-Einstellungen
  ├── ADHDModeToggle.tsx        # Toggle-Button
  ├── ADHDSettingsPanel.tsx     # Einstellungs-Panel
  └── useADHDMode.ts            # Custom Hook
```

**API-Änderungen**:
```
PATCH /api/user/adhd-settings
  - Body: { adhdMode: boolean, settings: ADHDSettings }
```

---

### 2. Visueller Timer

**Konzept**: Ein großer, visuell ansprechender Timer, der die verbleibende Zeit als schrumpfenden Kreis oder Balken zeigt.

**Features**:
- Kreisförmiger Timer (wie Time Timer)
- Farbverlauf von Grün → Gelb → Rot
- Optionale Töne bei Meilensteinen (25%, 50%, 75%)
- Integration mit Pomodoro
- Vollbild-Option
- Ambient Sounds während Timer läuft

**Betroffene Dateien**:
```
/client/src/components/PomodoroOverlay.tsx
  - Erweitern um visuellen Timer-Ring
  - Farbverlauf-Animation
  - Milestone-Sounds

/client/src/components/FocusMode.tsx
  - Visuellen Timer einbinden
  - Optionale Vollbild-Ansicht
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── VisualTimer.tsx           # Haupt-Timer-Komponente
  ├── TimerRing.tsx             # SVG-basierter Ring
  ├── TimerProgress.tsx         # Fortschrittsanzeige
  └── TimerSounds.tsx           # Sound-Management
```

**Technische Details**:
```tsx
// VisualTimer.tsx - Kern-Struktur
interface VisualTimerProps {
  duration: number;          // Sekunden
  onComplete: () => void;
  onMilestone?: (percent: number) => void;
  colorScheme?: 'default' | 'calm' | 'energetic';
  showNumbers?: boolean;
  size?: 'small' | 'medium' | 'large' | 'fullscreen';
}

// SVG-basierter Ring mit CSS-Animation
// stroke-dasharray und stroke-dashoffset für Animation
// requestAnimationFrame für smooth Updates
```

**CSS-Variablen**:
```css
--timer-start-color: hsl(142, 76%, 36%);   /* Grün */
--timer-mid-color: hsl(45, 93%, 47%);       /* Gelb */
--timer-end-color: hsl(0, 84%, 60%);        /* Rot */
--timer-bg-color: hsl(0, 0%, 90%);
```

---

### 3. AI-gestützter Task-Breakdown

**Konzept**: Automatische Zerlegung überwältigender Aufgaben in kleine, machbare Schritte.

**Features**:
- "Diese Aufgabe ist zu groß" Button
- AI analysiert und schlägt Unteraufgaben vor
- Zeitschätzungen pro Unteraufgabe
- "Nächster Schritt" Highlight
- Integration mit bestehendem Subtask-System

**Betroffene Dateien**:
```
/server/ai.ts
  - Neuer System-Prompt für Task-Breakdown
  - Tool-Definition für Subtask-Erstellung

/server/routes.ts
  - Neuer Endpoint: POST /api/ai/breakdown-task

/client/src/components/TaskCard.tsx
  - "Aufgabe aufteilen" Button
  - Visuelles Indikator für "broken down" Tasks

/client/src/components/TaskDetailsModal.tsx
  - AI-Breakdown Panel
  - Subtask-Vorschau und Bestätigung
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── TaskBreakdownButton.tsx    # Trigger für AI-Breakdown
  ├── TaskBreakdownModal.tsx     # Modal mit Vorschlägen
  ├── BreakdownPreview.tsx       # Vorschau der Unteraufgaben
  └── QuickSubtask.tsx           # Schnelle Subtask-Erstellung
```

**AI-Prompt Template**:
```
Du bist ein ADHS-Coach. Der Nutzer hat eine überwältigende Aufgabe:

Aufgabe: "{taskTitle}"
Beschreibung: "{taskDescription}"
Geschätzte Dauer: {estimatedDuration} Minuten

Zerlege diese Aufgabe in 3-7 kleine, konkrete Schritte.
Jeder Schritt sollte:
- In 5-15 Minuten erledigt werden können
- Eine klare, aktionsorientierte Beschreibung haben
- Einen konkreten Endpunkt haben

Format:
1. [Schritt] - [Geschätzte Zeit in Minuten]
2. ...
```

**API-Response**:
```typescript
interface BreakdownResponse {
  subtasks: {
    title: string;
    estimatedMinutes: number;
    order: number;
  }[];
  totalEstimatedMinutes: number;
  encouragement: string;  // Positive Nachricht
}
```

---

### 4. Break-Reminder-System

**Konzept**: Sanfte, aber effektive Erinnerungen für Pausen, um Hyperfokus zu unterbrechen.

**Features**:
- Konfigurierbares Intervall (Standard: 45 Minuten)
- Sanfte visuelle Überlagerung (kein abruptes Popup)
- Vorschläge für Pause (Dehnen, Wasser, Snack)
- "Noch 5 Minuten" Option
- Automatische Pause-Protokollierung
- Integration mit Pomodoro

**Betroffene Dateien**:
```
/shared/schema.ts
  - users: breakReminderInterval, breakReminderEnabled

/client/src/hooks/
  - Neuer Hook: useBreakReminder.ts

/client/src/components/FocusMode.tsx
  - Break-Reminder Integration

/client/src/App.tsx
  - Global Break-Reminder Provider
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── BreakReminderProvider.tsx  # Context und Timer-Logik
  ├── BreakReminderOverlay.tsx   # Sanfte Überlagerung
  ├── BreakSuggestions.tsx       # Pausen-Vorschläge
  └── BreakHistory.tsx           # Pausen-Protokoll
```

**Break-Suggestions Array**:
```typescript
const breakSuggestions = [
  { id: 'stretch', icon: '🧘', de: 'Kurz dehnen', duration: 2 },
  { id: 'water', icon: '💧', de: 'Wasser trinken', duration: 1 },
  { id: 'walk', icon: '🚶', de: 'Kurzer Spaziergang', duration: 5 },
  { id: 'eyes', icon: '👀', de: '20-20-20 Augenübung', duration: 1 },
  { id: 'snack', icon: '🍎', de: 'Gesunder Snack', duration: 3 },
  { id: 'breathe', icon: '🌬️', de: 'Tiefes Atmen', duration: 2 },
];
```

**Overlay-Design**:
```
- Nicht modal (kein blockierendes Overlay)
- Sanfte Animation von der Seite
- Countdown bevor es verschwindet
- Dismiss durch Klick irgendwo
- "Snooze 5 Min" Button
- Farbverlauf-Hintergrund (beruhigend)
```

---

### 5. "Quick Win" Dopamin-Menu

**Konzept**: Eine Liste schneller, einfacher Aufgaben für sofortige Erfolgserlebnisse.

**Features**:
- Filtert Aufgaben < 10 Minuten
- Sortiert nach "Schnell erledigt" Score
- Sofortiger XP-Boost sichtbar
- Celebration bei Erledigung
- "Keine Lust auf nichts?" Modus

**Betroffene Dateien**:
```
/client/src/components/AppSidebar.tsx
  - "Quick Win" Button/Link

/client/src/pages/
  - Neue Seite: QuickWinsPage.tsx

/server/routes.ts
  - Neuer Endpoint: GET /api/tasks/quick-wins
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── QuickWinButton.tsx         # Sidebar-Button mit Sparkle
  ├── QuickWinList.tsx           # Liste der Quick Wins
  ├── QuickWinCard.tsx           # Einzelne Quick Win Karte
  └── CelebrationOverlay.tsx     # Erfolgs-Animation
```

**Quick Win Score Berechnung**:
```typescript
function calculateQuickWinScore(task: Task): number {
  let score = 100;

  // Kürzere Aufgaben = höherer Score
  if (task.estimatedDuration) {
    score += (15 - task.estimatedDuration) * 5;
  }

  // Niedrigere Priorität = schneller erledigt
  if (task.priority === 'low') score += 20;

  // Heute fällig = Bonus
  if (isToday(task.dueDate)) score += 30;

  // Bereits gestartet = Bonus
  if (task.status === 'inProgress') score += 40;

  // Hat Subtasks erledigt = Bonus
  // ...

  return score;
}
```

**UI-Design**:
```
- Karten-Layout mit großen Touch-Targets
- Sichtbare XP-Belohnung vor Erledigung
- Confetti bei Erledigung
- Streak-Counter für Quick Wins
- "Nächster Quick Win" Vorschlag
```

---

### 6. Single-Task Focus View

**Konzept**: Eine Ansicht, die nur EINE Aufgabe zeigt, um Überforderung zu vermeiden.

**Features**:
- Zeigt nur die aktuell fokussierte Aufgabe
- Große, klare Typografie
- Timer-Integration
- "Nächste Aufgabe" Button
- Kein Scrollen, keine Liste
- Optional: Ambient Background

**Betroffene Dateien**:
```
/client/src/components/FocusMode.tsx
  - Erweitern um Single-Task-View

/client/src/App.tsx
  - Route für Single-Task-View
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── SingleTaskView.tsx         # Haupt-Komponente
  ├── SingleTaskCard.tsx         # Große Task-Karte
  ├── TaskNavigator.tsx          # Prev/Next Navigation
  └── AmbientBackground.tsx      # Optional: Animierter Hintergrund
```

**Layout**:
```
┌─────────────────────────────────────────┐
│                                         │
│           [Visueller Timer]             │
│                                         │
│  ┌───────────────────────────────────┐  │
│  │                                   │  │
│  │         AUFGABE TITEL             │  │
│  │         (große Schrift)           │  │
│  │                                   │  │
│  │    Beschreibung hier...           │  │
│  │                                   │  │
│  │    [✓ Erledigt]  [→ Überspringen] │  │
│  │                                   │  │
│  └───────────────────────────────────┘  │
│                                         │
│     ○ ● ○ ○ ○  (Task-Indikator)        │
│                                         │
└─────────────────────────────────────────┘
```

---

### 7. Body Doubling Integration

**Konzept**: Virtuelle Arbeitspartner für Accountability.

**Features**:
- "Work With Me" Sessions
- Timer-synchronisierte Sessions
- Anonyme oder Named Sessions
- Session-Typen (Focus, Brainstorm, Admin)
- Integration mit externen Services (Focusmate API)

**Betroffene Dateien**:
```
/shared/schema.ts
  - Neue Tabellen: bodydoublingSessions, sessionParticipants

/server/routes.ts
  - CRUD für Sessions
  - WebSocket für Echtzeit-Updates

/client/src/pages/
  - Neue Seite: BodyDoublingPage.tsx
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── BodyDoublingLobby.tsx      # Session-Übersicht
  ├── SessionCard.tsx            # Einzelne Session
  ├── ActiveSession.tsx          # Laufende Session
  ├── SessionTimer.tsx           # Geteilter Timer
  └── ParticipantList.tsx        # Teilnehmer
```

**Optionale externe Integration**:
```typescript
// Integration mit Focusmate oder ähnlichen Services
interface ExternalBodyDouble {
  provider: 'focusmate' | 'flow-club' | 'custom';
  apiKey: string;
  syncEnabled: boolean;
}
```

---

### 8. 5-Minuten Task Starter

**Konzept**: Die "5-Minuten-Regel" als Feature - nur 5 Minuten an einer Aufgabe arbeiten.

**Features**:
- "Nur 5 Minuten" Button bei jeder Aufgabe
- Automatischer 5-Minuten Timer
- Nach 5 Minuten: "Weitermachen?" oder "Pause"
- Keine Verpflichtung weiterzumachen
- XP auch für 5 Minuten

**Betroffene Dateien**:
```
/client/src/components/TaskCard.tsx
  - "5 Min starten" Button

/client/src/components/TaskDetailsModal.tsx
  - Integration des 5-Min Starters
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── FiveMinuteStarter.tsx      # Start-Button
  ├── FiveMinuteTimer.tsx        # 5-Min Timer
  └── FiveMinuteComplete.tsx     # End-Dialog
```

**Flow**:
```
1. User klickt "5 Min starten"
2. Timer startet, Task wird "inProgress"
3. Visueller 5-Min Countdown
4. Nach 5 Min: Sanfter Gong
5. Dialog: "Super! Weitermachen?"
   - [Ja, weiter] → Timer läuft weiter
   - [Pause machen] → Task bleibt inProgress
   - [Fertig!] → Task wird "done"
6. XP wird gutgeschrieben (minimum 10 XP)
```

---

### 9. Positive Affirmationen & Encouragement

**Konzept**: Ersetzen von Guilt-Triggern durch positive, ermutigende Nachrichten.

**Features**:
- Positive Nachrichten bei Task-Completion
- Ermutigungen bei langen Pausen
- Keine "Du hast X Tage nicht..." Nachrichten
- Personalisierbare Affirmationen
- Integration mit Notifications

**Betroffene Dateien**:
```
/client/src/i18n/locales/de.json
  - Neue Sektion: "encouragements"

/client/src/i18n/locales/en.json
  - Neue Sektion: "encouragements"

/client/src/hooks/use-notifications.ts
  - Positive Messaging Integration

/client/src/components/TaskCard.tsx
  - Ermutigungen bei Completion
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── EncouragementToast.tsx     # Positive Toast-Nachricht
  ├── DailyAffirmation.tsx       # Tägliche Affirmation
  └── ProgressCelebration.tsx    # Feier bei Meilensteinen
```

**Encouragement-Beispiele (Deutsch)**:
```typescript
const encouragements = {
  taskComplete: [
    "Großartig! Jeder Schritt zählt. 🌟",
    "Du machst das super! Weiter so!",
    "Ein Task weniger - du rockst das!",
    "Siehst du? Du kannst das! 💪",
  ],
  returning: [
    "Schön, dass du wieder da bist!",
    "Jeder Neustart ist ein Gewinn.",
    "Willkommen zurück! Lass uns loslegen.",
  ],
  struggling: [
    "Es ist okay, kleine Schritte zu machen.",
    "Du musst nicht alles auf einmal schaffen.",
    "Atme tief durch. Du schaffst das.",
  ],
  streakBroken: [
    "Streaks sind nur Zahlen. Du bist mehr als das.",
    "Morgen ist ein neuer Tag!",
    "Jeder Tag ist eine neue Chance.",
  ],
};
```

---

### 10. Verbesserte Gamification

**Konzept**: Erweiterung des bestehenden XP-Systems für ADHS-Bedürfnisse.

**Neue Features**:
- Mikro-XP für kleine Aktionen (Task öffnen: 1 XP, Timer starten: 2 XP)
- Tägliche Herausforderungen (nicht bestrafend)
- "Power-Ups" für schwierige Tage
- Visuelle XP-Animation bei jeder Aktion
- "Boss-Fights" für große Projekte

**Betroffene Dateien**:
```
/shared/schema.ts
  - Erweiterte xpEvents Typen
  - dailyChallenges Tabelle

/server/gamification.ts
  - Mikro-XP Logik
  - Daily Challenge Generator

/client/src/components/GamificationBar.tsx
  - Erweiterte Animationen
  - Mikro-XP Popups
```

**Neue XP-Events**:
```typescript
const microXpEvents = {
  OPEN_TASK: 1,
  START_TIMER: 2,
  ADD_NOTE: 3,
  COMPLETE_SUBTASK: 15,
  USE_AI_BREAKDOWN: 5,
  TAKE_BREAK: 10,
  RETURN_AFTER_BREAK: 5,
  FIVE_MINUTE_START: 10,
  COMPLETE_QUICK_WIN: 30,
};
```

---

### 11. Hyperfokus-Schutz

**Konzept**: Aktiver Schutz vor den negativen Auswirkungen von Hyperfokus.

**Features**:
- Zeitlimit pro Task (konfigurierbar)
- Automatische Warnungen bei Überschreitung
- "Andere Tasks warten" Reminder
- Meal-Time Reminders
- Bewegungs-Reminders

**Betroffene Dateien**:
```
/shared/schema.ts
  - users: hyperfocusProtection settings

/client/src/hooks/useTimer.ts
  - Hyperfokus-Tracking Integration
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── HyperfocusGuard.tsx        # Monitoring-Komponente
  ├── HyperfocusWarning.tsx      # Warnungs-Overlay
  └── HyperfocusSettings.tsx     # Einstellungen
```

---

### 12. Energy-Based Scheduling

**Konzept**: Aufgaben basierend auf dem Energielevel des Users planen.

**Features**:
- Tägliche Energie-Check-ins
- Task-Empfehlungen basierend auf Energie
- "Niedrige Energie" Aufgaben-Pool
- Automatische Neupriorisierung
- Integration mit bestehenden Energy Levels

**Betroffene Dateien**:
```
/shared/schema.ts
  - energyLogs Tabelle für Check-ins

/server/routes.ts
  - Energy-based Task Suggestions Endpoint

/client/src/components/
  - EnergyCheckIn.tsx bei Login/Morgen
```

**Neue Komponenten**:
```
/client/src/components/adhd/
  ├── EnergyCheckIn.tsx          # Energie-Abfrage
  ├── EnergyBasedSuggestions.tsx # Task-Vorschläge
  └── EnergyHistory.tsx          # Energie-Verlauf
```

**Energy-Task Matching**:
```typescript
interface EnergyTaskMatch {
  energyLevel: 'low' | 'medium' | 'high';
  recommendedTaskTypes: string[];
  avoidTaskTypes: string[];
}

const energyMatching: EnergyTaskMatch[] = [
  {
    energyLevel: 'low',
    recommendedTaskTypes: ['admin', 'organizing', 'review'],
    avoidTaskTypes: ['creative', 'complex', 'social'],
  },
  {
    energyLevel: 'medium',
    recommendedTaskTypes: ['routine', 'communication', 'planning'],
    avoidTaskTypes: ['complex', 'high-stakes'],
  },
  {
    energyLevel: 'high',
    recommendedTaskTypes: ['creative', 'complex', 'challenging'],
    avoidTaskTypes: [],
  },
];
```

---

## Technische Architektur

### Neue Datenbankfelder

```sql
-- users Tabelle Erweiterungen
ALTER TABLE users ADD COLUMN adhd_mode BOOLEAN DEFAULT false;
ALTER TABLE users ADD COLUMN adhd_settings JSONB DEFAULT '{}';
ALTER TABLE users ADD COLUMN break_reminder_interval INTEGER DEFAULT 45;
ALTER TABLE users ADD COLUMN break_reminder_enabled BOOLEAN DEFAULT true;
ALTER TABLE users ADD COLUMN hyperfocus_protection JSONB DEFAULT '{}';

-- Neue Tabellen
CREATE TABLE energy_logs (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  energy_level VARCHAR(10) NOT NULL,
  logged_at TIMESTAMP DEFAULT NOW(),
  notes TEXT
);

CREATE TABLE body_doubling_sessions (
  id SERIAL PRIMARY KEY,
  host_id INTEGER REFERENCES users(id),
  title VARCHAR(255),
  session_type VARCHAR(50),
  starts_at TIMESTAMP,
  duration_minutes INTEGER,
  max_participants INTEGER DEFAULT 5,
  is_public BOOLEAN DEFAULT true,
  created_at TIMESTAMP DEFAULT NOW()
);

CREATE TABLE session_participants (
  session_id INTEGER REFERENCES body_doubling_sessions(id),
  user_id INTEGER REFERENCES users(id),
  joined_at TIMESTAMP DEFAULT NOW(),
  PRIMARY KEY (session_id, user_id)
);

CREATE TABLE daily_challenges (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  challenge_type VARCHAR(50),
  target INTEGER,
  progress INTEGER DEFAULT 0,
  xp_reward INTEGER,
  date DATE,
  completed_at TIMESTAMP
);
```

### Neue API Endpoints

```
ADHD Mode:
  PATCH /api/user/adhd-settings

Break Reminders:
  GET  /api/user/break-stats
  POST /api/user/log-break

Quick Wins:
  GET  /api/tasks/quick-wins

Task Breakdown:
  POST /api/ai/breakdown-task

Body Doubling:
  GET  /api/sessions
  POST /api/sessions
  POST /api/sessions/:id/join
  POST /api/sessions/:id/leave

Energy:
  POST /api/energy/log
  GET  /api/energy/history
  GET  /api/tasks/energy-based

Daily Challenges:
  GET  /api/challenges/today
  POST /api/challenges/:id/progress
```

### Neue React Context Provider

```tsx
// ADHDModeContext
interface ADHDModeContextType {
  isEnabled: boolean;
  settings: ADHDSettings;
  toggle: () => void;
  updateSettings: (settings: Partial<ADHDSettings>) => void;
}

// BreakReminderContext
interface BreakReminderContextType {
  isActive: boolean;
  minutesSinceBreak: number;
  logBreak: () => void;
  snooze: (minutes: number) => void;
}
```

### Ordnerstruktur für ADHD-Features

```
/client/src/components/adhd/
  ├── index.ts                   # Exports
  ├── providers/
  │   ├── ADHDModeProvider.tsx
  │   └── BreakReminderProvider.tsx
  ├── timer/
  │   ├── VisualTimer.tsx
  │   ├── TimerRing.tsx
  │   └── FiveMinuteStarter.tsx
  ├── focus/
  │   ├── SingleTaskView.tsx
  │   ├── HyperfocusGuard.tsx
  │   └── QuickWinList.tsx
  ├── ai/
  │   ├── TaskBreakdownModal.tsx
  │   └── BreakdownPreview.tsx
  ├── social/
  │   ├── BodyDoublingLobby.tsx
  │   └── SessionCard.tsx
  ├── feedback/
  │   ├── EncouragementToast.tsx
  │   ├── CelebrationOverlay.tsx
  │   └── ProgressCelebration.tsx
  └── settings/
      ├── ADHDSettingsPanel.tsx
      └── EnergyCheckIn.tsx
```

---

## UX/UI Design-Richtlinien

### Allgemeine Prinzipien für ADHS-freundliches Design

1. **Reduzierte kognitive Last**
   - Maximal 3-5 Optionen pro Ansicht
   - Progressive Disclosure für komplexe Features
   - Klare visuelle Hierarchie

2. **Große Touch-Targets**
   - Minimum 44x44px für alle interaktiven Elemente
   - Großzügiger Abstand zwischen Buttons

3. **Visuelles Feedback**
   - Sofortiges Feedback bei jeder Aktion
   - Animationen für Statusänderungen
   - Farbkodierung für Prioritäten

4. **Beruhigende Ästhetik**
   - Weniger gesättigte Farben im ADHS-Modus
   - Reduzierte Animationen Option
   - Mehr Whitespace

5. **Positive Sprache**
   - Keine Schuldzuweisungen
   - Ermutigende Formulierungen
   - Feier von Fortschritten

### Farbschema für ADHS-Modus

```css
:root.adhd-mode {
  /* Beruhigtere Primärfarben */
  --primary: 220 80% 55%;
  --primary-foreground: 0 0% 100%;

  /* Weniger intensive Akzentfarben */
  --accent: 190 60% 50%;

  /* Wärmerer Hintergrund */
  --background: 40 10% 97%;

  /* Größere Radii für weichere Erscheinung */
  --radius: 12px;

  /* Reduzierte Schatten */
  --shadow: 0 2px 8px rgba(0,0,0,0.05);
}
```

### Typografie-Anpassungen

```css
.adhd-mode {
  /* Größere Basisschrift */
  font-size: 17px;

  /* Mehr Zeilenabstand */
  line-height: 1.7;

  /* Task-Titel noch größer */
  .task-title {
    font-size: 1.3rem;
    font-weight: 600;
  }
}
```

### Animation-Richtlinien

```css
.adhd-mode {
  /* Längere, sanftere Übergänge */
  --transition-duration: 300ms;
  --transition-timing: ease-out;

  /* Reduzierte Bewegung Option */
  &.reduced-motion {
    * {
      animation: none !important;
      transition: none !important;
    }
  }
}
```

---

## Prioritäten und Phasen

### Phase 1: Fundament (Wochen 1-4)

| Feature | Aufwand | Impact | Priorität |
|---------|---------|--------|-----------|
| ADHS-Modus Toggle | Mittel | Hoch | 🔴 Kritisch |
| Visueller Timer | Mittel | Hoch | 🔴 Kritisch |
| Break Reminders | Niedrig | Hoch | 🔴 Kritisch |
| AI Task-Breakdown | Mittel | Hoch | 🔴 Kritisch |
| Positive Messaging | Niedrig | Mittel | 🟡 Wichtig |

**Deliverables Phase 1**:
- Funktionierender ADHS-Modus
- Visueller Timer in Focus Mode
- Automatische Break-Reminders
- AI-gestütztes Task-Breakdown
- Deutsche Lokalisierung aller neuen Features

### Phase 2: Erweiterung (Wochen 5-8)

| Feature | Aufwand | Impact | Priorität |
|---------|---------|--------|-----------|
| Quick Win Menu | Mittel | Hoch | 🟡 Wichtig |
| Single-Task View | Mittel | Hoch | 🟡 Wichtig |
| 5-Minuten Starter | Niedrig | Mittel | 🟡 Wichtig |
| Erweiterte Gamification | Mittel | Mittel | 🟡 Wichtig |
| Energy Check-ins | Niedrig | Mittel | 🟢 Nice-to-have |

**Deliverables Phase 2**:
- Quick Wins Seite
- Single-Task Focus View
- 5-Minuten Regel Integration
- Mikro-XP System
- Energy-based Suggestions

### Phase 3: Social & Personalisierung (Wochen 9-12)

| Feature | Aufwand | Impact | Priorität |
|---------|---------|--------|-----------|
| Body Doubling | Hoch | Mittel | 🟢 Nice-to-have |
| Hyperfokus-Schutz | Mittel | Mittel | 🟢 Nice-to-have |
| ADHS-Profile | Mittel | Mittel | 🟢 Nice-to-have |
| Detaillierte Analytics | Mittel | Niedrig | 🟢 Nice-to-have |
| Community Features | Hoch | Niedrig | 🟢 Nice-to-have |

**Deliverables Phase 3**:
- Body Doubling Sessions
- Hyperfokus-Warnungen
- Personalisierte ADHS-Profile
- ADHS-spezifische Analytics
- Optional: Community Features

---

## Quellen und Referenzen

### ADHS Task Management & Apps
- [Fluidwave: 12 Best Task Management Apps for ADHD](https://fluidwave.com/blog/best-task-management-app-for-adhd)
- [Tiimo: Visual Planner for ADHD](https://www.tiimoapp.com/)
- [Zapier: 5 To-Do List Apps That Work With ADHD](https://zapier.com/blog/adhd-to-do-list/)
- [Lunatask: Best ADHD Planner](https://lunatask.app/adhd)
- [FocusLane: Die ADHS App](https://counselingadhd.com/adhs-app/)
- [ZDF: Produktivität mit ADHS/ADS](https://www.zdfheute.de/ratgeber/adhs-ads-aufmerksamkeit-konzentration-pomodoro-timer-100.html)

### Zeitblindheit & Visuelle Timer
- [Time Timer: Visual Timer for ADHD](https://www.timetimer.com/pages/adhd)
- [Simply Psychology: ADHD & Time Blindness](https://www.simplypsychology.org/adhd-time-blindness.html)
- [Visual Timer Tools for ADHD](https://visualtimer.com/timers/visual-timers-for-adhd/)
- [Fhynix: Best ADHD Time Management Tools](https://fhynix.com/best-adhd-time-management-tools/)

### Task-Paralyse & Executive Function
- [ADD.org: ADHD Paralysis - 8 Ways to Overcome It](https://add.org/adhd-paralysis/)
- [Tiimo: ADHD Paralysis - How to Get Unstuck](https://www.tiimoapp.com/resource-hub/adhd-paralysis)
- [Choosing Therapy: 10 Tips for ADHD Paralysis](https://www.choosingtherapy.com/adhd-paralysis/)
- [NeuroSpark Health: Task Paralysis in Adults](https://neurosparkhealth.com/executive-functioning/task-paralysis-2)

### Body Doubling & Hyperfokus
- [Medical News Today: Body Doubling for ADHD](https://www.medicalnewstoday.com/articles/body-doubling-adhd)
- [Cleveland Clinic: How Body Doubling Helps](https://health.clevelandclinic.org/body-doubling-for-adhd)
- [Flow Club: Body Doubling](https://www.flow.club/what-is-body-doubling)
- [AuDHD Psychiatry: Breaking the Hyperfocus Cycle](https://www.audhdpsychiatry.co.uk/how-to-break-hyperfocus-cycle/)

### UI/UX Design für ADHS
- [Intuit Design Hub: ADHD and Design](https://design.intuit.com/adhd-and-design/)
- [AufaitUX: Neurodiversity in UX](https://www.aufaitux.com/blog/neuro-inclusive-ux-design/)
- [Din Studio: UI/UX for ADHD](https://din-studio.com/ui-ux-for-adhd-designing-interfaces-that-actually-help-students/)
- [UXPA: Designing for ADHD in UX](https://uxpa.org/designing-for-adhd-in-ux/)

### Gamification & Dopamin
- [Imaginovation: Gamification in ADHD Apps](https://imaginovation.net/blog/gamification-adhd-apps-user-retention/)
- [Moore Momentum: The ADHD Reward System](https://mooremomentum.com/blog/the-adhd-reward-system-and-why-you-struggle-with-motivation/)
- [ADHD Centre: Gamification for Focus](https://www.adhdcentre.co.uk/adhd-gamification-and-its-role-in-boosting-focus-and-learning/)
- [MagicTask: Gamified Task Management for ADHD](https://magictask.io/blog/gamified-task-management-adhd-focus-productivity/)

---

## Nächste Schritte

1. **Review dieses Plans** mit Stakeholdern
2. **Priorisierung** der Features basierend auf User-Feedback
3. **Technisches Design** für Phase 1 Features
4. **Prototyping** der ADHS-Mode UI
5. **User Testing** mit ADHS-Betroffenen
6. **Iterative Entwicklung** beginnend mit Phase 1

---

*Dokument erstellt: Januar 2026*
*Letzte Aktualisierung: Januar 2026*
*Version: 1.0*