# Mitai Jinkendo – Feature Backlog

Vollständige Übersicht aller geplanten Features nach Versionen.

**Dokumentationsstruktur:**
- 📚 `functional/` - Fachliche Specs (WAS wird gebaut)
- 📚 `technical/` - Technische Specs (WIE wird es gebaut)
- 🎯 **Konkrete Tasks & Issues** → [Gitea Issues](http://192.168.2.144:3000/Lars/mitai-jinkendo/issues)
- 📋 **Strategische Planung** → `ROADMAP.md`

**Aktueller Fokus:** v9d → v9e Transition (Ruhetage abgeschlossen, Vitalwerte in Arbeit, Entwicklungsrouten vorbereiten)

---

## v9c – Membership & Subscription ✅ KOMPLETT

📚 **Specs:** `technical/MEMBERSHIP_SYSTEM.md` (kombiniert fachlich + technisch)

**Deployed:** 21. März 2026 (Production)

### Features
- ✅ Feature-Enforcement-System (4-Phasen-Modell)
- ✅ Selbst-Registrierung mit E-Mail-Verifizierung
- ✅ Trial-System UI (Countdown-Banner mit 3 Urgency-Level)
- ✅ Tier-basiertes Zugriffsmanagement
- ✅ Coupons & Access-Grants
- ✅ Usage-Badges in allen relevanten Screens

**Bugfixes v9c:**
- ✅ BUG-001: TypeError in `/api/nutrition/weekly` (datetime.date handling)
- ✅ BUG-002: Ernährungs-Daten Tab fehlte
- ✅ BUG-003: Korrelations-Chart Extrapolation (gestrichelte Linien)
- ✅ BUG-004: Import-Historie Refresh (Force remount)
- ✅ BUG-005: Login → leere Seite
- ✅ BUG-006: Email-Verifizierung → leere Seite
- ✅ BUG-007: Doppelklick Verifizierungslink → generischer Fehler
- ✅ BUG-008: Dashboard infinite loading bei API-Fehlern

---

## v9d – Schlaf + Sport-Vertiefung

📚 **Specs:**
- `functional/SLEEP_MODULE.md` (Schlaf-Tracking)
- `functional/TRAINING_TYPES.md` (Trainingstypen + Abilities)
- `functional/DEVELOPMENT_ROUTES.md` (Routen-System, später v9e)

**Status:** 🟡 In Arbeit (Deployed: Schlaf, Trainingstypen, Ruhetage, Vitalwerte | Offen: HF-Zonen)

### Phase 1: Trainingstypen ✅ DEPLOYED (21.03.2026)
- ✅ 29 Trainingstypen in 7 Kategorien
- ✅ Lernendes Mapping-System (DB-basiert, Auto-Learning)
- ✅ 40+ Standard-Mappings (Deutsch + Englisch)
- ✅ Admin-UI für Trainingstypen-CRUD
- ✅ Admin-UI für Activity-Mappings (inline editing)
- ✅ TrainingTypeDistribution Chart in History
- ✅ Bulk-Kategorisierung (selbstlernend)
- ✅ Apple Health Import mit automatischem Mapping

### Phase 2a: Ruhetage ✅ DEPLOYED (23.03.2026)
- ✅ Multi-Dimensional Rest Days (Kraft, Cardio, Entspannung)
- ✅ Quick Mode Presets + Custom Entry
- ✅ Validierung gegen geplante Aktivitäten
- ✅ Dashboard Widget mit aktuellen Ruhetagen
- ✅ Multiple Rest Types pro Date

### Phase 2b: Schlaf-Modul ✅ DEPLOYED (23.03.2026)
- ✅ sleep_log Tabelle mit JSONB sleep_segments
- ✅ Schlafphasen (Deep, REM, Light, Awake)
- ✅ Apple Health CSV Import
- ✅ Schlaf-Statistiken & Trends
- ✅ Schlafschuld-Berechnung

### Phase 2d: Vitalwerte ✅ DEPLOYED (23.03.2026)
- ✅ **3-Tab Architektur:** Baseline (morgens) / Blutdruck (mehrfach täglich) / Import
- ✅ **Baseline Vitals:** Ruhepuls, HRV, VO2 Max, SpO2, Atemfrequenz
- ✅ **Blutdruck:** Systolisch/Diastolisch + Puls, WHO/ISH-Klassifizierung
- ✅ **Context-Tagging:** 8 Kontexte (nüchtern, nach Essen, Training, Stress, etc.)
- ✅ **Inline-Editing:** Alle Messungen direkt in der Liste bearbeitbar
- ✅ **Smart Upsert:** Baseline lädt existierende Einträge automatisch
- ✅ **CSV Import:** Omron (Deutsch) + Apple Health (Deutsch/Englisch)
- ✅ **Mobile-optimiert:** Volle Breite Felder, Sektions-Überschriften
- ✅ Unregelmäßiger Herzschlag & AFib-Warnungen
- ✅ Trend-Analyse (7d/14d/30d)

### Phase 2e: HF-Zonen + Erholung 🔲 OFFEN
- 🔲 HF-Zonen-Verteilung pro Training
- 🔲 Recovery Score basierend auf Ruhepuls + HRV + Schlaf
- 🔲 Übertraining-Warnung

**Migrations:**
- ✅ 004: training_types Tabelle + 23 Basis-Typen
- ✅ 005: Extended types (Gehen, Tanzen, Geist & Meditation)
- ✅ 006: abilities JSONB column (Platzhalter für v9f)
- ✅ 007: activity_type_mappings (lernendes System)
- ✅ 010: sleep_log Tabelle (JSONB segments)
- ✅ 011: rest_days Tabelle
- ✅ 012: Unique constraint rest_days
- ✅ 015: Vitals Refactoring (vitals_baseline + blood_pressure_log)

**Bugfixes v9d (23.03.2026):**
- ✅ Import-Zählung korrigiert (skipped vs. updated)
- ✅ Deutsche Spaltennamen für CSV-Imports
- ✅ Dezimalwerte-Parsing (safe_int/safe_float)
- ✅ Error-Details in Import-Response

---

## v9e – Entwicklungsrouten & Wochenplanung ⭐ NEU

📚 **Specs:** `functional/DEVELOPMENT_ROUTES.md`

**Status:** 🔲 Geplant (Spezifikation vorhanden, nach v9d Phase 2)

### Geplante Features
- 🔲 **6 Entwicklungsrouten:** Kraft, Kondition, Mental, Koordination, Mobilität, Technik
- 🔲 Activity-Types → Routen-Zuordnung (training_types.route Spalte)
- 🔲 Multi-Route Rest Day Validation (Konflikt-Check für alle Routen)
- 🔲 Wochenplanung: Routen-basierte Soll/Ist-Übersicht
- 🔲 Regel-Engine: Auto-Ruhetag bei Poor Recovery
- 🔲 Dashboard: Route-Balance Widget

**Tracking:** Siehe [Gitea Milestone v9e](http://192.168.2.144:3000/Lars/mitai-jinkendo/milestones)

---

## v9f – Ziele & KI-Prompts

📚 **Specs:**
- `functional/GOALS_VITALS.md` (Ziele-System)
- `functional/AI_PROMPTS.md` (KI-Prompt-Flexibilisierung)

**Status:** 🔲 Geplant (nach Phase 0 Infrastruktur)

### Ziele-System
- 🔲 Primärziele (Gewichtsabnahme, Muskelaufbau, Kondition, Wettkampf)
- 🔲 Ziel-spezifische Dashboard-Ansicht
- 🔲 Fortschrittsbalken & Prognose (lineare Regression)
- 🔲 KI-Integration: Ziel-Abgleich & Handlungsempfehlungen

### KI-Prompt Flexibilisierung
- 🔲 Prompt-Bibliothek mit Kategorien
- 🔲 Platzhalter-Browser (kategorisiert + Beispielwerte)
- 🔲 Prompt-Vorschau mit echten Daten
- 🔲 Pipeline konfigurierbar (Module, Gewichtung, Zeitraum)
- 🔲 Mehrere Pipeline-Konfigurationen speichern

### Vitalwerte erweitert
- 🔲 Erweiterte Vitalwerte (SpO2, Körpertemperatur, Atemfrequenz) - teilweise in v9d implementiert
- 🔲 Hydration-Tracking
- 🔲 Medikamenten-Tracking

**Tracking:** Siehe ROADMAP.md Phase 0-2

---

## v9g – Habits & Meditation

📚 **Specs:**
- `functional/MEDITATION.md` (Meditation & Selbstwahrnehmung)
- `functional/DEVELOPMENT_ROUTES.md` (Habits pro Route)

**Status:** 🔲 Geplant (Spezifikation vorhanden)

### Geplante Features
- 🔲 **Habits pro Entwicklungsroute** (route_habits Tabelle)
- 🔲 Streak-Tracking pro Route (z.B. Mental: Meditation 🔥12 Tage)
- 🔲 Dashboard: Route-Habits Widget
- 🔲 Täglicher Check-in (Energie, Stimmung, Stress 1-5)
- 🔲 Meditationssessions erfassen (Dauer, Art)
- 🔲 Journal (Freitext täglich)
- 🔲 Korrelations-Analysen (Meditation ↔ Stresslevel, Schlafqualität)
- 🔲 → Basis für **miken.jinkendo.de** (Meditations-App)

**Tracking:** Siehe [Gitea Milestone v9g](http://192.168.2.144:3000/Lars/mitai-jinkendo/milestones)

---

## v9h – Connectoren & Gamification

**Status:** 🔲 Konzept (keine Spezifikation vorhanden)

### Geplante Features
- 🔲 OAuth2-Grundgerüst
- 🔲 Strava, Withings, Garmin Integration
- 🔲 Bonus-System (Streaks → Punkte → Coupons)
- 🔲 Stripe-Integration (Zahlungsabwicklung)

---

## Responsive UI (parallel zu allen Versionen)

📚 **Specs:** `functional/RESPONSIVE_UI.md`

**Status:** 🔲 Geplant (parallel implementierbar)

### Geplante Features
- 🔲 Desktop: Sidebar Navigation
- 🔲 Tablet: 2-spaltige Cards
- 🔲 Mobile: Bottom Navigation (bleibt wie jetzt)
- 🔲 **Admin-Bereich separieren** (eigene Route `/admin`, nur für Admins)
  - Tab-basierte Struktur: Benutzerverwaltung, Feature-Limits, System-Settings, Coupons, AI-Prompts
  - Settings-Page: Nur noch persönliche Einstellungen

**Tracking:** Siehe [Gitea Issues mit Label "responsive"](http://192.168.2.144:3000/Lars/mitai-jinkendo/issues?labels=responsive)

---

## UX-Verbesserungen & Quick Wins

**Status:** Verschiedene kleine Verbesserungen, siehe Gitea Issues

**Beispiele:**
- Keyboard Shortcuts (Enter für Submit, Esc für Cancel)
- Toast-Notifications statt confirm() Dialoge
- Loading-States bei langsamen API-Calls
- Mehrere Fotos pro Tag hochladen (aktuell nur 1 Foto/Tag)
- Fotos löschbar machen (aktuell keine Delete-Funktion)

📋 **Tracking:** [Gitea Issues mit Label "ux" oder "quick-win"](http://192.168.2.144:3000/Lars/mitai-jinkendo/issues?labels=ux,quick-win)

---

## Versions-Übersicht (Zusammenfassung)

| Version | Status | Kernfeatures | Deployed |
|---------|--------|--------------|----------|
| **v9c** | ✅ KOMPLETT | Membership, Feature-Enforcement, Trial-System | 21.03.2026 |
| **v9d** | 🟡 In Arbeit | Schlaf, Trainingstypen, Ruhetage, Vitalwerte | 23.03.2026 (partial) |
| **v9e** | 🔲 Geplant | Development Routes, Wochenplanung | TBD |
| **v9f** | 🔲 Geplant | Ziele, KI-Prompts, Charts | TBD |
| **v9g** | 🔲 Geplant | Habits, Meditation, Streaks | TBD |
| **v9h** | 🔲 Konzept | Connectoren, Gamification, Stripe | TBD |

---

**Dokumentiert:** 23. März 2026 (Initial) · 24. März 2026 (Konsolidiert)
**Tracking:**
- Konkrete Issues → [Gitea](http://192.168.2.144:3000/Lars/mitai-jinkendo/issues)
- Feature-Specs → `.claude/docs/functional/*.md`
- Strategische Planung → `ROADMAP.md`
- Versions-Übersicht → Diese Datei