Add SharePoint manual source handling and finance status

2026-05-11 08:43:52 +02:00
parent 57cb09bc50
commit 819a023163
16 changed files with 983 additions and 28 deletions
@@ -2,6 +2,76 @@

 Stand: 2026-05-05

+## Nachtrag 2026-05-08 Manual Excel/CSV / SharePoint-Ordner
+
+Aktueller Stand fuer manuelle Quellen:
+
+- `MANUAL_EXCEL` ist fachlich Manual Excel/CSV.
+- Unterstuetzt werden `.xlsx` und `.csv`; altes `.xls` ist nicht der Zielpfad.
+- Lokale Datei als Quelle:
+  - App liest die Datei.
+  - App erzeugt eine neue Exportdatei im selben lokalen Ordner.
+- SharePoint-Datei als Quelle:
+  - App laedt die Datei temporaer herunter.
+  - App erzeugt eine neue Exportdatei und laedt sie in denselben SharePoint-Ordner hoch.
+- SharePoint-Ordner als Quelle:
+  - App waehlt automatisch die neueste passende `.xlsx`/`.csv` fuer den Standort.
+  - Primaeres Muster: `ddMMyy_TSC.xlsx` oder `ddMMyy_TSC.csv`.
+  - Fallback: SharePoint `LastModifiedDateTime`.
+
+England / UK:
+
+- Standort `England`, `TSC = TRUK`, `SourceSystem = MANUAL_EXCEL`.
+- Quelle ist ein SharePoint-Ordner:
+
+```text
+https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Import/Finance/UK_B1
+```
+
+- Beispielauswahl:
+  - `010526_TRUK.xlsx` ist neuer als `010426_TRUK.xlsx`.
+- Exportdateien werden wieder in `Import/Finance/UK_B1` geschrieben.
+- Befund am 2026-05-08: England zeigte lokal faelschlich auf die Deutschland-Alphaplan-Datei; lokale DB wurde korrigiert.
+- `DatabaseSeedService` repariert kuenftig einen leeren England/TRUK-Manual-Pfad auf den UK_B1-Ordner.
+
+Spanien / Sage:
+
+- Spanien nutzt `MANUAL_EXCEL` als technischen Importpfad fuer den Sage-Export.
+- Die Datei `Spain_Sales_2025.csv` konnte gelesen werden (`4'341` Zeilen).
+- Fehler war danach der Exportpfad: die SharePoint-URL wurde als lokaler Dateipfad interpretiert.
+- Fix: SharePoint-Manual-Quellen liefern keinen `ReferenceFilePath` mehr, sondern erzeugen eine neue Exportdatei im Quellordner.
+
+Deutschland / Alphaplan:
+
+- Deutschland nutzt `MANUAL_EXCEL` als technischen Importpfad fuer Alphaplan-Excel.
+- Grafisches Mapping ist vorhanden.
+- Offener Punkt: konkreter Alphaplan-Datei-/SharePoint-Pfad muss im Standort hinterlegt sein, sonst kommt `Standort 'Deutschland' hat keine manuelle Excel-Datei.`
+
+Verifikation:
+
+- Tests `55/55` erfolgreich.
+
+## Nachtrag 2026-05-08 FinanceProbe fuer mehr Laender
+
+FinanceProbe wurde erweitert:
+
+- `FinanceReferences` werden vollstaendig angezeigt, nicht nur bei aktivem Standort oder vorhandenen Ist-Daten.
+- Dadurch sind alle Soll-Laender aus der Finance-Konfiguration im Meeting sichtbar.
+- Neue Sektion `Datenabdeckung je Standort` zeigt je Standort:
+  - Quelle/System
+  - Manual-/SharePoint-Pfad
+  - Aktivstatus
+  - Anzahl 2025-Zeilen in `CentralSalesRecords`
+  - Summe `SalesPriceValue`
+  - Waehrungen und Datumsbereich
+  - letzter Exportstatus/Fehler
+- CH/AT-Erkennung im Finance-Service wurde geschaerft, damit `ZSCHWEIZ`-Zeilen mit Land `AT` Oesterreich zugeordnet werden koennen.
+
+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-07 Mapper-Konsolidierung / Finance-Konfiguration

 Architekturstand: