# RAG Product Mapping

Stand: 2026-05-29

## Kurzstand

- Neue Anforderung: Artikel aus dem Group Sales Report sollen anhand der TR-AG-Zuordnung klassifiziert werden.
- Ziel-Felder: `Produkthierarchie`, `Produktfamilie`, `Produktsparte`.
- SAP TR AG bleibt Quelle der Wahrheit.
- 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`.

## Aktueller Code-Stand

- Vorhanden: `Material`, `ProductGroup`.
- Neu vorhanden in `SalesRecord` und `CentralSalesRecord`:
  - `ProductHierarchyCode`
  - `ProductHierarchyText`
  - `ProductFamilyCode`
  - `ProductFamilyText`
  - `ProductDivisionCode`
  - `ProductDivisionText`
  - `ProductMappingAssigned`
- `CentralSalesRecords` wird per Schema-Maintenance um diese Spalten erweitert.
- Excel-Export fuehrt die neuen Produktfelder im Blatt `Sales` direkt nach `Product Group`.
- SAP-Seed-Mapping nutzt aktuell `Z.Matnr` -> `Material` und `Z.Prodh` -> `ProductGroup`.
- Zu klaeren: Ist `Z.Prodh` fachlich die Produkthierarchie?

## ABAP-Arbeitsstand

- `docs/abap/ZCL_PRODSPARTE_PROVIDER.abap`: Provider fuer ALV und spaeter OData.
- `docs/abap/Z_PRODSPARTE_REPORT.abap`: ALV-Testreport.
- `docs/abap/Z_PRODSPARTE_MAP_BUILD.abap`: baut `ZPRODSPARTE_MAP` aus `CE11000`.
- `docs/abap/README_PRODSPARTE.md`: DDIC- und Pruefhinweise.

## SAP-Zielbild

- `Z_PRODSPARTE_MAP_BUILD` liest reale CO-PA-Ableitungen aus `CE11000`.
- Eindeutige `PAPH1 -> WWPFA -> WWPSP` werden in `ZPRODSPARTE_MAP` gespeichert.
- Mehrdeutige PAPH1 werden protokolliert und nicht geschrieben.
- `ZCL_PRODSPARTE_PROVIDER` liest `MVKE-PRODH`, Texte und Mapping.
- OData-Service ruft dieselbe Provider-Klasse.

## Stand 2026-05-29

- SAP Gateway nutzt bestehenden Service `ZPOWERBI_EINKAUF_SRV`.
- Service Root: `http://travt762.sap.trafag.com:8000/sap/opu/odata/sap/ZPOWERBI_EINKAUF_SRV/`.
- Produktmapping-EntitySet: `ProductDivisionRefSet`.
- Test-Endpoint liefert Daten, z.B. `Matnr=VCP1000`, `Paph1=9999`, `Wwpsp=UNASS`.
- OData-Felder sind CamelCase: `Matnr`, `Paph1`, `Paph1Text`, `Wwpfa`, `WwpfaText`, `Wwpsp`, `WwpspText`, `IsAssigned`.
- Bestehender Sales-EntitySet bleibt `FinanzdataSchweizOeSet`.
- Wichtig: `FINANZDATASCHWEI_GET_ENTITYSET` muss weiter den alten `ZSCHWEIZ`-Select enthalten.
- Produktmapping-Code gehoert in `PRODUCTDIVISIONR_GET_ENTITYSET`.
- Lokale App-Konfiguration fuer Standort `ZSCHWEIZ`:
  - Quelle `Z`: bestehender Sales-EntitySet.
  - Quelle `P`: `ProductDivisionRefSet`.
  - Join: `Z.Matnr = P.Matnr`.
  - Mappings: `P.Paph1`, `P.Paph1Text`, `P.Wwpfa`, `P.WwpfaText`, `P.Wwpsp`, `P.WwpspText`, `P.IsAssigned`.
- Lokale App wurde neu gestartet; `http://localhost:55416/` antwortet mit HTTP 200.
- Validierung: `79/79` Tests gruen mit separatem Artefaktpfad.

## Zentrale Spartenzuordnung

- Neuer Reiter in `Management Analyse`: `Zentrale Spartenzuordnung`.
- Zweck: Materialnummern aller Laender gegen die fuehrende TR-AG-/SAP-Referenz pruefen.
- Lokale ERP-Produktzuordnungen anderer Laender sind nicht fuehrend.
- Statuslogik:
  - Treffer mit zugeordneter TR-AG-Sparte: `Zugeordnet`.
  - Treffer mit `UNASS`/nicht zugeordnet: `Nicht zugeordnet`.
  - Kein Treffer im TR-AG-Stamm: `Nicht im TR-AG-Stamm`.
  - Leere Materialnummer: `Material fehlt`.
- Die Sicht nutzt den bestehenden Finance-Filter fuer Jahr/Land/Waehrung.
- Sie zeigt Kennzahlen, Laenderabdeckung und Detailzeilen mit Land-Material links und TR-AG-Referenz rechts.
- Umsetzung ist eine Analyseansicht, keine persistente Mutation anderer Laenderzeilen.
- Validierung nach Umsetzung: `80/80` Tests gruen.

## Offene Punkte Fuer Sitzung

- 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.
- `PAPH1 = MVKE-PRODH(5)` fachlich/technisch bestaetigen.
- Richtige Texttabellen fuer `WWPFA`/`WWPSP` bestaetigen.
- VKORG/VTWEG fuer TR-AG-Referenzlauf bestaetigen.
- Standort `ZSCHWEIZ` im Export Dashboard neu laufen lassen und Fuellung der neuen Produktfelder pruefen.
- Treffer-/Fehlerquote im Reiter `Zentrale Spartenzuordnung` pruefen.

## Rohquelle Nur Bei Bedarf

- Detaildoku: `docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md`