feat: Phase 1.5 - Flexible Goal System (DB-Registry) Part 1/2
KRITISCHE ARCHITEKTUR-ÄNDERUNG vor Phase 0b: Ermöglicht dynamische Goal Types ohne Code-Änderungen. Backend: - Migration 024: goal_type_definitions Tabelle → 8 existierende Typen als Seed-Data migriert → Flexible Schema: source_table, aggregation_method, calculation_formula → System vs. Custom Types (is_system flag) - goal_utils.py: Universal Value Fetcher → get_current_value_for_goal() ersetzt hardcoded if/elif chain → Unterstützt: latest, avg_7d, avg_30d, sum_30d, count_7d, etc. → Komplexe Formeln (lean_mass) via calculation_formula JSON - goals.py: CRUD API für Goal Type Definitions → GET /goals/goal-types (public) → POST/PUT/DELETE /goals/goal-types (admin-only) → Schutz für System-Types (nicht löschbar) - goals.py: _get_current_value_for_goal_type() delegiert zu Universal Fetcher Frontend: - api.js: 4 neue Funktionen (listGoalTypeDefinitions, create, update, delete) Dokumentation: - TODO_GOAL_SYSTEM.md: Phase 1.5 hinzugefügt, Roadmap aktualisiert Part 2/2 (nächster Commit): - Frontend: Dynamic Goal Types Dropdown - Admin UI: Goal Type Management Page - Testing Warum JETZT (vor Phase 0b)? - Phase 0b Platzhalter (120+) nutzen Goals für Score-Berechnungen - Flexible Goals → automatisch in Platzhaltern verfügbar - Später umbauen = Doppelarbeit (alle Platzhalter anpassen) Zukünftige Custom Goals möglich: - 🧘 Meditation (min/Tag) - 📅 Trainingshäufigkeit (x/Woche) - 📊 Planabweichung (%) - 🎯 Ritual-Adherence (%) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
1 parent
27a8af7008
commit
65ee5f898f
5 files changed
+835
-81
No files matched your search
+124
-6
@@ -24,9 +24,45 @@
|
||||
|
||||
## 🔲 Nächste Schritte (Priorität)
|
||||
|
||||
### Phase 0b: Goal-Aware Placeholders (NEXT - 16-20h)
|
||||
### Phase 1.5: Flexibles Goal System - DB-Registry (NEXT - 8-12h) 🆕
|
||||
|
||||
**Status:** 🔲 OFFEN
|
||||
**Status:** 🔲 IN ARBEIT
|
||||
**Priorität:** CRITICAL (blockt Phase 0b)
|
||||
**Aufwand:** 8-12h
|
||||
**Entscheidung:** 27.03.2026 - Option B gewählt
|
||||
|
||||
**Problem:**
|
||||
- Aktuelles System: Hardcoded goal types (nur 8 Typen möglich)
|
||||
- Jedes neue Ziel braucht Code-Änderung + Deploy
|
||||
- Zukünftige Ziele (Meditation, Rituale, Planabweichung) nicht möglich
|
||||
|
||||
**Lösung: DB-Registry**
|
||||
- Goal Types in Datenbank definiert
|
||||
- Admin UI: Neue Ziele ohne Code erstellen
|
||||
- Universal Value Fetcher (konfigurierbar)
|
||||
- User kann eigene Custom-Metriken definieren
|
||||
|
||||
**Tasks:**
|
||||
- [ ] Migration 024: goal_type_definitions Tabelle
|
||||
- [ ] Backend: Universal Value Fetcher (_fetch_latest, _fetch_avg, _fetch_count)
|
||||
- [ ] Backend: CRUD API für Goal Type Definitions
|
||||
- [ ] Frontend: Dynamisches Goal Types Dropdown
|
||||
- [ ] Admin UI: Goal Type Management Page
|
||||
- [ ] Seed Data: 8 existierende Typen migrieren
|
||||
- [ ] Testing: Alle Goals + Custom Goal erstellen
|
||||
|
||||
**Warum JETZT (vor Phase 0b)?**
|
||||
- Phase 0b Platzhalter nutzen Goals für Score-Berechnungen
|
||||
- Flexible Goals → automatisch in Platzhaltern verfügbar
|
||||
- Später umbauen = 120+ Platzhalter anpassen (Doppelarbeit)
|
||||
|
||||
**Dokumentation:** Siehe unten "Flexibles Goal System Details"
|
||||
|
||||
---
|
||||
|
||||
### Phase 0b: Goal-Aware Placeholders (NACH 1.5 - 16-20h)
|
||||
|
||||
**Status:** 🔲 WARTET AUF PHASE 1.5
|
||||
**Priorität:** HIGH (strategisch kritisch)
|
||||
**Aufwand:** 16-20h
|
||||
**Blockt:** Intelligente KI-Analysen
|
||||
@@ -98,11 +134,14 @@
|
||||
|-------|-----|--------|---------|
|
||||
| **Phase 0a** | Minimal Goal System | ✅ DONE | 3-4h |
|
||||
| **Phase 1** | Quick Fixes + Abstraction | ✅ DONE | 4-6h |
|
||||
| **Phase 0b** | Goal-Aware Placeholders | 🔲 NEXT | 16-20h |
|
||||
| **Phase 1.5** | 🆕 **Flexibles Goal System (DB-Registry)** | 🔲 IN ARBEIT | 8-12h |
|
||||
| **Phase 0b** | Goal-Aware Placeholders | 🔲 BLOCKED | 16-20h |
|
||||
| **Issue #49** | Prompt Page Assignment | 🔲 OPEN | 6-8h |
|
||||
| **v2.0** | Redesign (Focus Areas) | 📋 LATER | 8-10h |
|
||||
|
||||
**Total Roadmap:** ~37-48h bis vollständiges intelligentes Goal System
|
||||
**Total Roadmap:** ~45-60h bis vollständiges intelligentes Goal System
|
||||
|
||||
**KRITISCH:** Phase 1.5 MUSS vor Phase 0b abgeschlossen sein, sonst Doppelarbeit!
|
||||
|
||||
---
|
||||
|
||||
@@ -140,5 +179,84 @@ get_focus_weights(conn, profile_id)
|
||||
|
||||
---
|
||||
|
||||
**Letzte Aktualisierung:** 27. März 2026
|
||||
**Nächste Aktualisierung:** Nach Phase 0b Completion
|
||||
## 🔧 Flexibles Goal System - Technische Details
|
||||
|
||||
### Architektur: DB-Registry Pattern
|
||||
|
||||
**Vorher (Phase 0a/1):**
|
||||
```javascript
|
||||
// Frontend: Hardcoded
|
||||
const GOAL_TYPES = {
|
||||
weight: { label: 'Gewicht', unit: 'kg', icon: '⚖️' }
|
||||
}
|
||||
|
||||
// Backend: Hardcoded if/elif
|
||||
if goal_type == 'weight':
|
||||
cur.execute("SELECT weight FROM weight_log...")
|
||||
elif goal_type == 'body_fat':
|
||||
cur.execute("SELECT body_fat_pct FROM caliper_log...")
|
||||
```
|
||||
|
||||
**Nachher (Phase 1.5):**
|
||||
```sql
|
||||
-- Datenbank: Konfigurierbare Goal Types
|
||||
CREATE TABLE goal_type_definitions (
|
||||
type_key VARCHAR(50) UNIQUE,
|
||||
label_de VARCHAR(100),
|
||||
unit VARCHAR(20),
|
||||
icon VARCHAR(10),
|
||||
category VARCHAR(50),
|
||||
source_table VARCHAR(50),
|
||||
source_column VARCHAR(50),
|
||||
aggregation_method VARCHAR(20), -- latest, avg_7d, count_7d, etc.
|
||||
calculation_formula TEXT, -- JSON für komplexe Berechnungen
|
||||
is_system BOOLEAN -- System-Typen nicht löschbar
|
||||
);
|
||||
```
|
||||
|
||||
```python
|
||||
# Backend: Universal Fetcher
|
||||
def get_current_value_for_goal(conn, profile_id, goal_type):
|
||||
"""Liest Config aus DB, führt Query aus"""
|
||||
config = get_goal_type_config(conn, goal_type)
|
||||
|
||||
if config['calculation_formula']:
|
||||
return execute_formula(conn, profile_id, config['calculation_formula'])
|
||||
else:
|
||||
return fetch_by_method(
|
||||
conn, profile_id,
|
||||
config['source_table'],
|
||||
config['source_column'],
|
||||
config['aggregation_method']
|
||||
)
|
||||
```
|
||||
|
||||
```javascript
|
||||
// Frontend: Dynamisch
|
||||
const goalTypes = await api.getGoalTypeDefinitions()
|
||||
// Lädt aktuell verfügbare Typen von API
|
||||
```
|
||||
|
||||
### Vorteile:
|
||||
|
||||
**Flexibilität:**
|
||||
- ✅ Neue Ziele via Admin UI (KEIN Code-Deploy)
|
||||
- ✅ User kann Custom-Metriken definieren
|
||||
- ✅ Zukünftige Module automatisch integriert
|
||||
|
||||
**Beispiele neuer Ziele:**
|
||||
- 🧘 Meditation (min/Tag) → `meditation_log.duration_minutes`, avg_7d
|
||||
- 📅 Trainingshäufigkeit (x/Woche) → `activity_log.id`, count_7d
|
||||
- 📊 Planabweichung (%) → `activity_log.planned_vs_actual`, avg_30d
|
||||
- 🎯 Ritual-Adherence (%) → `rituals_log.completed`, avg_30d
|
||||
- 💤 Schlafqualität (%) → `sleep_log.quality_score`, avg_7d
|
||||
|
||||
**Integration mit Phase 0b:**
|
||||
- Platzhalter nutzen `get_current_value_for_goal()` → automatisch alle Typen verfügbar
|
||||
- Neue Ziele → sofort in KI-Analysen nutzbar
|
||||
- Keine Platzhalter-Anpassungen nötig
|
||||
|
||||
---
|
||||
|
||||
**Letzte Aktualisierung:** 27. März 2026 (Phase 1.5 gestartet)
|
||||
**Nächste Aktualisierung:** Nach Phase 1.5 Completion
|
||||
Reference in new issue
Block a user