Lars/mitai-jinkendo
1
0
Fork 0
Code Issues 23 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

[FEAT] AI-Prompts Flexibilisierung (v9f) - Prompt-Bibliothek + Platzhalter-System #28

New Issue
Closed
opened 2026-03-23 21:45:56 +01:00 by Lars · 2 comments
Lars commented 2026-03-23 21:45:56 +01:00
Owner
Copy Link

�berblick

Das bestehende KI-Prompt-System wird von einer fixen Sammlung vordefinierter Prompts zu einer vollst�ndig konfigurierbaren Prompt-Bibliothek erweitert.

Hauptkomponenten

1. Prompt-Bibliothek (8 Kategorien)

  • K�rper (Gewicht, KF, Umf�nge, Caliper)
  • Ern�hrung (Kalorien, Makros, Timing)
  • Training (Volumen, Typen, HF)
  • Schlaf (Qualit�t, Dauer, Muster)
  • Vitalwerte (Ruhepuls, HRV, VO2Max)
  • Mentales (Stress, Stimmung, Energie)
  • Ziele (Fortschritt, Prognose, Zeitplan)
  • Ganzheitlich (Korrelationen, �bersicht)

2. Admin-Verwaltung

  • ? Aktivieren/Deaktivieren
  • ? Duplizieren und anpassen
  • ? Neu erstellen
  • ? Kategorie zuordnen
  • ? Reihenfolge festlegen (Drag & Drop)
  • ? Auf Standard zur�cksetzen

3. Platzhalter-System

  • Platzhalter-Browser (visuell, filterbar nach Kategorie)
  • Beispielwerte (zeigt was der Platzhalter mit echten Daten ausgeben w�rde)
  • Klick zum Einf�gen (an Cursor-Position)
  • Warnungen bei fehlenden Platzhaltern oder Daten
  • Prompt-Vorschau (bef�llt alle Platzhalter ohne KI-Call)

4. Pipeline-Konfigurationen

  • Mehrere Konfigurationen speicherbar (z.B. "Alltags-Check", "Schlaf-Fokus", "Wettkampf-Analyse")
  • Aktive Module pro Konfiguration (K�rper, Ern�hrung, Training, Schlaf, Vitalwerte)
  • Zeitr�ume pro Modul konfigurierbar (z.B. K�rper 30T, Schlaf 7T)
  • Stufen (min 2, max 4) mit zugewiesenen Prompts

5. Neue Platzhalter (Auswahl)

K�rper:

{{weight_aktuell}}, {{weight_trend}}, {{kf_aktuell}}, {{magermasse}}, {{whr}}, {{bmi}}

Training:

{{trainingstyp_verteilung}}, {{ruhetage_letzte_woche}}, {{hf_zonen_verteilung}}
{{faehigkeiten_analyse}}, {{faehigkeiten_koordinativ}}, {{faehigkeiten_konditionell}}
{{faehigkeiten_kognitiv}}, {{faehigkeiten_psychisch}}, {{faehigkeiten_taktisch}}

Ziele:

{{goal_weight}}, {{ziel_fortschritt}}, {{ziel_prognose}}

Pipeline:

{{stage1_body}}, {{stage1_nutrition}}, {{stage1_activity}}, {{stage1_sleep}}, {{stage1_vitals}}

Technische Umsetzung

Backend

  1. DB-Schema erweitern:

    • ai_prompts Tabelle: category, sort_order, is_active, prompt_type, pipeline_stage
    • Neue Tabelle pipeline_configs (Name, Module, Zeitr�ume, Stufen)
    • Neue Tabelle placeholder_definitions (Name, Kategorie, Beispielwert-Funktion)

  2. Endpoints:

    • GET /api/prompts?category=training (gefilterte Prompt-Liste)
    • POST /api/admin/prompts (CRUD f�r Prompts)
    • GET /api/admin/placeholders (Platzhalter-Browser-Daten)
    • POST /api/prompts/preview (Prompt-Vorschau ohne KI-Call)
    • GET /api/pipeline-configs (alle Konfigurationen)
    • POST /api/admin/pipeline-configs (CRUD f�r Pipeline-Configs)

  3. Platzhalter-Resolver:

    • Zentrale Funktion resolve_placeholders(template, profile_id, timeframe)
    • Lazy Loading: Nur ben�tigte Daten laden
    • Caching f�r wiederholte Platzhalter

Frontend

  1. Admin-UI: Prompt-Verwaltung

    • Tabelle mit Kategorie-Filter, Drag & Drop Sortierung
    • Modal f�r Prompt-Bearbeitung mit Platzhalter-Browser
    • Prompt-Vorschau-Button

  2. Admin-UI: Pipeline-Konfigurationen

    • Liste aller Configs mit Standard-Markierung
    • Modal f�r Config-Bearbeitung (Module, Zeitr�ume, Stufen)

  3. Nutzer-UI: Analyse-Seite

    • Kategorie-Filter f�r Prompts
    • Pipeline-Auswahl (Dropdown)
    • Analyse-Verlauf mit Kategorie-Filter

Abh�ngigkeiten

  • Voraussetzung f�r:

    • Issue #25 (Goals) ? braucht {{ziel_*}} Platzhalter
    • Issue #27 (Korrelationen) ? braucht Pipeline-Configs
    • Zuk�nftige KI-Features (Development Routes, Weekly Planning)

  • Baut auf:

    • Issue #29 (Abilities-Matrix) ? {{faehigkeiten_*}} Platzhalter

Aufwandssch�tzung

  • Backend: 10-12h (DB-Schema, Platzhalter-Resolver, Pipeline-Engine)
  • Admin-UI: 4-5h (Prompt-Verwaltung, Pipeline-Configs)
  • Nutzer-UI: 2-3h (Kategorie-Filter, Pipeline-Auswahl)
  • Gesamt: ~16-20h

Akzeptanzkriterien

  • Admin kann Prompts kategorisieren, aktivieren/deaktivieren, sortieren
  • Platzhalter-Browser zeigt alle verf�gbaren Platzhalter mit Beispielwerten
  • Prompt-Vorschau bef�llt Platzhalter ohne KI-Call
  • Mehrere Pipeline-Konfigurationen speicherbar
  • Nutzer kann Prompts nach Kategorie filtern
  • Analyse-Verlauf zeigt Kategorie pro Ergebnis
  • Alle neuen Platzhalter (K�rper, Training, Ziele, Pipeline) funktionieren

Dokumentation

?? Vollst�ndige Spec: .claude/docs/functional/AI_PROMPTS.md

## �berblick Das bestehende KI-Prompt-System wird von einer fixen Sammlung vordefinierter Prompts zu einer vollst�ndig konfigurierbaren Prompt-Bibliothek erweitert. ## Hauptkomponenten ### 1. Prompt-Bibliothek (8 Kategorien) - **K�rper** (Gewicht, KF, Umf�nge, Caliper) - **Ern�hrung** (Kalorien, Makros, Timing) - **Training** (Volumen, Typen, HF) - **Schlaf** (Qualit�t, Dauer, Muster) - **Vitalwerte** (Ruhepuls, HRV, VO2Max) - **Mentales** (Stress, Stimmung, Energie) - **Ziele** (Fortschritt, Prognose, Zeitplan) - **Ganzheitlich** (Korrelationen, �bersicht) ### 2. Admin-Verwaltung - ? Aktivieren/Deaktivieren - ? Duplizieren und anpassen - ? Neu erstellen - ? Kategorie zuordnen - ? Reihenfolge festlegen (Drag & Drop) - ? Auf Standard zur�cksetzen ### 3. Platzhalter-System - **Platzhalter-Browser** (visuell, filterbar nach Kategorie) - **Beispielwerte** (zeigt was der Platzhalter mit echten Daten ausgeben w�rde) - **Klick zum Einf�gen** (an Cursor-Position) - **Warnungen** bei fehlenden Platzhaltern oder Daten - **Prompt-Vorschau** (bef�llt alle Platzhalter ohne KI-Call) ### 4. Pipeline-Konfigurationen - **Mehrere Konfigurationen** speicherbar (z.B. "Alltags-Check", "Schlaf-Fokus", "Wettkampf-Analyse") - **Aktive Module** pro Konfiguration (K�rper, Ern�hrung, Training, Schlaf, Vitalwerte) - **Zeitr�ume** pro Modul konfigurierbar (z.B. K�rper 30T, Schlaf 7T) - **Stufen** (min 2, max 4) mit zugewiesenen Prompts ### 5. Neue Platzhalter (Auswahl) **K�rper:** ``` {{weight_aktuell}}, {{weight_trend}}, {{kf_aktuell}}, {{magermasse}}, {{whr}}, {{bmi}} ``` **Training:** ``` {{trainingstyp_verteilung}}, {{ruhetage_letzte_woche}}, {{hf_zonen_verteilung}} {{faehigkeiten_analyse}}, {{faehigkeiten_koordinativ}}, {{faehigkeiten_konditionell}} {{faehigkeiten_kognitiv}}, {{faehigkeiten_psychisch}}, {{faehigkeiten_taktisch}} ``` **Ziele:** ``` {{goal_weight}}, {{ziel_fortschritt}}, {{ziel_prognose}} ``` **Pipeline:** ``` {{stage1_body}}, {{stage1_nutrition}}, {{stage1_activity}}, {{stage1_sleep}}, {{stage1_vitals}} ``` ## Technische Umsetzung ### Backend 1. **DB-Schema erweitern:** - `ai_prompts` Tabelle: `category`, `sort_order`, `is_active`, `prompt_type`, `pipeline_stage` - Neue Tabelle `pipeline_configs` (Name, Module, Zeitr�ume, Stufen) - Neue Tabelle `placeholder_definitions` (Name, Kategorie, Beispielwert-Funktion) 2. **Endpoints:** - `GET /api/prompts?category=training` (gefilterte Prompt-Liste) - `POST /api/admin/prompts` (CRUD f�r Prompts) - `GET /api/admin/placeholders` (Platzhalter-Browser-Daten) - `POST /api/prompts/preview` (Prompt-Vorschau ohne KI-Call) - `GET /api/pipeline-configs` (alle Konfigurationen) - `POST /api/admin/pipeline-configs` (CRUD f�r Pipeline-Configs) 3. **Platzhalter-Resolver:** - Zentrale Funktion `resolve_placeholders(template, profile_id, timeframe)` - Lazy Loading: Nur ben�tigte Daten laden - Caching f�r wiederholte Platzhalter ### Frontend 1. **Admin-UI: Prompt-Verwaltung** - Tabelle mit Kategorie-Filter, Drag & Drop Sortierung - Modal f�r Prompt-Bearbeitung mit Platzhalter-Browser - Prompt-Vorschau-Button 2. **Admin-UI: Pipeline-Konfigurationen** - Liste aller Configs mit Standard-Markierung - Modal f�r Config-Bearbeitung (Module, Zeitr�ume, Stufen) 3. **Nutzer-UI: Analyse-Seite** - Kategorie-Filter f�r Prompts - Pipeline-Auswahl (Dropdown) - Analyse-Verlauf mit Kategorie-Filter ## Abh�ngigkeiten - **Voraussetzung f�r:** - Issue #25 (Goals) ? braucht `{{ziel_*}}` Platzhalter - Issue #27 (Korrelationen) ? braucht Pipeline-Configs - Zuk�nftige KI-Features (Development Routes, Weekly Planning) - **Baut auf:** - Issue #29 (Abilities-Matrix) ? `{{faehigkeiten_*}}` Platzhalter ## Aufwandssch�tzung - **Backend:** 10-12h (DB-Schema, Platzhalter-Resolver, Pipeline-Engine) - **Admin-UI:** 4-5h (Prompt-Verwaltung, Pipeline-Configs) - **Nutzer-UI:** 2-3h (Kategorie-Filter, Pipeline-Auswahl) - **Gesamt:** ~16-20h ## Akzeptanzkriterien - [ ] Admin kann Prompts kategorisieren, aktivieren/deaktivieren, sortieren - [ ] Platzhalter-Browser zeigt alle verf�gbaren Platzhalter mit Beispielwerten - [ ] Prompt-Vorschau bef�llt Platzhalter ohne KI-Call - [ ] Mehrere Pipeline-Konfigurationen speicherbar - [ ] Nutzer kann Prompts nach Kategorie filtern - [ ] Analyse-Verlauf zeigt Kategorie pro Ergebnis - [ ] Alle neuen Platzhalter (K�rper, Training, Ziele, Pipeline) funktionieren ## Dokumentation ?? Vollst�ndige Spec: `.claude/docs/functional/AI_PROMPTS.md`
Lars added the
feature
high
develop
 labels 2026-03-23 21:45:56 +01:00
Lars commented 2026-03-23 22:06:16 +01:00
Author
Owner
Copy Link

Erg�nzung aus Issue #24:

Quality-Level Parameter f�r KI-Analysen implementieren:

Endpoint-Erweiterung

@router.post("/insights/run/{slug}")
async def analyze_with_prompt(
    slug: str,
    quality_level: str = "quality",  # all, quality, very_good, excellent
    session: dict = Depends(require_auth)
):

Quality-Level Mapping

  • all: Alle Activities (kein Filter)
  • quality: excellent + good + acceptable (Standard)
  • very_good: excellent + good
  • excellent: nur excellent

Frontend-Integration

Analyse-Seite: Dropdown/Segmented Control wie in History.jsx

Nutzen

  • User kann f�r KI-Analysen Qualit�tsstufe w�hlen
  • Konsistent mit History.jsx Filter
  • Pipeline-Konfigurationen k�nnen Standard-Quality-Level haben

Priorit�t: Medium (kann nach Basis-Implementation von #28 kommen)

**Erg�nzung aus Issue #24:** Quality-Level Parameter f�r KI-Analysen implementieren: ### Endpoint-Erweiterung ```python @router.post("/insights/run/{slug}") async def analyze_with_prompt( slug: str, quality_level: str = "quality", # all, quality, very_good, excellent session: dict = Depends(require_auth) ): ``` ### Quality-Level Mapping - `all`: Alle Activities (kein Filter) - `quality`: excellent + good + acceptable (Standard) - `very_good`: excellent + good - `excellent`: nur excellent ### Frontend-Integration Analyse-Seite: Dropdown/Segmented Control wie in History.jsx ### Nutzen - User kann f�r KI-Analysen Qualit�tsstufe w�hlen - Konsistent mit History.jsx Filter - Pipeline-Konfigurationen k�nnen Standard-Quality-Level haben **Priorit�t:** Medium (kann nach Basis-Implementation von #28 kommen)
Lars closed this issue 2026-03-26 14:49:59 +01:00
Lars commented 2026-03-26 14:50:27 +01:00
Author
Owner
Copy Link

✅ Abgeschlossen am 26.03.2026

Implementierte Features:

Phase 1-4: Unified Prompt System

  • ✅ DB-Migration zu einheitlichem Schema (base + pipeline)
  • ✅ Universeller Executor (prompt_executor.py)
  • ✅ Frontend UI Consolidation (UnifiedPromptModal)
  • ✅ Cleanup & Documentation

Debug & Development Tools:

  • ✅ Test-Button mit Debug-Viewer
  • ✅ Placeholder Export (per Test + global)
  • ✅ Batch Import/Export für Prompts
  • ✅ Dev→Prod Sync in 2 Clicks

Placeholder System:

  • ✅ 32 aktive Platzhalter (6 neue, 7 rekonstruiert)
  • ✅ Kategorisierung (PROFIL, KÖRPER, ERNÄHRUNG, etc.)
  • ✅ {{placeholder|d}} Modifier für optionale Beschreibungen

Bug Fixes:

  • ✅ PIPELINE_MASTER Response
  • ✅ Age Calculation (PostgreSQL DATE)
  • ✅ Sleep Quality 0%
  • ✅ SQL Column Name Errors
  • ✅ Decimal × Float Type Error

Commits: 20+ commits (2e0838c bis ae6bd0d)
Dokumentation: CLAUDE.md Issue #28 Section

✅ **Abgeschlossen am 26.03.2026** ## Implementierte Features: ### Phase 1-4: Unified Prompt System - ✅ DB-Migration zu einheitlichem Schema (base + pipeline) - ✅ Universeller Executor (prompt_executor.py) - ✅ Frontend UI Consolidation (UnifiedPromptModal) - ✅ Cleanup & Documentation ### Debug & Development Tools: - ✅ Test-Button mit Debug-Viewer - ✅ Placeholder Export (per Test + global) - ✅ Batch Import/Export für Prompts - ✅ Dev→Prod Sync in 2 Clicks ### Placeholder System: - ✅ 32 aktive Platzhalter (6 neue, 7 rekonstruiert) - ✅ Kategorisierung (PROFIL, KÖRPER, ERNÄHRUNG, etc.) - ✅ `{{placeholder|d}}` Modifier für optionale Beschreibungen ### Bug Fixes: - ✅ PIPELINE_MASTER Response - ✅ Age Calculation (PostgreSQL DATE) - ✅ Sleep Quality 0% - ✅ SQL Column Name Errors - ✅ Decimal × Float Type Error **Commits:** 20+ commits (2e0838c bis ae6bd0d) **Dokumentation:** CLAUDE.md Issue #28 Section
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels   
bug

Bug/Fehler

  
develop

Betrifft develop Branch

  
feature

Feature Request

  
high

Hohe Priorit�t

  
low

Niedrige Priorit�t

No Label
bug
develop
feature
high
low
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Lars/mitai-jinkendo#28
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?