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`.
+- Letzter dokumentierter Stand: alle Aenderungen bis `36ca822 Add browser favicon` umgesetzt und deployed.
- Validierung laut Doku: Build erfolgreich, Tests zuletzt `78/78` gruen.
+- 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`.
+- Letzter dokumentierter Code-Stand: `36ca822 Add browser favicon`, alle Aenderungen bis 2026-05-29 13:47 deployt.
- Letzte dokumentierte Validierung: Build erfolgreich, Tests `78/78` gruen.
+- 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$\`.
+- 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.
- 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: 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