Modul-Review 3: Struktur, Dashboard, CSV-Export und Grafiken

Versionierung:
- startet neu bei 0.1; erst eine gesetzte Hauptversion macht daraus 1.0
- Szenario-Liste zeigt die echte Version (z.B. 0.17) statt "1.x", plus
  neue Spalte "Phasen"
- Migration 20260724120000_version_zero_start (nur der Default)

Plan-Dashboard:
- Kacheln anklickbar (fuehren in ihren Bereich), neue Kachel "Berichte"
- Plan umbenennen ueber Stift-Symbol
- Ist-Abweichung nennt das Jahr des juengsten Ist-Datensatzes und ist bei
  positiver Abweichung gruen statt rot

Szenario-Liste:
- Klick auf die Zeile oeffnet die Matrix (Matrix-Knopf entfaellt)
- je Zeile Kopie (Vorlage frei waehlbar) und Loeschen
- laedt nach einer Loeschung neu (zeigte vorher den alten Stand)

Seitenleiste:
- Szenarien wieder verschachtelt nach Herkunft
- Effektive Werte / Analysen / Berichte buendig zum Knoten "Szenarien"

CSV-Export (neues Modul lib/csv.ts):
- vier Bloecke: Kopf, Lebensphasen, ganze Matrix (Elemente x Phasen inkl.
  Uebergangs-Entscheide im Klartext), Jahreswerte
- mit BOM (Excel-Umlaute), Dateiname transliteriert Umlaute
- vorher enthielt die Datei kein einziges finanzielles Element

Grafiken:
- Szenario-Waehler gilt fuer alle drei Grafiken
- BUGFIX Szenario-Vergleich: WealthChart nutzte den Namen als Datenschluessel
  -> gleichnamige Szenarien ueberschrieben sich (Legende zeigte beide, Chart
  nur eine). Neu die ID; stille Deckelung auf 4 Serien entfaellt
- eigene Legende mit freier Farbwahl je Serie + Erklaerung des Linienstils
- Vermoegensaufteilung neu: gestapelte Flaeche ueber die Planjahre + Ring
  fuer die relative Aufteilung zu einem waehlbaren Zeitpunkt
- alle Diagrammfarben aus neuen Theme-Tokens (--chart-1..6, --chart-grid)

Doku-Drift bereinigt: Kapitel 2.1, 3.2.2-3.2.7 und 3.10 beschrieben noch den
Stand vor V7 (Grundprofil am Szenario, parentPlanId, Scenario.startYear,
window.confirm, drei Sidebar-Unterpunkte).

Nebenbei: verstuemmelte Hex-Farbe --danger-soft (warm) repariert, deutsche
Plural-/Umlautfehler in den Uebersichts-Kacheln.

SPEZIFIKATION 0.31. 267 -> 275 Tests.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/app/api/plans/[planId]/dashboard/route.ts

@@ -19,7 +19,13 @@ export async function GET(_request: NextRequest, { params }: { params: Promise<{
       persons: { orderBy: { role: "asc" } },
       scenarios: {
         orderBy: [{ isBase: "desc" }, { createdAt: "asc" }],
-        include: { ...planInclude, _count: { select: { elements: true, versions: true } } },
+        include: {
+          ...planInclude,
+          _count: { select: { elements: true, versions: true } },
+          // Höchste Version je Szenario -- die Liste zeigt die echte Nummer (z. B. «0.17»),
+          // nicht nur die Hauptversion.
+          versions: { orderBy: [{ major: "desc" }, { minor: "desc" }], take: 1, select: { major: true, minor: true } },
+        },
       },
       actuals: { orderBy: [{ year: "asc" }, { recordedOn: "asc" }] },
       _count: { select: { scenarios: true, actuals: true, analyses: true } },
@@ -71,13 +77,16 @@ export async function GET(_request: NextRequest, { params }: { params: Promise<{
     const pi = toPlanInput(s);
     const computed = computePlan(pi);
     const last = computed.phases[computed.phases.length - 1];
+    const top = s.versions[0];
     return {
       id: s.id,
       name: s.name,
       isBase: s.isBase,
       parentScenarioId: s.parentScenarioId,
-      currentMajor: s.currentMajor,
+      // Die tatsächliche aktuelle Version, nicht nur die Hauptversion. Ohne Historie noch keine.
+      version: top ? `${top.major}.${top.minor}` : null,
       elementCount: s._count.elements,
+      phaseCount: computed.phases.length,
       versionCount: s._count.versions,
       endNominal: last ? Math.round(last.endWealthNominal) : 0,
       endReal: last ? Math.round(last.endWealthReal) : 0,

src/app/api/scenarios/[scenarioId]/export/route.ts

@@ -1,7 +1,16 @@
 import { NextRequest, NextResponse } from "next/server";
 import { toPlanInput, getOwnedScenario } from "@/lib/queries";
 import { getCurrentUserId } from "@/lib/session";
-import { computePlan, planToCsv } from "@/lib/calculations";
+import { computePlan } from "@/lib/calculations";
+import { planToCsv } from "@/lib/csv";
+
+// Umlaute und ss ausschreiben, alles Uebrige auf Unterstrich -- ein Dateiname mit Umlauten
+// kommt je nach Betriebssystem verstuemmelt an.
+function safeFileName(name: string): string {
+  const map: Record<string, string> = { "ä": "ae", "ö": "oe", "ü": "ue", "Ä": "Ae", "Ö": "Oe", "Ü": "Ue", "ß": "ss" };
+  const t = name.replace(/[äöüÄÖÜß]/g, (c) => map[c]);
+  return t.replace(/[^a-z0-9]+/gi, "_").replace(/^_+|_+$/g, "") || "szenario";
+}
 
 export async function GET(
   _request: NextRequest,
@@ -25,7 +34,7 @@ export async function GET(
   return new NextResponse(csv, {
     headers: {
       "Content-Type": "text/csv; charset=utf-8",
-      "Content-Disposition": `attachment; filename="${scenario.name.replace(/[^a-z0-9]+/gi, "_")}.csv"`,
+      "Content-Disposition": `attachment; filename="${safeFileName(scenario.name)}.csv"`,
     },
   });
 }