Enhance management cockpit analysis

TrafagSalesExporter/HANDOFF_2026-04-15.md

@@ -2,6 +2,117 @@
 
 Stand: 2026-04-15
 
+## Nachtrag 2026-04-29 Management-Cockpit-Auswertung
+
+Seit dem letzten dokumentierten Stand vom 2026-04-17 wurde das `Management Cockpit` weiter ausgebaut. Dieser Abschnitt rekonstruiert den aktuellen Stand aus dem Code, weil die Aenderungen nach einem PC-Absturz nicht direkt nachdokumentiert wurden.
+
+### Neue Auswertlogik
+
+Das Cockpit ist nicht mehr nur auf Umsatz als feste Kennzahl beschraenkt.
+
+Neu gibt es auswählbare Summenfelder:
+
+- `Sales Price/Value`
+- `Quantity`
+- `Standard cost`
+- `Quantity * Standard cost`
+
+Diese Auswahl gilt fuer:
+
+- dateibasierte Analyse vorhandener Excel-Exporte
+- zentrale Roh-Auswertung aus `CentralSalesRecords`
+
+### Anzeige-Waehrung und Wechselkurse
+
+Fuer betragliche Summenfelder kann jetzt eine Anzeige-Waehrung gewaehlt werden:
+
+- `EUR`
+- `USD`
+- `Original`
+
+Die Umrechnung nutzt `CurrencyExchangeRateService`.
+
+Wichtig:
+
+- nicht-betragliche Werte wie `Quantity` werden nicht umgerechnet
+- bei `Original` bleiben Werte in der jeweiligen Quellwaehrung
+- bei fehlendem Wechselkurs wird der betroffene Wert mit `0` in die Zielwaehrung eingerechnet
+- fehlende Kurse werden als Anzahl `Nicht umgerechnet` bzw. in Hinweisen/Finding sichtbar gemacht
+- Wechselkurse werden pro Quellwaehrung, Zielwaehrung und Datum gecacht, damit grosse Auswertungen nicht unnoetig oft die gleiche Rate aufloesen
+
+### Zusätzliche Summenfelder in der zentralen Sicht
+
+Die zentrale Roh-Auswertung kann neben dem Haupt-Summenfeld weitere Summenfelder anzeigen.
+
+Diese Zusatzwerte werden aktuell in den Zeitreihen ausgegeben:
+
+- Jahreswerte
+- Monatswerte
+- Tageswerte im gewaehlten Monat
+
+Beispiel:
+
+- Hauptwert: `Sales Price/Value`
+- Zusatzwerte: `Quantity`, `Quantity * Standard cost`
+
+Damit kann die zentrale Sicht Umsatz, Mengen und Kostennaeherung nebeneinander darstellen.
+
+### UI-Stand
+
+`Components/Pages/ManagementCockpit.razor` hat neue Controls:
+
+- Summenfeld fuer Excel-Dateianalyse
+- Anzeige-Waehrung fuer Excel-Dateianalyse
+- Summenfeld fuer zentrale Roh-Auswertung
+- weitere Summenfelder fuer zentrale Roh-Auswertung per Mehrfachauswahl
+- Anzeige-Waehrung fuer zentrale Roh-Auswertung
+
+Die Tabellen wurden von festem Text `Umsatz` auf generische `Werte` / `Jahreswerte` / `Monatswerte` umgestellt.
+
+Die vorher dokumentierte Manometer-/Gauge-Sicht ist im aktuellen Arbeitsstand nicht mehr aktiv sichtbar. Stattdessen liegt der Fokus wieder auf Kennzahlen, Hinweisen und tabellarischen Auswertungen.
+
+### Technische Umsetzung
+
+Betroffene Dateien:
+
+- `Components/Pages/ManagementCockpit.razor`
+- `Models/ManagementCockpitModels.cs`
+- `Services/IManagementCockpitService.cs`
+- `Services/ManagementCockpitPageService.cs`
+- `Services/ManagementCockpitService.cs`
+- `TrafagSalesExporter.Tests/ManagementCockpitServiceTests.cs`
+
+Neue bzw. erweiterte Modelle:
+
+- `ManagementCockpitValueFieldKeys`
+- `ManagementCockpitCurrencyOptions`
+- `ManagementCockpitValueFieldOption`
+- `ManagementCockpitAnalysisOptions`
+- `ManagementCockpitAggregatedFieldValue`
+
+Neue Felder in Ergebnissen:
+
+- gewaehltes Summenfeld
+- Anzeige-Waehrung
+- Anzahl fehlender Wechselkurse
+- Zusatzwerte pro Zeitreihe
+
+### Testabdeckung
+
+Die `ManagementCockpitServiceTests` wurden erweitert um Tests fuer:
+
+- Umrechnung zentraler Werte in EUR
+- Caching von Wechselkursauflösungen
+- Mengen-Summe ohne Waehrungsumrechnung
+- Zusatz-Summenfelder in Jahres- und Monatswerten
+
+Noch offen:
+
+- UI manuell pruefen
+- genaue fachliche Zielwaehrung fuer Standardberichte bestaetigen
+- entscheiden, ob `CHF` ebenfalls als direkte Anzeige-Waehrung angeboten werden soll
+- klaeren, ob fehlende Wechselkurse langfristig mit `0`, Originalwert oder separater Fehlergruppe dargestellt werden sollen
+
 ## Nachtrag 2026-04-17 Refactoring- und HANA-Stand
 
 Der Stand aus den frueheren Nachtraegen ist fuer Architektur und HANA-Zugriff nicht mehr vollstaendig.