mitai-jinkendo/.claude/docs/BACKLOG.md

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
• 📋 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

---

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

---

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"

---

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"

---

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
• Feature-Specs → .claude/docs/functional/*.md
• Strategische Planung → ROADMAP.md
• Versions-Übersicht → Diese Datei