Commit pending finance and Power BI work

2026-05-13 07:33:00 +02:00
parent 1cd0ad998f
commit 001e2a73d5
44 changed files with 3210 additions and 104 deletions
@@ -2,6 +2,112 @@

 Stand: 2026-05-05

+## Nachtrag 2026-05-11 UK_B1 Mapping / aktueller Arbeitsstand
+
+Letzter Benutzerwunsch:
+
+- UK/England soll weiter ueber `UK_B1` laufen.
+- Das Mapping soll so angepasst werden, dass die Finance-Zahl plausibel wird.
+- Danach soll alles nachvollziehbar dokumentiert sein.
+
+Wichtiger Befund:
+
+- FinanceProbe zeigte fuer UK/England:
+  - `TSC = TRUK`
+  - `1'881` Zeilen
+  - Ist `395'605.82 GBP`
+  - Soll `3'749'865.00 GBP`
+- In der lokalen DB waren fuer `TRUK` keine `ManualExcelColumnMappings` vorhanden.
+- Der Fallback-Importer hat `Sales Price/Value` direkt als Positionswert importiert.
+- Im UK-B1-Export ist `Sales Price/Value` aber ein Stueckpreis.
+- Korrekte Positionslogik:
+
+```text
+SalesPriceValue = [Sales Price/Value] * [Quantity]
+```
+
+Probe auf existierenden Zentraldaten:
+
+```text
+Summe SalesPriceValue bisher:        395'605.82 GBP
+Summe SalesPriceValue * Quantity:  3'533'348.89 GBP
+check.xlsx Soll:                   3'749'865.00 GBP
+Restdifferenz:                      -216'516.11 GBP
+```
+
+Geaenderte Dateien im aktuellen Worktree:
+
+- `Services/ManualExcelImportService.cs`
+  - grafische Manual-Excel-Mappings koennen einfache Multiplikationsausdruecke lesen:
+
+```text
+=[Header A]*[Header B]
+```
+
+  - Konstanten wie `=GBP` funktionieren weiterhin.
+
+- `Services/DatabaseSeedService.cs`
+  - repariert England/TRUK auf:
+
+```text
+https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Import/Finance/UK_B1
+```
+
+  - seedet fuer `TRUK` ein grafisches Mapping, insbesondere:
+
+```text
+SalesPriceValue <- =[Sales Price/Value]*[Quantity]
+SalesCurrency   <- =GBP
+DocumentCurrency<- =GBP
+CompanyCurrency <- =GBP
+PostingDate     <- invoice date
+InvoiceDate     <- invoice date
+```
+
+- `TrafagSalesExporter.Tests/ManualExcelImportServiceTests.cs`
+  - neuer Test fuer berechnetes Manual-Excel-Mapping.
+
+Aktueller Teststand:
+
+- `dotnet test .\TrafagSalesExporter.Tests\TrafagSalesExporter.Tests.csproj --no-restore -p:UseAppHost=false --verbosity minimal`
+- Tests erfolgreich: `59/59`.
+- Bekannte Warnungen: bestehende MudBlazor-Analyzerwarnungen zu `Dense`.
+
+Zusatzfix:
+
+- `DatabaseSeedService` prueft vor `EnsureUkManualExcelMapping(...)`, ob `ManualExcelColumnMappings` sauber auf `Sites` referenziert.
+- Falls die Tabelle noch auf `Sites_repair_old` oder eine andere `Sites_*`-Reparaturtabelle zeigt, wird der UK-Mapping-Seed fuer diesen Start uebersprungen.
+- Dadurch kann die Schema-Reparatur sauber durchlaufen.
+
+Naechster praktischer Schritt:
+
+1. SharePoint-/Graph-Zugriff reparieren.
+2. FinanceProbe ist bereits auf `http://127.0.0.1:5099` gestartet.
+3. `/run/export/TRUK` erneut ausfuehren.
+4. `/finance` erneut pruefen.
+
+Praktischer Stand:
+
+- Lokale DB ist aktualisiert:
+  - `TRUK` Pfad = `UK_B1`
+  - `18` aktive Manual-Excel-Mapping-Zeilen
+- `/finance` antwortet mit HTTP `200`.
+- `/run/export/TRUK` scheitert aktuell an Auth/Netzwerk:
+
+```text
+ClientSecretCredential authentication failed
+127.0.0.1:9 connection refused
+```
+
+- Deshalb enthaelt `CentralSalesRecords` fuer UK noch den alten Importstand, bis SharePoint wieder erreichbar ist.
+
+Wichtig:
+
+- Das ist keine Sonderlogik, die UK-Zahlen schoenrechnet.
+- Der Mapper setzt die allgemeine fachliche Regel "pro Artikel / Belegposition" um.
+- Die Formel ist im grafischen Mapping sichtbar und nicht hart als UK-Spezialberechnung im Importcode versteckt.
+- Falls nach neuem Export noch eine Restdifferenz bleibt, muss die UK-Datei auf weitere Netto-/Discount-/Frachtspalten geprueft werden.
+
 ## Nachtrag 2026-05-08 Manual Excel/CSV / SharePoint-Ordner

 Aktueller Stand fuer manuelle Quellen:
@@ -72,6 +178,22 @@ Wichtig:
 - `Keine Daten` bedeutet jetzt nicht zwingend fehlende Referenz, sondern oft: Referenz ist vorhanden, aber Ist-Daten wurden noch nicht exportiert/importiert.
 - Fuer neue Laender reicht es, `FinanceReferences` zu pflegen und Daten nach `CentralSalesRecords` zu bringen; die Probe zeigt sie dann automatisch.

+## Nachtrag 2026-05-11 FinanceProbe KI-Steuerung
+
+FinanceProbe kann jetzt nicht nur vergleichen, sondern im Testkontext auch Exporte ausloesen:
+
+- `/run/export/{siteKey}`: einzelner Standort nach `Id`, `TSC` oder `Land`
+- `/run/export-all`: alle aktiven Standorte plus zentrale Datei
+- `/run/consolidated`: zentrale Datei aus `CentralSalesRecords`
+
+Die Routen liefern eine HTML-Run-Summary mit Exportlogs, Finance-Abgleich und Datenabdeckung.
+
+Wichtig:
+
+- Das ist eine temporaere Test-/KI-Steuerung.
+- Nicht als produktive API betrachten.
+- Echte SAP/HANA/SharePoint-Zugriffe funktionieren nur mit vorhandenen Credentials und Netzverbindung auf dem Rechner.
+
 ## Nachtrag 2026-05-07 Mapper-Konsolidierung / Finance-Konfiguration

 Architekturstand: