From b5e0545fbfcde9ab6793a883905adddf17433838 Mon Sep 17 00:00:00 2001 From: metacube Date: Wed, 20 May 2026 09:43:29 +0200 Subject: [PATCH] Add keyuser process SVG --- TrafagSalesExporter/NEXT_STEPS_2026-04-15.md | 25 +- .../docs/KEYUSER_PROZESSDOKU_2026-05-20.svg | 279 ++++++++++++++++++ TrafagSalesExporter/lastchange.md | 13 + 3 files changed, 315 insertions(+), 2 deletions(-) create mode 100644 TrafagSalesExporter/docs/KEYUSER_PROZESSDOKU_2026-05-20.svg diff --git a/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md b/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md index eaabb1a..0a0f9d4 100644 --- a/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md +++ b/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md @@ -2,6 +2,27 @@ Stand: 2026-05-20 +## Nachtrag 2026-05-20 Keyuser Prozess-SVG + +Erstellt: + +```text +docs/KEYUSER_PROZESSDOKU_2026-05-20.svg +``` + +Zielgruppe: + +- Finance Keyuser / Poweruser. + +Inhalt: + +- Vorbereitung in Settings und Standorte. +- Manual-Excel-Dateien fuer UK/ES/DE. +- Einzelstandortexport, Export aller Standorte und zentrale Excel. +- Finance-Filter im Endexcel. +- Soll/Ist Vergleich, Management Analyse, Logs. +- Fehlerbehandlung und fachliche Freigabe. + ## Nachtrag 2026-05-20 Technische Architektur-SVG Erstellt: @@ -19,9 +40,9 @@ Abgrenzung: - Nur produktive Applikation. - Keine Testapp, Probe-Tools oder temporaeren Analyseprogramme. -Naechster geplanter Schritt: +Status: -- Separate Keyuser-Prozessdoku als zweite SVG erstellen: was wann in der App zu tun ist, inklusive Import, Standortexport, zentraler Excel, Finance-Pruefung und offener fachlicher Rueckfragen. +- Keyuser-Prozessdoku wurde als separate SVG erstellt. ## Nachtrag 2026-05-20 DE Alphaplan-Excel provisorisch eingebaut diff --git a/TrafagSalesExporter/docs/KEYUSER_PROZESSDOKU_2026-05-20.svg b/TrafagSalesExporter/docs/KEYUSER_PROZESSDOKU_2026-05-20.svg new file mode 100644 index 0000000..8511a5a --- /dev/null +++ b/TrafagSalesExporter/docs/KEYUSER_PROZESSDOKU_2026-05-20.svg @@ -0,0 +1,279 @@ + + + + + + + + + + + + + Keyuser-Prozessdoku - Finance Export, zentrale Excel und Kontrolle + Stand 2026-05-20 | Zielgruppe: Finance Keyuser / Poweruser | Fokus: was wann in der App tun, nicht technische Implementierung + + + Kurzprinzip + 1. Einstellungen und Standorte pflegen -> 2. Länder-/Standortdaten importieren/exportieren -> 3. zentrale Excel erzeugen -> 4. Finance Soll/Ist prüfen -> 5. offene fachliche Abgrenzungen klären. + Die zentrale Excel und das Finance Cockpit verwenden dieselbe Basis: CentralSalesRecords. Für Finance immer die Spalten `Finance | ...` bzw. den Reiter `Soll/Ist Vergleich` verwenden. + + + + A. Vorbereitung / Stammdaten + + + B. Import und Export ausführen + + + C. Kontrolle und Finance-Abgleich + + + D. Fehler / Freigabe / Betrieb + + + + + 1 + Settings prüfen + Export Einstellungen öffnen + Datum-Filter ab z.B. 2025-01-01 + Timer nur aktivieren, wenn automatischer Lauf gewünscht ist + SharePoint nur bei vollständigen Credentials nutzen + + + + 2 + Standorte pflegen + Admin -> Standorte + aktive Länder kontrollieren + TSC, Land, SourceSystem prüfen + HANA/SAP: Schema, EntitySet, Mapping + Manual Excel: Datei/Pfad und Mapping + + + + 3 + Manual Excel Länder vorbereiten + UK: Sage Excel / SharePoint-Ordner UK_B1 + ES: Sage CSV / Manual Excel + DE: Alphaplan Excel, Datei hochladen oder Pfad setzen + nach Datei setzen: Header laden / Mapping prüfen + Standort erst aktivieren, wenn Datei erreichbar ist + + + + 4 + Optional: Transformationen + Admin -> Transformationen + nur ändern, wenn Feld-/Währungslogik bekannt ist + bestehende Regeln nicht spontan löschen + Änderung danach mit Einzelstandort testen + + + + 5 + Vor dem Lauf kurz prüfen + Sind die richtigen Standorte aktiv? + Sind manuelle Dateien aktuell? + Ist Datum-Filter korrekt? + SharePoint Upload gewünscht und konfiguriert? + Bei Unsicherheit zuerst Einzelstandort ausführen + + + + + 6 + Einzelstandort exportieren + Export Dashboard öffnen + Land/Standort starten + Statusmeldungen beobachten + bei Manual Excel wird Datei gelesen und gespeichert + + + + 7 + Was beim Standortexport passiert + Quelle wird gelesen: HANA, SAP OData oder Excel/CSV + Mapping/Transformationen werden angewendet + CentralSalesRecords für diesen Standort wird ersetzt + Standortdatei und Logs werden geschrieben + optional SharePoint Upload + + + + 8 + Alle Standorte exportieren + nur verwenden, wenn aktive Standorte bereit sind + läuft Standort für Standort + danach wird zentrale Excel automatisch erzeugt + bei Fehler: Logs prüfen und Einzelstandort wiederholen + + + + 9 + Zentrale Excel erzeugen + Button zentrale Datei / konsolidierter Export + liest alle CentralSalesRecords + erstellt Sales_All_yyyy-MM-dd.xlsx + enthält Blatt Sales und Finance Filter Hilfe + + + + 10 + Endexcel richtig filtern + Blatt Sales verwenden + Finance | Year = gewünschtes Jahr + Finance | Country Key = Land, z.B. IT oder DE + Finance | Include = TRUE + Finance | Net Sales Actual summieren + + + + + 11 + Soll/Ist Vergleich öffnen + Finance Cockpit -> Soll/Ist Vergleich + Jahr 2025 prüfen + Spalten: Ist, Soll, Differenz, Währung + Status OK/Prüfen beachten + + + + 12 + Management Analyse nutzen + für Plausibilität je Land/Jahr/Monat + Summenfeld bewusst wählen + zentrale Roh-Auswertung arbeitet auf CentralSalesRecords + bei Einzeldatei: Land/TSC Filter übernehmen + keine fachliche Freigabe nur aus Rohsummen ableiten + + + + 13 + Länderspezifische Prüfpunkte + IT: Trafag Italia ausgeschlossen + IT: doppelte Zeilen ohne Supplier country nur einmal + DE: Alphaplan, Kundenländer noch fachlich offen + UK/ES: Sage-Dateien, Gutschriften negativ + CH/AT: SAP OData DACH-Abgrenzung + + + + 14 + Excel gegen Cockpit abgleichen + Endexcel: Finance-Spalten filtern + Soll/Ist Vergleich: gleiche Land/Jahr-Sicht + Summen sollten gleich sein + Abweichung dokumentieren, nicht manuell korrigieren + + + + 15 + Freigabe vorbereiten + zentrale Excel ablegen/teilen + offene Länder markieren + Finance-Leiter entscheidet fachliche Regel + erst danach Regel fixieren + + + + + 16 + Wenn Export fehlschlägt + Logs öffnen + technische Fehlermeldung kopieren + bei Manual Excel: Pfad/Datei/Mapping prüfen + bei SAP/HANA: Verbindung/Schema/EntitySet prüfen + + + + 17 + Wenn zentrale Excel fehlt + prüfen, ob CentralSalesRecords vorhanden sind + mindestens ein Standort muss erfolgreich gelaufen sein + lokaler zentraler Pfad in Settings prüfen + SharePoint Upload separat von lokaler Erzeugung prüfen + Logs und AppEventLogs lesen + + + + 18 + Wenn Soll/Ist nicht passt + nicht direkt Code oder Excel manuell ändern + Quelle, Filter, Datum, Währung prüfen + Landesspezifische Regeln dokumentieren + Finance-Leiter um Bestätigung bitten + erst danach Mapping/Regel produktiv anpassen + + + + 19 + Betrieb / Server + IIS 500: Serveradmin/Event Viewer + .NET 8 Hosting Bundle prüfen + App Pool Rechte auf DB/logs prüfen + Microsoft Excel ist auf Server nicht nötig + + + + 20 + Monats-/Jahresabschluss + Exportdatum und Dateiversion notieren + offene Länder in Mail/Teams aufführen + freigegebene Regeln nicht rückwirkend überschreiben + neue Fachentscheide nachdokumentieren + + + + + + + + + + + + + + + Keyuser-Merksatz und offene Fachpunkte + Nie direkt Rohspalten wie `Sales Price/Value`, `Document Total LC` oder lokale Excel-Summen vergleichen, wenn es um CFO/Finance geht. Fuer den Abgleich immer `Soll/Ist Vergleich` oder im Endexcel die `Finance | ...`-Spalten nutzen. + DE offen: Alphaplan liefert `NettoPreisGesamtX`, aber Kundenländer/Filter müssen von Munir/Finance bestätigt werden. IT bestätigt: Trafag Italia ausschliessen und Blank-Supplier-Dubletten nur einmal zählen. + Bei Fehlern: Screenshot/Fehlertext, betroffener Standort, Uhrzeit, Datei/Pfad und letzter Schritt notieren. Danach Logs prüfen und erst dann technische Anpassung beauftragen. + + + + Vorbereitung + + Ausführen + + Prüfen + + Fehler/Fachentscheid + Quelle: App-Navigation, Services und aktuelle Finance-Doku, Stand 2026-05-20 + diff --git a/TrafagSalesExporter/lastchange.md b/TrafagSalesExporter/lastchange.md index 45d2927..ec9a519 100644 --- a/TrafagSalesExporter/lastchange.md +++ b/TrafagSalesExporter/lastchange.md @@ -1,5 +1,18 @@ # Last Change 2026-05-04 +## Keyuser Prozessdoku SVG 2026-05-20 + +Erstellt: + +- `docs/KEYUSER_PROZESSDOKU_2026-05-20.svg` + +Inhalt: + +- Prozess von Vorbereitung ueber Standortexport, zentrale Excel und Finance-Soll/Ist bis Fehlerbehandlung. +- Fokus auf Keyuser-Aktionen in der App: Settings, Standorte, Export Dashboard, Management Analyse, Soll/Ist Vergleich, Logs. +- Enthaltene Fachpunkte: Manual Excel fuer UK/ES/DE, DE Alphaplan, IT-Sonderregel, Finance-Spalten im Endexcel. +- Technische Implementierungsdetails und Testprogramme sind bewusst ausgeklammert. + ## Technische Systemarchitektur SVG 2026-05-20 Erstellt: