From b0f80e0be71218685cfb1b40e25f25c65c8184bd Mon Sep 17 00:00:00 2001
From: Lars <Lars@stommer.de>
Date: Thu, 26 Mar 2026 13:03:49 +0100
Subject: [PATCH] docs: document Issue #47 completion in CLAUDE.md

- Added comprehensive documentation for Value Table feature
- Expert mode, category grouping, stage output extraction
- Updated version header to reflect #28 and #47 completion
---
 CLAUDE.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index b7cf3cf..00099b8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -56,7 +56,7 @@ frontend/src/
     └── technical/   # MEMBERSHIP_SYSTEM.md
 ```
 
-## Aktuelle Version: v9e (Issue #28 Complete) 🚀 Ready for Production 26.03.2026
+## Aktuelle Version: v9e (Issue #28, #47 Complete) 🚀 Ready for Production 26.03.2026
 
 ### Implementiert ✅
 - Login (E-Mail + bcrypt), Auth-Middleware alle Endpoints, Rate Limiting
@@ -301,6 +301,55 @@ frontend/src/
 - #44: BUG - Analysen löschen - 🔲 OPEN (High priority)
 - #45: KI Prompt-Optimierer - 🔲 OPEN (Future feature)
 - #46: KI Prompt-Ersteller - 🔲 OPEN (Future feature)
+- #47: Value Table - ✅ CLOSED (26.03.2026)
+
+### Issue #47: Comprehensive Value Table ✅ (Completed 26.03.2026)
+
+**AI-Analyse Transparenz - Vollständige Platzhalter-Anzeige:**
+
+- ✅ **Metadata Collection System:**
+  - Alle genutzten Platzhalter mit Werten während Ausführung gesammelt
+  - Vollständige (nicht gekürzte) Werte aus placeholder_resolver
+  - Kategorisierung nach Modul (Profil, Körper, Ernährung, Training, etc.)
+  - Speicherung in ai_insights.metadata (JSONB)
+
+- ✅ **Expert Mode:**
+  - Toggle-Button "🔬 Experten-Modus" in Analysis-Seite
+  - Normal-Modus: Zeigt nur relevante, gefüllte Werte
+  - Experten-Modus: Zeigt alle Werte inkl. Rohdaten und Stage-Outputs
+
+- ✅ **Stage Output Extraction:**
+  - Basis-Prompts mit JSON-Output: Einzelwerte extrahiert
+  - Jedes Feld aus Stage-JSON als eigene Zeile
+  - Visuelle Kennzeichnung: ↳ für extrahierte Werte
+  - Source-Tracking: Welche Stage, welcher Output
+
+- ✅ **Category Grouping:**
+  - Gruppierung nach Kategorien (PROFIL, KÖRPER, ERNÄHRUNG, etc.)
+  - Stage-Outputs als eigene Kategorien ("Stage 1 - Body")
+  - Rohdaten-Sektion (nur im Experten-Modus)
+  - Sortierung: Reguläre → Stage-Outputs → Rohdaten
+
+- ✅ **Value Table Features:**
+  - Drei Spalten: Platzhalter | Wert | Beschreibung
+  - Keine Kürzung langer Werte
+  - Kategorie-Header mit grauem Hintergrund
+  - Empty/nicht verfügbar Werte ausgeblendet (Normal-Modus)
+
+**Migrations:**
+- Migration 021: ai_insights.metadata JSONB column
+
+**Backend Endpoints:**
+- `POST /api/prompts/execute` - Erweitert um Metadata-Collection
+- `GET /api/insights/placeholders/catalog` - Placeholder-Kategorien
+
+**UI:**
+- Analysis Page: Value Table mit Category-Grouping
+- Expert-Mode Toggle (🔬 Symbol)
+- Collapsible JSON für Rohdaten
+- Delete-Button für Insights (🗑️)
+
+📚 Details: `.claude/docs/functional/AI_PROMPTS.md`
 
 ## Feature-Roadmap