Document management division analysis updates

2026-05-29 14:08:50 +02:00
parent 36ca822fbc
commit d1c9d21227
5 changed files with 201 additions and 8 deletions
@@ -151,6 +151,81 @@ Noch zu pruefen:

 Dieser Task ist keine Finance-Soll/Ist-Regel. Die Klassifikation kann spaeter Finance- und Management-Auswertungen ergaenzen, sollte aber fachlich getrennt von Net-Sales-Abgrenzungen bleiben.

+## Nachtrag 2026-05-29 Web-Analyse Und Management UX
+
+Die Produktspartenlogik ist im Webprogramm produktiv als Analyse- und Pruefschicht sichtbar.
+
+### Navigation
+
+`Management Analyse` ist in der linken Navigation aufklappbar. Direkte Links springen in die relevanten Reiter:
+
+- `Finance Summary`
+- `Laender`
+- `Datenstatus`
+- `Abweichungen`
+- `Gutschriften`
+- `Datenqualitaet`
+- `Sparten-Finanzanalyse`
+- `Zentrale Spartenzuordnung`
+- `Rohdaten Diagnose`
+
+Technisch erfolgt der Sprung ueber Query-Parameter (`section`, `division`) und feste Reiter-Indizes in `ManagementCockpit.razor`.
+
+### Spartenanalyse
+
+Die beiden Sparten-Sichten sind unter einem Top-Level-Reiter `Spartenanalyse` gruppiert:
+
+- `Finanzanalyse`
+- `Zentrale Zuordnung`
+
+`Zentrale Zuordnung` bleibt die Pruefsicht fuer lokale Materialnummern gegen die fuehrende TR-AG-/SAP-Referenz aus `ProductDivisionRefSet`.
+
+`Finanzanalyse` nutzt dieselbe Statuslogik und aggregiert die Finance-Werte:
+
+- Gesamtumsatz
+- Zugeordneter Umsatz
+- Nicht zugeordneter Umsatz
+- Umsatz nicht im TR-AG-Stamm
+- Umsatz nach Produktsparte/Familie/PAPH1
+- Umsatzabdeckung nach Land/TSC
+
+### Gruppierung Und Top 10
+
+In der Tabelle `Umsatz nach Produktsparte` kann die Anzeige gruppiert werden:
+
+- `PAPH1 Detail`: feinste Sicht mit Produkthierarchie-Code.
+- `Produktfamilie`: fasst mehrere PAPH1-Zeilen zusammen, z.B. Gas Density Monitor.
+- `Produktsparte`: verdichtet auf die oberste Spartenebene.
+
+Der Button `Top 10 anzeigen` reduziert nur die Anzeige auf die groessten Umsatzbloecke. Die Berechnungsbasis und Summary-Kennzahlen bleiben unveraendert.
+
+Laender werden in den relevanten Tabellen mit Flagge und Landkuerzel angezeigt.
+
+### Sparten-Icons
+
+Neben der Produktsparte wird ein rein visuelles Icon angezeigt. Die Auswahl wird regelbasiert aus Sparten-, Familien- und PAPH1-Texten abgeleitet und aendert keine Zahlen:
+
+| Textmuster | Icon |
+| --- | --- |
+| Gas / Density | `Sensors` |
+| Pressure / Druck | `Compress` |
+| Temp / Thermostat | `DeviceThermostat` |
+| Switch / Schalter | `ToggleOn` |
+| Access / Zubehoer | `Extension` |
+| UNASS / Nicht zugeordnet | `HelpOutline` |
+| sonst | `Category` |
+
+### Schulung Und Browser
+
+- Die Finance-Schulung enthaelt einen neuen Tab `Spartenanalyse` mit Bedienung, Interpretation und Icon-Legende.
+- Die Web-App hat ein eigenes Browser-Favicon `wwwroot/favicon.svg`.
+
+Validierung:
+
+- `dotnet test TrafagSalesExporter.sln --verbosity minimal --artifacts-path C:\TMP\trafag-test-artifacts-favicon`
+- Ergebnis: `80/80` Tests gruen.
+- Letzter Deploy der dokumentierten UI-Aenderungen: 2026-05-29 13:47 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
+
 ## Nachtrag 2026-05-29 Umsetzung SAP Gateway Und Web

 SAP/DDIC:
