Update markdown documentation status

2026-05-20 15:50:59 +02:00
parent a044040ada
commit 83acd5a148
10 changed files with 248 additions and 14 deletions
@@ -1,6 +1,40 @@
 # TrafagSalesExporter Handoff

-Stand: 2026-05-05
+Stand: 2026-05-20
+
+## Aktueller Handoff-Zusatz 2026-05-20
+
+Seit den aelteren Handoff-Eintraegen wurden folgende Punkte umgesetzt und dokumentiert:
+
+- `Management Analyse` hat einen fuehrenden Reiter `Finance Summary`.
+- Finance Summary nutzt dieselbe `FinanceRuleEngine` wie das zentrale Excel-Blatt `Finance Summary`.
+- Filter fuer Jahr, Land und Waehrung wirken auf das Finance-Endergebnis.
+- DE 2026 wirft keinen Fehler mehr, sondern zeigt wegen DE/Alphaplan-2025-Zwang einen leeren Zustand mit Hinweis.
+- HR KPI Cockpit wurde erweitert:
+  - Anleitung-Reiter
+  - Datenordner anpassbar
+  - Dateifrische / Datenstatus
+  - Ampeln
+  - Periodenvergleich
+  - Datenqualitaet
+  - Austritte nach Typ/Organisation
+  - Absenzen nach Organisation / Top-Absenzen
+  - Managementsicht
+  - Drucken/PDF
+- Anwenderdokus:
+  - `docs/HR_KPI_ANLEITUNG_HR_2026-05-20.docx`
+  - `docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx`
+- Markdown-Dokumentenstatus:
+  - `docs/MD_DOKUMENTENSTATUS_2026-05-20.md`
+
+Validierung:
+
+- `dotnet test TrafagSalesExporter.sln --verbosity minimal`
+- Ergebnis am 2026-05-20: `77/77` Tests gruen.
+
+Hinweis:
+
+- Aeltere Abschnitte in diesem Handoff bleiben als Historie erhalten. Fuer aktuellen Status immer zuerst diesen Zusatz, `NEXT_STEPS_2026-04-15.md`, `lastchange.md` und `docs/MD_DOKUMENTENSTATUS_2026-05-20.md` lesen.

 ## Nachtrag 2026-05-11 UK_B1 Mapping / aktueller Arbeitsstand

@@ -2,6 +2,26 @@

 Stand: 2026-05-20

+## Nachtrag 2026-05-20 Dokumentation bereinigt
+
+Erledigt:
+
+- Markdown-Bestand eingeordnet in `docs/MD_DOKUMENTENSTATUS_2026-05-20.md`.
+- HR-Anwenderdoku als Word-Datei optisch ueberarbeitet:
+  - `docs/HR_KPI_ANLEITUNG_HR_2026-05-20.docx`
+  - inklusive 10 neuer HR-Cockpit-Punkte, Tabellen, Hinweisboxen und Vorschaugrafik.
+- Finance-Anwenderdoku als Word-Datei optisch ueberarbeitet:
+  - `docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx`
+  - inklusive Finance Summary Workflow, Filterregeln und Pruefpunkten.
+- Neue neutrale Vorschaubilder fuer die Word-Dokus:
+  - `docs/hr_kpi_cockpit_preview.png`
+  - `docs/finance_cockpit_preview.png`
+
+Bewusst nicht geloescht:
+
+- Alte Markdown-Dateien und alte Eintraege bleiben erhalten, wenn sie Pruefwerte, Zwischenentscheide, Mailkontext oder Audit-Spuren enthalten.
+- Nicht mehr fuehrende Dateien sind in `docs/MD_DOKUMENTENSTATUS_2026-05-20.md` als historisch markiert.
+
 ## Nachtrag 2026-05-20 Workflow-Fixes nach Review

 Umgesetzt:
@@ -1,6 +1,14 @@
 # Finance Dashboard Todo

-Stand: 2026-05-15
+Stand: 2026-05-20
+
+Hinweis:
+
+Dieses Dokument ist eine historische Todo-Liste vom 2026-05-15 und wurde am 2026-05-20 nachgezogen. Fuer den aktuell fuehrenden Dokumentenstatus siehe:
+
+```text
+docs/MD_DOKUMENTENSTATUS_2026-05-20.md
+```

 Ziel: Aufbau eines modernen, uebersichtlichen Intranet-Dashboards fuer das Group Sales Reporting, zugaenglich fuer alle freigegebenen Benutzer.

@@ -8,18 +16,18 @@ Ziel: Aufbau eines modernen, uebersichtlichen Intranet-Dashboards fuer das Group

 | Prio | Aufgabe | Status |
 | --- | --- | --- |
-| 1 | Fuehrendes CFO-Dokument verwenden: `FINANCE_CHEF_SUMMARY_2026-05-15.docx` | Offen |
+| 1 | Fuehrendes CFO-Dokument verwenden: `FINANCE_CHEF_SUMMARY_2026-05-15.docx` | Historisch; neue Anwenderdoku `FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx` ergaenzt |
 | 1 | Offene Finance-Entscheide mit Andreas/Finance durchgehen | Offen |
-| 1 | Italien-Abweichung klaeren: Berechnungsart, Deduplizierung, Intercompany | Offen |
-| 1 | Italien IC-Diagnose besprechen: Trafag, Magnetic Sense/Magnets Sense und Gesellschaft fuer Sensorik erklaeren einen grossen Teil, aber nicht die ganze Abweichung | Offen |
-| 1 | Deutschland: finalen Jahresfile 2025 beschaffen | Offen |
-| 2 | UK/England: Jahresvollstaendigkeit und Restdifferenz pruefen | Offen |
+| 1 | Italien-Abweichung klaeren: Berechnungsart, Deduplizierung, Intercompany | Teilweise geklaert; Finance-Leiter bestaetigte Methode, Restdifferenz dokumentiert |
+| 1 | Italien IC-Diagnose besprechen: Trafag, Magnetic Sense/Magnets Sense und Gesellschaft fuer Sensorik erklaeren einen grossen Teil, aber nicht die ganze Abweichung | Historisch; neue IT-Methode verwendet `CustomerName` Trafag Italia und Dublettenregel |
+| 1 | Deutschland: finalen Jahresfile 2025 beschaffen | Erledigt technisch; DE Alphaplan ist eingebaut, Fachabgrenzung Kundenlaender bleibt offen |
+| 2 | UK/England: Jahresvollstaendigkeit und Restdifferenz pruefen | Teilweise erledigt; UK ist Sage/Manual Excel, Mapping korrigiert, Restdifferenz klein/offen |
 | 2 | CH/AT: Sollzuordnung und Trennung final bestaetigen | Offen |
 | 2 | Spanien und Oesterreich: kleinere Differenzen klaeren | Offen |
 | 2 | Intercompany-/2nd-party-Kundenliste final definieren | Offen |
 | 3 | Budgetkurse je Jahr als Quelle festlegen | Offen |
-| 3 | Dashboard-Sicht fuer CFO: nur Laender mit Abweichung und Handlungsbedarf anzeigen | In Arbeit |
-| 3 | Detailansicht je Land mit Berechnungsart und Pruefspur behalten | In Arbeit |
+| 3 | Dashboard-Sicht fuer CFO: nur Laender mit Abweichung und Handlungsbedarf anzeigen | In Arbeit; Finance Summary und Soll/Ist Sicht vorhanden |
+| 3 | Detailansicht je Land mit Berechnungsart und Pruefspur behalten | In Arbeit; Rohdaten-/Diagnosereiter bleibt erhalten |
 | 3 | Freigabe-/Berechtigungskonzept fuer Intranet-Dashboard klaeren | Offen |

 ## Naechster Termin
@@ -1,6 +1,27 @@
 # Finance-Entscheide fuer Net Sales Actuals

-Stand: 2026-05-11
+Stand: 2026-05-20
+
+## Nachtrag 2026-05-20 Finance Summary / Management Analyse
+
+Aktueller Produktstand:
+
+- Das zentrale Excel enthaelt das Blatt `Finance Summary`.
+- `Management Analyse` hat einen fuehrenden Reiter `Finance Summary`.
+- Dieser Reiter nutzt dieselbe `FinanceRuleEngine` wie das zentrale Excel.
+- Filter fuer Jahr, Land und Waehrung wirken auf das Finance-Endergebnis.
+- Die alte Management-/Rohdatenansicht bleibt nur als Diagnose-/Plausibilitaetssicht erhalten.
+- DE 2026 zeigt keinen Fehler mehr, sondern wegen DE/Alphaplan-2025-Zwang einen leeren Zustand mit Hinweis.
+
+Anwenderdoku:
+
+- `docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx`
+- `docs/finance_cockpit_preview.png`
+
+Validierung:
+
+- `dotnet test TrafagSalesExporter.sln --verbosity minimal`
+- Ergebnis: `77/77` Tests gruen.

 Dieses Dokument haelt die fachlichen Entscheide fuer den Finance-Abgleich fest. Es ist die verbindliche Grundlage fuer das Testprogramm, die zentrale Tabelle und den Soll/Ist-Abgleich gegen `check.xlsx`.

@@ -1,10 +1,28 @@
 # Finance: Welches Dokument gilt?

-Stand: 2026-05-15
+Stand: 2026-05-20
+
+## Aktueller Nachtrag 2026-05-20
+
+Zum alten CFO-/Finance-Termin-Dokument ist eine neue Anwenderdoku fuer das Cockpit hinzugekommen:
+
+```text
+docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx
+```
+
+Diese neue Word-Datei ist die bessere Anleitung fuer Finance-Anwender im Cockpit. Das CFO-Dokument vom 2026-05-15 bleibt historische Termin-/Entscheidgrundlage.
+
+Technisch/fachlich aktuell fuehrend:
+
+- `Management Analyse` Reiter `Finance Summary`
+- zentrale Excel `Finance Summary`
+- `FinanceRuleEngine`
+- `docs/FINANCE_ENTSCHEIDE.md`
+- `docs/MD_DOKUMENTENSTATUS_2026-05-20.md`

 ## Fuehrendes Dokument

