Document finance workflow and security toggle

2026-05-19 14:26:04 +02:00
parent b23f73ecd6
commit 383796df87
7 changed files with 358 additions and 3 deletions
@@ -25,6 +25,85 @@ docs/it_cache_2025.csv
 docs/spain_cache_2025.csv
 ```

+## Nachtrag 2026-05-19
+
+Nach diesem Handoff wurden noch vier relevante Schritte umgesetzt und committed:
+
+1. Haupt-App-Finance-Vergleich an FinanceProbe angeglichen.
+2. Leere Ist-Zeilen ohne belastbaren Ist-Wert aus dem Finance-Vergleich gefiltert.
+3. Berechnungsformeln je Land dokumentiert.
+4. Finance Cockpit mit separatem Login technisch geschuetzt; fachliche/produktive Abnahme noch offen.
+
+Wichtige neue Doku:
+
+```text
+docs/FINANCE_BERECHNUNGSFORMELN_LAENDER_2026-05-19.md
+```
+
+Diese Datei beschreibt die aktuell verwendete Soll/Ist-Logik fuer `/finance-cockpit/vergleich` und `/finance`, inklusive Jahresfilter, Kandidatenberechnung, Deduplizierung, bevorzugter Ist-Variante und landesspezifischer Quellen/Formeln.
+
+Neue Finance-Cockpit-Sperre, Stand technisch:
+
+- `FinanceCockpitAccessService`
+- `FinanceCockpitAccessOptions`
+- `FinanceCockpitUnlockPanel`
+- Konfiguration in `appsettings.json` unter `FinanceCockpitAccess`
+- DI-Registrierung in `Program.cs`
+- Route-/Navigation-Schutz in `Routes.razor` und `NavMenu.razor`
+
+Wichtig: Der HR-KPI-Login bleibt separat. Die neue Sperre betrifft das Finance Cockpit und laeuft wie HR-KPI ueber Benutzername plus SHA-256-Passwort-Hash. Finance hat ein eigenes Passwort:
+
+```text
+Benutzer: finance
+Passwort: Trafag-Finance-Cockpit-2026!
+```
+
+AD-/Rollenpruefung ist fuer den Moment nicht geloescht, sondern in `appsettings.json` mit `Security.Enabled = false` deaktiviert. Die vorhandenen `AccessGroups` und `AdminGroups` bleiben in der Konfiguration stehen und koennen spaeter wieder aktiviert werden. Die Finance-Sperre bleibt davon unabhaengig aktiv.
+
+### Zentrale Excel fuer CFO-/Finance-Filter
+
+Die zentrale Datei `Sales_All_yyyy-MM-dd.xlsx` enthaelt am rechten Ende einen zusammengehoerigen Finance-Spaltenblock:
+
+```text
+Finance | Year
+Finance | Country Key
+Finance | Date
+Finance | Net Sales Actual
+Finance | Currency
+Finance | Include
+Finance | Source Value Field
+```
+
+Zusaetzlich wird nur in der zentralen Datei ein Hilfsblatt erzeugt:
+
+```text
+Finance Filter Hilfe
+```
+
+Damit soll Finance dieselben Ist-Summen aus Excel filtern koennen wie im Testprogramm bzw. auf `/finance-cockpit/vergleich`.
+
+Vorgehen im Excel:
+
+1. `Finance | Year` auf das gewuenschte Jahr filtern, z. B. `2025`.
+2. `Finance | Country Key` auf Land filtern, z. B. `IT`, `UK`, `ES`, `AT`.
+3. `Finance | Include = TRUE` filtern.
+4. `Finance | Net Sales Actual` summieren.
+
+Gepruefter Vergleich gegen `FinanceReconciliationService` fuer 2025:
+
+| Key | Finance-Service | Excel-Finance-Spalten | Differenz |
+| --- | ---: | ---: | ---: |
+| AT | `3'438'121.37` | `3'438'121.37` | `0.00` |
+| CH | `43'521'390.82` | `43'521'390.82` | `0.00` |
+| ES | `3'082'320.18` | `3'082'320.18` | `0.00` |
+| FR | `1'471'218.44` | `1'471'218.44` | `0.00` |
+| IN | `750'936'591.38` | `750'936'591.38` | `0.00` |
+| IT | `7'669'641.47` | `7'669'641.47` | `0.00` |
+| UK | `3'533'710.09` | `3'533'710.09` | `0.00` |
+| US | `3'749'865.33` | `3'749'865.33` | `0.00` |
+
+Hinweis: Fuer AT/CH waehlt der Finance-Service intern `Nettofakturawert Hauswaehrung pro Position`; in den aktuellen Daten ist dieser Wert identisch mit `SalesPriceValue`, daher stimmen die Excel-Finance-Spalten exakt.
+
 ## Aktuelle Soll/Ist-Werte

 | Land | Ist | Soll | Differenz | Waehrung | Status |
@@ -256,6 +335,13 @@ Relevante Commits:
 | `fb85e2e` | Sage-Berechnungen korrigiert, IT/UK-Doku und Ampel ergaenzt |
 | `3d40d76` | UK auf GBP Local Currency als Referenz umgestellt |
 | `f721d95` | Aktuelle Excel und Spanien-Cache ergaenzt |
+| `bc6bfdf` | Finance-Handoff dokumentiert |
+| `8f1b1b8` | Haupt-Finance-Vergleich an Probe angeglichen |
+| `f855e06` | Leere Ist-Zeilen im Finance-Vergleich gefiltert |
+| `5c654ad` | Finance-Berechnungsformeln je Land dokumentiert |
+| `9c544af` | Finance Cockpit mit Login technisch geschuetzt |
+| `ebbc5a1` | Finance-Filterspalten in zentrale Excel ergaenzt |
+| `b23f73e` | Finance-Hilfsblatt in zentrale Excel ergaenzt |

 Dieses Handoff wurde danach als weiterer Commit hinzugefuegt.

@@ -275,8 +361,11 @@ docs/CFO_Kurzbericht_270515*.bak.docx
 docs/CFO_Kurzbericht_270515_NEU*.docx
 docs/FINANCE_AMPEL_LAENDER_2026-05-18.xlsx
 docs/FINANCE_AMPEL_LAENDER_2026-05-18_20-32.xlsx
+docs/FINANCE_AMPEL_LAENDER_2026-05-19.xlsx
 docs/it_cache_2025.csv
 italien.png
+financeprobe.*.log
+mainapp.*.log
 ```

 Wenn weitergearbeitet wird, zuerst `git status --short` pruefen und keine fremden/alten Dateien blind loeschen.
@@ -287,3 +376,5 @@ Wenn weitergearbeitet wird, zuerst `git status --short` pruefen und keine fremde
 2. AT: Differenz `-5'741.63 EUR` analysieren.
 3. UK: Restdifferenz `-5'261.91 GBP` klaeren, aber UK ist jetzt nahe am LC-Soll.
 4. IT: provisorischen Kundenausschluss fachlich bestaetigen oder durch offizielle B1/Rhino-Filterregel ersetzen.
+5. AD-/Rollenpruefung spaeter wieder aktivieren, sobald geklaert ist, welche Gruppen produktiv gelten. Dazu `Security.Enabled` wieder auf `true` setzen; Gruppen sind nicht geloescht.
+6. `/finance-cockpit/vergleich` und `/finance` nebeneinander pruefen, wenn neue Daten geladen wurden; beide sollen dieselbe `FinanceReconciliationService`-Logik nutzen.