From a3ab38a7c05ab608f83cccf9ebdbc64ff75afb71 Mon Sep 17 00:00:00 2001 From: metacube Date: Wed, 27 May 2026 10:25:32 +0200 Subject: [PATCH] Document product division mapping task --- .../docs/MD_DOKUMENTENSTATUS_2026-05-20.md | 1 + .../PRODUCT_SPARTEN_MAPPING_2026-05-27.md | 89 +++++++++++++++++++ TrafagSalesExporter/docs/RAG_ROUTER.md | 3 + TrafagSalesExporter/docs/rag/ARCHITECTURE.md | 2 + .../docs/rag/PRODUCT_MAPPING.md | 32 +++++++ TrafagSalesExporter/docs/rag/PROJECT.md | 1 + TrafagSalesExporter/lastchange.md | 11 +++ 7 files changed, 139 insertions(+) create mode 100644 TrafagSalesExporter/docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md create mode 100644 TrafagSalesExporter/docs/rag/PRODUCT_MAPPING.md diff --git a/TrafagSalesExporter/docs/MD_DOKUMENTENSTATUS_2026-05-20.md b/TrafagSalesExporter/docs/MD_DOKUMENTENSTATUS_2026-05-20.md index 38e2758..0334533 100644 --- a/TrafagSalesExporter/docs/MD_DOKUMENTENSTATUS_2026-05-20.md +++ b/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 | diff --git a/TrafagSalesExporter/docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md b/TrafagSalesExporter/docs/PRODUCT_SPARTEN_MAPPING_2026-05-27.md new file mode 100644 index 0000000..537c29b --- /dev/null +++ b/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. + diff --git a/TrafagSalesExporter/docs/RAG_ROUTER.md b/TrafagSalesExporter/docs/RAG_ROUTER.md index 1be2e13..3c3f458 100644 --- a/TrafagSalesExporter/docs/RAG_ROUTER.md +++ b/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 | diff --git a/TrafagSalesExporter/docs/rag/ARCHITECTURE.md b/TrafagSalesExporter/docs/rag/ARCHITECTURE.md index 93330b2..97e11c2 100644 --- a/TrafagSalesExporter/docs/rag/ARCHITECTURE.md +++ b/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` diff --git a/TrafagSalesExporter/docs/rag/PRODUCT_MAPPING.md b/TrafagSalesExporter/docs/rag/PRODUCT_MAPPING.md new file mode 100644 index 0000000..a920088 --- /dev/null +++ b/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` + diff --git a/TrafagSalesExporter/docs/rag/PROJECT.md b/TrafagSalesExporter/docs/rag/PROJECT.md index 31ad7d5..0b9ad11 100644 --- a/TrafagSalesExporter/docs/rag/PROJECT.md +++ b/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` diff --git a/TrafagSalesExporter/lastchange.md b/TrafagSalesExporter/lastchange.md index f1edde1..4de65ce 100644 --- a/TrafagSalesExporter/lastchange.md +++ b/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