mitai-jinkendo/.claude/docs/BACKLOG.md
Lars 7940dc7560 docs: Struktur .claude/docs versionieren, working/, Gitea-Index, Regeln
- .gitignore: .claude/docs, rules, commands tracken; settings.local weiter ignorieren
- DOCUMENTATION.md: verbindliche Ablage functional/technical/working/issues
- .claude/README.md: Agent-Einstieg; GITEA_ISSUES_INDEX aus MCP (Stand 2026-04-08)
- Arbeitspapiere von docs/ nach .claude/docs/working/ verschoben
- docs/MEMBERSHIP_SYSTEM.md als Stub; kanonisch technical/MEMBERSHIP_SYSTEM.md
- CLAUDE.md Pflichtlektüre und Links angepasst; docs/README.md vereinfacht

Made-with: Cursor
2026-04-08 13:01:49 +02:00

243 lines
9.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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