Document product division mapping task

TrafagSalesExporter/docs/MD_DOKUMENTENSTATUS_2026-05-20.md

@@ -17,6 +17,7 @@ Diese Datei ordnet die vorhandenen Markdown-Dateien ein. Ziel ist, alte Arbeitsn
 | `docs/LOCAL_DEV_SERVER_UEBERGANG_2026-05-21.md` | Lokaler Uebergangsserver auf Entwicklungs-PC | Aktuell bis IIS-Fix |
 | `docs/FINANCE_ENTSCHEIDE.md` | Finance-Regeln und Kontrollpunkte | Aktuell fuehrend fuer Finance-Logik |
 | `entscheide.md` | Kurzfassung der Finance-Fachentscheide | Aktuell als Kurzfassung |
+| `docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md` | Produktsparten-Mapping fuer Group Sales Report | Aktuell fuehrend fuer neues Produktmapping-Thema |
 | `docs/HR_KPI_NACHDOKU_2026-05-13.md` | HR-KPI technische/fachliche Nachdoku | Aktualisiert um 2026-05-20 Erweiterungen |
 | `docs/PROGRAMM_DIAGRAMME.md` | Uebersicht Diagramme und technische Einordnung | Aktualisiert um neue Anwenderdokus |
 

TrafagSalesExporter/docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md

@@ -0,0 +1,89 @@
+# Produktsparten-Mapping Group Sales Report
+
+Stand: 2026-05-27
+
+## Anlass
+
+Fuer die Zuordnung der Artikel aus dem Group Sales Report zu Produktbereichen wurde abgestimmt, die Zuordnung von TR AG als fuehrende Referenz zu verwenden.
+
+Ziel ist, Artikel bzw. Materialnummern aus dem Group Sales Report in einem ersten Schritt folgenden Elementen zuzuordnen:
+
+- Produkthierarchie
+- Produktfamilie
+- Produktsparte
+
+## Vorgeschlagene Fachlogik
+
+1. Materialnummer aus dem Group Sales Report lesen.
+2. Materialnummer gegen Artikelstammdaten der TR AG aufloesen.
+3. Produkthierarchie direkt aus den Artikelstammdaten uebernehmen.
+4. Produktfamilie und Produktsparte anschliessend ueber eine separate Mapping-Tabelle ableiten.
+5. Artikel ohne Treffer in den TR-AG-Stammdaten automatisch unter `Sonstige/ohne Zuordnung` fuehren.
+
+## Mapping-Tabelle
+
+Nach aktuellem Verstaendnis definiert die separate Mapping-Tabelle die Zuordnung von Produktgruppen bzw. Produkthierarchie-Bereichen zu Produktfamilien und Produktsparten.
+
+Moegliche technische Regeln, die fachlich zu bestaetigen sind:
+
+- exakte Codes
+- Prefix-Regeln
+- Von/Bis-Ranges
+- Prioritaet bei ueberlappenden Bereichen
+- Gueltigkeit nach Datum oder Version
+
+Kendra kann laut Aufgabenbeschreibung weitere Details zur bestehenden Logik und zur konkreten Umsetzung geben.
+
+## Aktueller technischer Stand Im Projekt
+
+Im aktuellen Datenmodell existieren bereits:
+
+- `Material`
+- `ProductGroup`
+
+Noch nicht explizit vorhanden sind:
+
+- `Produkthierarchie`
+- `Produktfamilie`
+- `Produktsparte`
+
+Relevante aktuelle Modelle:
+
+- `Models/SalesRecord.cs`
+- `Models/CentralSalesRecord.cs`
+
+Hinweis aus der Code-Sichtung:
+
+- SAP-Seed-Mapping nutzt aktuell `Z.Matnr` fuer `Material`.
+- SAP-Seed-Mapping nutzt aktuell `Z.Prodh` fuer `ProductGroup`.
+- Ob `Z.Prodh` fachlich bereits der gewuenschten Produkthierarchie entspricht, muss bestaetigt werden.
+
+## Empfohlene Umsetzung
+
+Die Produktspartenlogik sollte als eigene sichtbare Mapping-Schicht umgesetzt werden, nicht als versteckte Sonderlogik in Finance oder Management Cockpit.
+
+Sinnvolle technische Bausteine:
+
+- TR-AG-Artikelstamm-Quelle fuer Materialnummer -> Produkthierarchie.
+- Mapping-Tabelle fuer Produkthierarchie/ProductGroup/Range -> Produktfamilie und Produktsparte.
+- Fallback-Kategorie `Sonstige/ohne Zuordnung`.
+- Export-/Excel-Spalten fuer die drei neuen Klassifikationen.
+- Pruefansicht fuer nicht zugeordnete Materialnummern.
+
+## Offene Fragen Fuer Andreas / Kendra
+
+| Frage | Warum wichtig |
+| --- | --- |
+| Woher kommt der fuehrende TR-AG-Artikelstamm technisch? | Datenquelle und Aktualisierung festlegen |
+| Welches Feld ist die eindeutige Materialnummer? | Normalisierung, fuehrende Nullen, Varianten |
+| Ist `Z.Prodh` die gewuenschte Produkthierarchie? | Bestehendes Mapping evtl. wiederverwendbar |
+| Wie sieht die bestehende Mapping-Tabelle aus? | Datenmodell und Importlogik festlegen |
+| Werden Ranges, Prefixe oder exakte Werte verwendet? | Matching-Regeln eindeutig implementieren |
+| Was gilt bei ueberlappenden Ranges? | Prioritaet / deterministisches Ergebnis |
+| Soll die Zuordnung historisiert werden? | Reproduzierbarkeit alter Reports |
+| Soll `Sonstige/ohne Zuordnung` nur im Report erscheinen oder auch in Daten persistiert werden? | Datenmodell und Auditierbarkeit |
+
+## Abgrenzung
+
+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.
+

TrafagSalesExporter/docs/RAG_ROUTER.md

@@ -23,6 +23,7 @@ Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themen
 | Deployment/IIS | Publish, Server, BiDashboard, TLS, lokaler Uebergang | `docs/rag/DEPLOYMENT.md` |
 | Admin/Startseite | Admin Login, Sessions, Landing Page | `docs/rag/ADMIN.md` |
 | Architektur | Systemuebersicht, Diagramme, technische Einordnung | `docs/rag/ARCHITECTURE.md` |
+| Produktmapping | Group Sales Report, Produkthierarchie, Produktfamilie, Produktsparte | `docs/rag/PRODUCT_MAPPING.md` |
 
 ## Rohquellen Nur Bei Bedarf
 
@@ -38,6 +39,7 @@ Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themen
 | `docs/DEPLOYMENT_IIS_HANDOFF_2026-05-19.md` | IIS-/Publish-Details |
 | `docs/LOCAL_DEV_SERVER_UEBERGANG_2026-05-21.md` | lokaler Server im Detail |
 | `docs/ADMIN_BEREICH_STARTSEITE_2026-05-21.md` | Admin-/Landing-Details |
+| `docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md` | Produktsparten-Mapping im Detail |
 
 ## Suchwoerter
 
@@ -50,3 +52,4 @@ Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themen
 | `HR KPI`, `Rexx`, `Austritte`, `Absenzen` | HR KPI |
 | `IIS`, `BiDashboard`, `Publish`, `TLS`, `Client certificate` | Deployment/IIS |
 | `Admin Bereich`, `AdminAccess`, `LandingPage` | Admin/Startseite |
+| `Group Sales Report`, `Produkthierarchie`, `Produktfamilie`, `Produktsparte`, `Z.Prodh` | Produktmapping |

TrafagSalesExporter/docs/rag/ARCHITECTURE.md

@@ -7,9 +7,11 @@ Stand: 2026-05-27
 - App sammelt Daten aus SAP OData, HANA/SAP B1, SharePoint und manuellen Excel-/CSV-Quellen.
 - Zentrale Persistenz ueber `CentralSalesRecords`.
 - Finance-Auswertung und zentrale Excel sollen dieselbe Regelengine verwenden.
+- Produktsparten-Mapping ist als eigene Mapping-Schicht vorgesehen, nicht als versteckte Finance-Regel.
 - Diagramme und Anwenderdokus existieren fuer Keyuser-Prozess und technische Architektur.
 
 ## Rohquellen Nur Bei Bedarf
 
 - Diagramme: `docs/PROGRAMM_DIAGRAMME.md`
+- Produktmapping: `docs/rag/PRODUCT_MAPPING.md`
 - technischer Handoff und alter LLM-Systemkontext: `docs/raw_md_archive/HISTORY_CANONICAL.md.raw`

TrafagSalesExporter/docs/rag/PRODUCT_MAPPING.md

@@ -0,0 +1,32 @@
+# RAG Product Mapping
+
+Stand: 2026-05-27
+
+## Kurzstand
+
+- Neue Anforderung: Artikel aus dem Group Sales Report sollen anhand der TR-AG-Zuordnung klassifiziert werden.
+- Ziel-Felder: `Produkthierarchie`, `Produktfamilie`, `Produktsparte`.
+- Produkthierarchie kommt direkt aus TR-AG-Artikelstammdaten.
+- Produktfamilie und Produktsparte kommen danach ueber separate Mapping-Tabelle.
+- Nicht gefundene Materialnummern laufen unter `Sonstige/ohne Zuordnung`.
+
+## Aktueller Code-Stand
+
+- Vorhanden: `Material`, `ProductGroup`.
+- Noch nicht vorhanden: explizite Felder fuer Produkthierarchie, Produktfamilie, Produktsparte.
+- SAP-Seed-Mapping nutzt aktuell `Z.Matnr` -> `Material` und `Z.Prodh` -> `ProductGroup`.
+- Zu klaeren: Ist `Z.Prodh` fachlich die Produkthierarchie?
+
+## Offene Punkte Fuer Sitzung
+
+- Quelle und Format des TR-AG-Artikelstamms.
+- Normalisierung der Materialnummern.
+- Struktur der Mapping-Tabelle von Kendra.
+- Matching-Regeln: exakt, Prefix, Range, Prioritaet.
+- Historisierung der Zuordnung fuer reproduzierbare Reports.
+- Pruefansicht fuer nicht zugeordnete Artikel.
+
+## Rohquelle Nur Bei Bedarf
+
+- Detaildoku: `docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md`
+

TrafagSalesExporter/docs/rag/PROJECT.md

@@ -13,6 +13,7 @@ Stand: 2026-05-27
 
 - Finance Cockpit: `docs/rag/FINANCE.md`
 - Manual Import: `docs/rag/MANUAL_IMPORT.md`
+- Produktmapping: `docs/rag/PRODUCT_MAPPING.md`
 - HR KPI: `docs/rag/HR_KPI.md`
 - Deployment/IIS: `docs/rag/DEPLOYMENT.md`
 - Admin/Startseite: `docs/rag/ADMIN.md`

TrafagSalesExporter/lastchange.md

@@ -10,6 +10,17 @@ Diese Datei ist fuer tokenarme RAG-Nutzung komprimiert.
 - 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.
+- Neu dokumentiert: Produktsparten-Mapping fuer Group Sales Report ueber TR-AG-Artikelstamm und separate Mapping-Tabelle.
+
+## Nachtrag 2026-05-27 Produktsparten-Mapping
+
+Dokumentiert:
+
+- Neue Detaildoku `docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md`.
+- Neue RAG-Kurzdatei `docs/rag/PRODUCT_MAPPING.md`.
+- Router-Eintrag fuer Themen `Group Sales Report`, `Produkthierarchie`, `Produktfamilie`, `Produktsparte`.
+- Fachliche Annahme: Materialnummern aus Group Sales Report werden gegen TR-AG-Artikelstamm aufgeloest; nicht gefundene Artikel laufen unter `Sonstige/ohne Zuordnung`.
+- Offene Sitzungspunkte: Quelle des Artikelstamms, Bedeutung von `Z.Prodh`, Mapping-Tabelle von Kendra, Range-/Prefix-Regeln, Historisierung.
 
 ## Volltext Bei Bedarf