-Fuer den CFO-/Finance-Termin gilt:
+Fuer den CFO-/Finance-Termin vom 2026-05-15 galt:

 ```text
 docs/FINANCE_CHEF_SUMMARY_2026-05-15.docx
@@ -1,5 +1,32 @@
 # HR KPI Nachdokumentation 2026-05-13

+## Nachtrag 2026-05-20 HR KPI Cockpit Ausbau
+
+Die urspruengliche HR-KPI-Doku wurde um den produktiven Cockpit-Ausbau ergaenzt.
+
+Neu bzw. erweitert:
+
+- `Anleitung`-Reiter im HR KPI Cockpit.
+- Datenordner fuer Rexx-/SAP-Dateien ist im Cockpit sichtbar und je Lauf anpassbar; dauerhaft ueber `HrKpi:DataFolder`.
+- Dateistatus zeigt Pfad, Zeilenanzahl, letzte Aenderung, Dateialter und Frischebewertung.
+- Managementsicht anonymisiert Personennamen in Detailtabellen.
+- Ampel-Reiter fuer Fluktuation, Krankenquote, GLZ, Restferien und Datenqualitaet.
+- Filter fuer GLZ-Ampel und Restferien-Ampel.
+- Periodenvergleich fuer wichtige Kennzahlen, soweit Daten vorhanden sind.
+- Datenqualitaets-Hinweise fuer fehlende/alte Dateien und auffaellige Werte.
+- Austritte nach Austrittsart und Organisation.
+- Absenzen nach Organisation, Top-Absenzen und Drucken/PDF.
+
+Anwenderdoku:
+
+- `docs/HR_KPI_ANLEITUNG_HR_2026-05-20.docx`
+- `docs/hr_kpi_cockpit_preview.png`
+
+Validierung:
+
+- `dotnet test TrafagSalesExporter.sln --verbosity minimal`
+- Ergebnis: `77/77` Tests gruen.
+
 ## Ziel

 Das HR KPI Cockpit wurde als separater, fachlich entkoppelter Reiter umgesetzt. Es nutzt PowerBI-M-/DAX-Logik nicht als generischen Interpreter, sondern als fachliche Vorlage, die in nachvollziehbare C#-Logik uebertragen wurde.
@@ -0,0 +1,62 @@
+# Markdown-Dokumentenstatus
+
+Stand: 2026-05-20
+
+Diese Datei ordnet die vorhandenen Markdown-Dateien ein. Ziel ist, alte Arbeitsnotizen nicht mit dem aktuellen Produktstand zu verwechseln.
+
+## Aktuell fuehrend
+
+| Datei | Rolle | Status |
+| --- | --- | --- |
+| `lastchange.md` | Laufende Aenderungshistorie | Fuehrend fuer Chronologie |
+| `NEXT_STEPS_2026-04-15.md` | Aktuelle offene Punkte und naechste Schritte | Weiter pflegen |
+| `HANDOFF_2026-04-15.md` | Technischer Handoff / Kontext fuer Weiterarbeit | Weiter pflegen |
+| `docs/DEPLOYMENT_IIS_HANDOFF_2026-05-19.md` | IIS-/Server-Handoff | Aktuell fuer Deployment |
+| `docs/FINANCE_ENTSCHEIDE.md` | Finance-Regeln und Kontrollpunkte | Aktuell fuehrend fuer Finance-Logik |
+| `entscheide.md` | Kurzfassung der Finance-Fachentscheide | Aktuell als Kurzfassung |
+| `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 |
+
+## Aktuell als Detail-/Spezialdoku
+
+| Datei | Rolle | Status |
+| --- | --- | --- |
+| `docs/FINANCE_BERECHNUNGSFORMELN_LAENDER_2026-05-19.md` | Detailregeln je Land | Behalten |
+| `docs/FINANCE_HANDOFF_2026-05-18.md` | Finance-Handoff vor den 20.05.-Aenderungen | Behalten, mit neueren Nachtraegen lesen |
+| `docs/FINANCE_IT_VORGEHEN_2026-05-18.md` | Italien-Pruefpfad | Behalten |
+| `docs/FINANCE_UK_QUELLE_KORREKTUR_2026-05-18.md` | UK-Quellkorrektur | Behalten |
+| `docs/HR_KPI_PRUEFUNG_SWISS_BEST_PRACTICES.md` | HR-KPI Formel-/Best-Practice-Pruefung | Behalten |
+| `SAGE_SPAIN_EXPORT_2026-05-05.md` | Sage Spanien Export | Behalten |
+| `LLM_SYSTEM_GUIDE.md` | Arbeits-/Systemkontext fuer LLM | Behalten |
+| `persona.md` | Nutzer-/Projektkontext | Behalten |
+
+## Historisch / nicht mehr fuehrend
+
+Diese Dateien bleiben aus Nachvollziehbarkeitsgruenden erhalten, sind aber nicht mehr als aktueller Stand zu lesen:
+
+| Datei | Grund |
+| --- | --- |
+| `docs/FINANCE_DASHBOARD_TODO_2026-05-15.md` | Urspruengliche Todo-Liste; Status wurde am 2026-05-20 aktualisiert |
+| `docs/FINANCE_WELCHES_DOKUMENT_GILT_2026-05-15.md` | CFO-Dokumentenstand vom 15.05.; Anwenderdoku vom 20.05. ist hinzugekommen |
+| `docs/FINANCE_ES_MAIL_ABWEICHUNG_2026-05-15.md` | Mail-/Abweichungsnotiz |
+| `docs/FINANCE_IT_MAIL_ABWEICHUNG_2026-05-15.md` | Mail-/Abweichungsnotiz |
+| `docs/FINANCE_UK_MAIL_ABWEICHUNG_2026-05-15.md` | Mail-/Abweichungsnotiz |
+
+## Neue Word-/Bilddokumente seit 2026-05-20
+
+| Datei | Zweck |
+| --- | --- |
+| `docs/HR_KPI_ANLEITUNG_HR_2026-05-20.docx` | Anwenderdoku fuer HR |
+| `docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx` | Anwenderdoku fuer Finance |
+| `docs/hr_kpi_cockpit_preview.png` | neutrale HR-Cockpit-Vorschaugrafik fuer DOCX |
+| `docs/finance_cockpit_preview.png` | neutrale Finance-Cockpit-Vorschaugrafik fuer DOCX |
+
+## Bereinigung
+
+Es wurden keine alten Markdown-Dateien geloescht. Grund: Viele enthalten historische Pruefwerte, Zwischenentscheide und konkrete Pfade, die fuer Rueckfragen oder Audits noch relevant sein koennen.
+
+Stattdessen gilt:
+
+- Aktuelle operative Orientierung ueber diese Statusdatei, `NEXT_STEPS_2026-04-15.md`, `HANDOFF_2026-04-15.md` und `lastchange.md`.
+- Historische Mail-/Terminnotizen nur als Beleg lesen, nicht als aktuellen Produktstand.
+- Alte offene Punkte wurden dort aktualisiert, wo sie durch Finance Summary, HR KPI Cockpit oder die Word-Anleitungen ueberholt sind.
@@ -1,5 +1,18 @@
 # Programm-Diagramme