@@ -1,6 +1,6 @@
 # RAG Finance

-Stand: 2026-05-27
+Stand: 2026-05-29

 ## Kurzstand

@@ -8,6 +8,11 @@ Stand: 2026-05-27
 - `Finance Summary` nutzt dieselbe `FinanceRuleEngine` wie das zentrale Excel.
 - `Management Analyse` bleibt Diagnose-/Plausibilitaetssicht, nicht fuehrende Finance-Zahl.
 - `Management Analyse` hat zusaetzliche Finance-Reiter fuer Laender, Datenstatus, Abweichungen, Gutschriften-Kandidaten und Datenqualitaet.
+- `Management Analyse` ist links aufklappbar; direkte Navigationspunkte springen in die einzelnen Reiter.
+- Neu: `Spartenanalyse` mit Unterreitern `Finanzanalyse` und `Zentrale Zuordnung`.
+- Sparten-Finanzanalyse nutzt die TR-AG-/SAP-Referenz, nicht lokale ERP-Sparten anderer Laender.
+- Sparten-Finanzanalyse bietet Gruppierung nach `PAPH1 Detail`, `Produktfamilie`, `Produktsparte`, optional `Top 10`, Laenderflaggen und visuelle Sparten-Icons.
+- Finance-Schulung dokumentiert die neuen Spartenfunktionen im Tab `Spartenanalyse`.
 - Filter fuer Jahr, Land und Waehrung wirken auf das Finance-Endergebnis.
 - Standard-Ist bleibt inklusive Positionen; Intercompany/2nd-party wird separat ausgewiesen.

@@ -33,6 +38,24 @@ Stand: 2026-05-27
 - `Abweichungen`: Soll/Ist-Abweichungen sortiert nach Betrag.
 - `Gutschriften`: technische Kandidaten ueber negative Werte und erkennbare Belegtypen/-nummern.
 - `Datenqualitaet`: fehlende Materialnummern, ProductGroup, Waehrung, Kunde, Datum, Nullwerte und ausgeschlossene Zeilen.
+- `Spartenanalyse > Finanzanalyse`: Umsatzabdeckung und Umsatz nach Produktsparte/Familie/PAPH1 auf Basis der TR-AG-Referenz.
+- `Spartenanalyse > Zentrale Zuordnung`: Materialnummern aller Laender gegen TR-AG-Stamm pruefen.
+- `Rohdaten Diagnose`: direkte Plausibilitaets-/Rohdatensicht auf `CentralSalesRecords`.
+
+## Spartenanalyse Kurzlogik
+
+- Statuswerte:
+  - `Zugeordnet`: Material im TR-AG-Stamm gefunden und Sparte verwertbar.
+  - `Nicht zugeordnet`: TR-AG-Referenz vorhanden, aber `UNASS`/leer.
+  - `Nicht im TR-AG-Stamm`: lokale Materialnummer hat keinen TR-AG-Treffer.
+  - `Material fehlt`: Finance-Zeile ohne Materialnummer.
+- Gruppierung:
+  - `PAPH1 Detail`: feinste Hierarchie-Sicht.
+  - `Produktfamilie`: Managementsicht fuer Familien wie Gas Density Monitor.
+  - `Produktsparte`: oberste Verdichtung.
+- `Top 10 anzeigen` filtert nur die Tabelle, nicht die Summary-Berechnung.
+- Laender werden mit Flagge angezeigt.
+- Icons sind rein visuell und werden aus Textmustern abgeleitet.

 ## Land-Kurzindex

@@ -10,6 +10,9 @@ Stand: 2026-05-29
 - Dashboard soll KEDR-/KE30-Ableitung nicht in C# nachbauen.
 - ABAP/Gateway soll eine flache Referenz liefern: `MATNR -> PAPH1 -> WWPFA -> WWPSP`.
 - Nicht gefundene oder nicht eindeutig ableitbare Materialnummern laufen unter `Nicht zugeordnet`.
+- Web produktiv: `Management Analyse` enthaelt `Spartenanalyse` mit Unterreitern `Finanzanalyse` und `Zentrale Zuordnung`.
+- Sparten-Finanzanalyse kann nach `PAPH1 Detail`, `Produktfamilie` oder `Produktsparte` gruppieren und optional `Top 10` anzeigen.
+- Laender werden mit Flaggen angezeigt; Produktsparte erhaelt visuelle Icons nach Textmuster.

 ## Aktueller Code-Stand

@@ -75,6 +78,31 @@ Stand: 2026-05-29
 - Umsetzung ist eine Analyseansicht, keine persistente Mutation anderer Laenderzeilen.
 - Validierung nach Umsetzung: `80/80` Tests gruen.

+## Spartenanalyse UX 2026-05-29
+
+- Navigation links:
+  - `Management Analyse` ist aufklappbar.
+  - Direkte Links springen per Query-Parameter in Finance Summary, Laender, Datenstatus, Abweichungen, Gutschriften, Datenqualitaet, Sparten-Finanzanalyse, Zentrale Spartenzuordnung und Rohdaten Diagnose.
+- `Spartenanalyse` ist ein Top-Level-Reiter mit Unterreitern:
+  - `Finanzanalyse`
+  - `Zentrale Zuordnung`
+- `Finanzanalyse`:
+  - Kennzahlen Gesamt/Zugeordnet/Nicht zugeordnet/Nicht im Stamm.
+  - Umsatz nach Produktsparte mit Gruppierung `PAPH1 Detail`, `Produktfamilie`, `Produktsparte`.
+  - `Top 10 anzeigen` filtert nur die Anzeige.
+  - Laender werden mit Flagge dargestellt.
+  - Produktsparte zeigt Icon:
+    - Gas/Density -> `Sensors`
+    - Pressure/Druck -> `Compress`
+    - Temp/Thermostat -> `DeviceThermostat`
+    - Switch/Schalter -> `ToggleOn`
+    - Access/Zubehoer -> `Extension`
+    - UNASS -> `HelpOutline`
+    - sonst -> `Category`
+- Finance-Schulung hat einen neuen Tab `Spartenanalyse`.
+- Browser-Favicon wurde ergaenzt: `wwwroot/favicon.svg`.
+- Letzter dokumentierter Deploy: 2026-05-29 13:47, Tests `80/80` gruen.
+
 ## Offene Punkte Fuer Sitzung

 - Normalisierung der Materialnummern.
@@ -1,12 +1,15 @@
 # RAG Project

-Stand: 2026-05-27
+Stand: 2026-05-29

 ## Kurzstand

 - Fuehrende App: `TrafagSalesExporter`, publiziert als `BiDashboard`.
- Letzter dokumentierter Stand: Rebase/Push synchron mit `origin/main`, Head `d853f53 Add published HR KPI workflow fixes`.
- Validierung laut Doku: Build erfolgreich, Tests zuletzt `78/78` gruen.
+- Letzter dokumentierter Stand: alle Aenderungen bis `36ca822 Add browser favicon` umgesetzt und deployed.
+- Validierung laut Doku: `80/80` Tests gruen, letzter Testlauf mit Artefaktpfad `C:\TMP\trafag-test-artifacts-favicon`.
+- Letzter Deploy: 2026-05-29 13:47 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
+- Neu im Finance/Management-Cockpit: aufklappbare Management-Navigation, Spartenanalyse-Unterreiter, Gruppierung/Top-10/Flaggen/Icon-UX und Finance-Schulungserweiterung.
+- Neu im Browser: eigenes SVG-Favicon `wwwroot/favicon.svg`.
 - Fuer normale Weiterarbeit diese Datei plus den passenden Themen-RAG laden.

 ## Aktive Themen
@@ -8,8 +8,8 @@ Diese Datei ist fuer tokenarme RAG-Nutzung komprimiert.

 - Fuehrender Kurzkontext: `docs/rag/PROJECT.md`.
 - Themenrouter: `docs/RAG_ROUTER.md`.
- Letzter dokumentierter Stand aus dem Roharchiv: Rebase/Push synchron mit `origin/main`, Head `d853f53 Add published HR KPI workflow fixes`.
- Letzte dokumentierte Validierung: Build erfolgreich, Tests `78/78` gruen.
+- Letzter dokumentierter Code-Stand: `36ca822 Add browser favicon`, alle Aenderungen bis 2026-05-29 13:47 deployt.
+- Letzte dokumentierte Validierung: `dotnet test TrafagSalesExporter.sln --verbosity minimal --artifacts-path C:\TMP\trafag-test-artifacts-favicon` mit `80/80` Tests gruen.
 - Neu dokumentiert: Produktsparten-Mapping fuer Group Sales Report ueber TR-AG-Artikelstamm und separate Mapping-Tabelle.
 - Neu dokumentiert: Upgreat-Firewall-Freigabe muss fuer den publizierten Webserver `10.120.1.17` erfolgen, nicht fuer den lokalen Entwicklungs-PC.
 - Neu umgesetzt: `Management Analyse` im Finance Cockpit hat zusaetzliche Reiter fuer Laender, Datenstatus, Abweichungen, Gutschriften-Kandidaten und Datenqualitaet.
@@ -17,8 +17,72 @@ Diese Datei ist fuer tokenarme RAG-Nutzung komprimiert.
 - Neu umgesetzt: Produktspartenfelder im Web-Datenmodell, Gateway-Join-Konfiguration fuer `ProductDivisionRefSet` und Excel-Ausgabe.
 - Neu umgesetzt und deployed: Reiter `Zentrale Spartenzuordnung` in `Management Analyse`, der Finance-Materialien gegen die fuehrende TR-AG-/SAP-Referenz prueft.
 - Neu umgesetzt und deployed: Reiter `Sparten-Finanzanalyse` in `Management Analyse`, der Umsatzabdeckung und Umsatz nach Produktsparte aus der zentralen Spartenzuordnung berechnet.
- Letzter Deploy: 2026-05-29 10:42 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Letzte Validierung: `dotnet test TrafagSalesExporter.sln --verbosity minimal --artifacts-path C:\TMP\trafag-test-artifacts-division-finance` mit `80/80` Tests gruen.
+- Neu umgesetzt und deployed: `Management Analyse` ist in der linken Navigation aufklappbar; direkte Links springen in Finance Summary, Laender, Datenstatus, Abweichungen, Gutschriften, Datenqualitaet, Spartenanalyse und Rohdaten Diagnose.
+- Neu umgesetzt und deployed: Spartenanalyse ist als Hauptreiter mit Unterreitern `Finanzanalyse` und `Zentrale Zuordnung` strukturiert.
+- Neu umgesetzt und deployed: Sparten-Finanzanalyse kann nach `PAPH1 Detail`, `Produktfamilie` oder `Produktsparte` aggregieren, optional `Top 10` anzeigen und Laender mit Flaggen darstellen.
+- Neu umgesetzt und deployed: Produktsparte zeigt visuelle Kategorie-Icons fuer Gas/Density, Pressure/Druck, Temperatur/Thermostat, Switch/Schalter, Access/Zubehoer, UNASS und Sonstige.
+- Neu umgesetzt und deployed: Finance-Schulung hat einen neuen Tab `Spartenanalyse` mit Navigation, Gruppierung, Top 10, Flaggen, Icons und Statusinterpretation.
+- Neu umgesetzt und deployed: Browser-Favicon `wwwroot/favicon.svg` und Head-Link in `Components/App.razor`.
+- Letzter Deploy: 2026-05-29 13:47 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
+- Letzte Validierung: `dotnet test TrafagSalesExporter.sln --verbosity minimal --artifacts-path C:\TMP\trafag-test-artifacts-favicon` mit `80/80` Tests gruen.
+
+## Nachtrag 2026-05-29 Management Analyse UX / Spartenanalyse / Favicon
+
+Umgesetzt und deployed:
+
+- `Management Analyse` ist in der linken Navigation als `MudNavGroup` aufklappbar.
+- Direkte Navigationspunkte:
+  - `Finance Summary`
+  - `Laender`
+  - `Datenstatus`
+  - `Abweichungen`
+  - `Gutschriften`
+  - `Datenqualitaet`
+  - `Sparten-Finanzanalyse`
+  - `Zentrale Spartenzuordnung`
+  - `Rohdaten Diagnose`
+- Die Navigation nutzt Query-Parameter (`section`, `division`), und `ManagementCockpit.razor` bindet diese auf feste Reiter-Indizes.
+- Die bisherigen Top-Level-Reiter `Sparten-Finanzanalyse` und `Zentrale Spartenzuordnung` wurden in einen Top-Level-Reiter `Spartenanalyse` mit Unterreitern zusammengefuehrt:
+  - `Finanzanalyse`
+  - `Zentrale Zuordnung`
+- `Sparten-Finanzanalyse` hat neue Controls:
+  - Dropdown `Gruppierung`: `PAPH1 Detail`, `Produktfamilie`, `Produktsparte`
+  - Button `Top 10 anzeigen` mit Filter-Icon
+  - dynamische Spaltenausblendung je Gruppierung
+- Aggregation:
+  - Umsatz, Anteil, Zeilen und Laender werden je Gruppierung neu berechnet.
+  - `Top 10` filtert nur die Anzeige, nicht die zugrunde liegende Berechnungsbasis.
+  - Laender werden mit Flagge formatiert.
+- Visuelle Produktsparte-Icons:
+  - Gas/Density -> `Sensors`
+  - Pressure/Druck -> `Compress`
+  - Temp/Thermostat -> `DeviceThermostat`
+  - Switch/Schalter -> `ToggleOn`
+  - Access/Zubehoer -> `Extension`
+  - UNASS/Nicht zugeordnet -> `HelpOutline`
+  - sonst -> `Category`
+- Finance-Schulung:
+  - Neuer Schulungs-Tab `Spartenanalyse`.
+  - Dokumentiert Navigation, Gruppierung, Top 10, Flaggen, Icons und Statusinterpretation.
+- Browser:
+  - Neues SVG-Favicon `wwwroot/favicon.svg`.
+  - Eingebunden in `Components/App.razor` via `<link rel="icon" type="image/svg+xml" href="favicon.svg" />`.
+
+Commits:
+
+- `dc2bc7d Group division analysis tabs`
+- `0a7aafb Add management analysis navigation group`
+- `3c82747 Add division finance grouping controls`
+- `18208cb Add product division category icons`
+- `61de1be Document division analysis in finance training`
+- `674c103 Expose management analysis tabs in navigation`
+- `36ca822 Add browser favicon`
+
+Validierungen:
+
+- Mehrfach `dotnet test TrafagSalesExporter.sln --verbosity minimal` mit separaten Artefaktpfaden.
+- Letzter dokumentierter Testlauf: `80/80` Tests gruen.
+- Letzter Webserver-Deploy: `BiDashboard.dll` aktualisiert am `29.05.2026 13:47:36`.

 ## Nachtrag 2026-05-29 Produktsparten-Mapping Gateway/Web