+Stand: 2026-05-20
+
+## Nachtrag Anwenderdokus 2026-05-20
+
+Neben den technischen SVG-Diagrammen gibt es jetzt zwei gestaltete Word-Anleitungen mit eingebetteten neutralen Cockpit-Vorschaugrafiken:
+
+- `docs/HR_KPI_ANLEITUNG_HR_2026-05-20.docx`
+- `docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx`
+- `docs/hr_kpi_cockpit_preview.png`
+- `docs/finance_cockpit_preview.png`
+
+Die Word-Dokus sind fuer Anwender gedacht. Die SVG-/Markdown-Dokumente bleiben fuer technische Nachvollziehbarkeit, Architektur und Pruefpfade.
+
 ## Empfohlene Diagrammarten

 Fuer das Programm bieten sich zwei Diagrammarten an:
@@ -1,6 +1,17 @@
 # Finance Entscheide Soll/Ist 2025

-Stand: 2026-05-15
+Stand: 2026-05-20
+
+## Nachtrag 2026-05-20
+
+Diese Kurzfassung bleibt gueltig fuer die Finance-Fachentscheide. Fuer den aktuellen Cockpit-/Anwenderstand gelten zusaetzlich:
+
+- `Management Analyse` fuehrt jetzt mit dem Reiter `Finance Summary`.
+- `Finance Summary` verwendet dieselbe `FinanceRuleEngine` wie das zentrale Excel.
+- Filter fuer Jahr, Land und Waehrung wirken auf das Finance-Endergebnis.
+- DE 2026 wird wegen DE/Alphaplan-2025-Zwang als leerer Zustand mit Hinweis dargestellt.
+- Anwenderdoku: `docs/FINANCE_COCKPIT_ANLEITUNG_FINANZ_2026-05-20.docx`.
+- Dokumentenstatus: `docs/MD_DOKUMENTENSTATUS_2026-05-20.md`.

 Dieses Dokument extrahiert die erkennbaren Fragen und Entscheide aus der Abstimmung. Es dient als Arbeitsgrundlage fuer die Umsetzung im Finance-Abgleich und fuer die naechste Klaerung mit Andreas/Finance.

@@ -53,4 +64,3 @@ Bewertung:
 | Italien | Abgrenzung mit/ohne Intercompany fachlich gegen Rhino/check.xlsx pruefen. |
 | Budgetkurse | Quelle und Gueltigkeit der Budgetkurse je Jahr festlegen. |
 | Gutschriften | Sicherstellen, dass alle Quellsysteme Gutschriften mit eigener Rechnungsnummer/Position liefern oder sauber markierbar sind. |
-
@@ -1,5 +1,26 @@
 # Last Change 2026-05-04

+## Markdown-Doku und Anwenderdokus nachgezogen 2026-05-20
+
+Geaendert:
+
+- Neue zentrale Markdown-Uebersicht `docs/MD_DOKUMENTENSTATUS_2026-05-20.md` erstellt.
+- Markdown-Dateien werden dort als aktuell fuehrend, Detaildoku oder historisch eingeordnet.
+- Alte Markdown-Dateien wurden nicht geloescht, weil sie Pruefwerte, Zwischenentscheide und Audit-Spuren enthalten.
+- HR- und Finance-Word-Anleitungen wurden visuell ueberarbeitet:
+  - Titelbereich
+  - Tabellen
+  - Hinweisboxen
+  - eingebettete neutrale Cockpit-Vorschaugrafiken
+- Neue Bilddateien:
+  - `docs/hr_kpi_cockpit_preview.png`
+  - `docs/finance_cockpit_preview.png`
+
+Commits:
+
+- `0bff161 Document HR cockpit feature list`
+- `a044040 Improve cockpit user guide documents`
+
 ## Management Analyse auf Finance Summary ausgerichtet 2026-05-20

 Geaendert: