Document finance and Spain rclone updates

This commit is contained in:
2026-06-05 06:26:51 +02:00
parent 3fd19a8bb5
commit 195b430836
6 changed files with 247 additions and 34 deletions
@@ -107,12 +107,39 @@ This file does not require Export-SageSpainSalesCsv.ps1 or Run-SpainExportAndUpl
.\Run-SpainRangeExportAndUpload-AllInOne.ps1
Default date window:
- FromDate = today - 7 days
- ToDate = today
- ToDate is exclusive
Override the all-in-one default date window:
.\Run-SpainRangeExportAndUpload-AllInOne.ps1 -FromDate "2026-06-01" -ToDate "2026-06-04"
The all-in-one script checks/creates the SharePoint folder before export, uploads the generated CSV and summary, and verifies that the uploaded files are listed in SharePoint.
rclone.exe lookup for the all-in-one script:
- explicit -RcloneExe parameter
- rclone.exe in the same folder as the script
- C:\Tools\rclone.exe
- C:\Tools\rclone\rclone.exe
- C:\Tools\rclone\rclone\rclone.exe
- rclone from PATH
Known rclone upload issue:
If the log says:
CRITICAL: Can't set -v and --log-level
then the server is running an old script copy that still contains:
--verbose `
Remove that line from the rclone copy block or replace the file with the current Run-SpainRangeExportAndUpload-AllInOne.ps1.
Full export and upload:
.\Run-SpainExportAndUpload.ps1 -ExportMode Full -Year 2025
+3 -1
View File
@@ -1,6 +1,6 @@
# RAG Router
Stand: 2026-05-27
Stand: 2026-06-05
Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themenblock laden.
@@ -49,6 +49,8 @@ Zweck: Diese Datei zuerst laden. Danach nur die Dateien aus dem passenden Themen
| `TRUK`, `UK_B1`, `Delta`, `Manual Excel` | Manual Import / Finance Spezialfaelle |
| `TRDE`, `Alphaplan`, `NettoPreisGesamtX` | Finance Cockpit / Manual Import |
| `TRSE`, `Spain`, `Sage`, `ImporteNeto` | Finance Spezialfaelle |
| `Spain rclone`, `Spanien SharePoint`, `Run-SpainRangeExportAndUpload-AllInOne`, `trafag-bi` | `docs/SAGE_SPAIN_RCLONE_UPLOAD_GUIDE_2026-06-03.md` |
| `3D Datenanalyse`, `Experten`, `Schnelluebersicht`, `Simulation`, `Wechselkurs-Schieberegler` | Finance Cockpit |
| `HR KPI`, `Rexx`, `Austritte`, `Absenzen` | HR KPI |
| `IIS`, `BiDashboard`, `Publish`, `TLS`, `Client certificate` | Deployment/IIS |
| `Upgreat`, `Firewall`, `Freigabe`, `10.120.1.17`, `30015`, `8000` | Deployment/IIS |
@@ -1,6 +1,6 @@
# Sage Spain Rclone Upload Guide
Status: 2026-06-03
Status: 2026-06-05
Purpose: The Sage server in Spain creates the sales CSV locally and then automatically uploads the file to the SharePoint folder used by the dashboard import.
@@ -32,25 +32,26 @@ https://trafagag.sharepoint.com/sites/WorldwideBIPlatform
## Required Files On The Spain Server
Recommended folder:
Recommended folder for export output and logs:
```text
C:\Trafag\SageSpain
```
Required files:
Recommended script folder:
```text
Export-SageSpainSalesCsv.ps1
Run-SpainExportAndUpload.ps1
C:\Tools\rclone
```
The files are included in:
Required file for the current single-file workflow:
```text
SageSpainFinalExportPackage.zip
Run-SpainRangeExportAndUpload-AllInOne.ps1
```
This all-in-one script does not require `Export-SageSpainSalesCsv.ps1` or `Run-SpainExportAndUpload.ps1`.
## Install rclone
If `winget` is available:
@@ -59,10 +60,11 @@ If `winget` is available:
winget install Rclone.Rclone
```
Alternatively, install the rclone ZIP manually, for example to:
Alternatively, install the rclone ZIP manually, for example to one of these paths:
```text
C:\Tools\rclone\rclone.exe
C:\Tools\rclone\rclone\rclone.exe
```
Test the installation:
@@ -77,6 +79,14 @@ If `rclone` is not in the PATH, use the full path later:
C:\Tools\rclone\rclone.exe version
```
The current all-in-one script auto-detects rclone in:
```text
C:\Tools\rclone.exe
C:\Tools\rclone\rclone.exe
C:\Tools\rclone\rclone\rclone.exe
```
## Configure The rclone Remote
On the Spain server:
@@ -138,36 +148,39 @@ Notes:
## Run Export And Upload Together
Default: daily delta run, yesterday until today:
Current recommended command: one file, range export and upload.
Default: last 7 days until today. `ToDate` is exclusive.
```powershell
Set-ExecutionPolicy -Scope Process Bypass
cd C:\Trafag\SageSpain
.\Run-SpainExportAndUpload.ps1
cd C:\Tools\rclone
.\Run-SpainRangeExportAndUpload-AllInOne.ps1
```
Explicit date range:
```powershell
.\Run-SpainExportAndUpload.ps1 -ExportMode Range -DateFilter LineRegistrationDate -FromDate "2026-06-02" -ToDate "2026-06-03"
.\Run-SpainRangeExportAndUpload-AllInOne.ps1 -FromDate "2026-06-01" -ToDate "2026-06-04"
```
Full export with upload:
If rclone is in a non-standard location:
```powershell
.\Run-SpainExportAndUpload.ps1 -ExportMode Full -Year 2025
.\Run-SpainRangeExportAndUpload-AllInOne.ps1 -RcloneExe "C:\Tools\rclone\rclone\rclone.exe"
```
If rclone is not in the PATH:
Older two-file wrapper, only use if both scripts are present in the same folder:
```powershell
.\Run-SpainExportAndUpload.ps1 -RcloneExe "C:\Tools\rclone\rclone.exe"
.\Run-SpainExportAndUpload.ps1
```
If the rclone remote has another name:
This older wrapper requires:
```powershell
.\Run-SpainExportAndUpload.ps1 -RcloneRemote "YOUR_REMOTE_NAME"
```text
Export-SageSpainSalesCsv.ps1
Run-SpainExportAndUpload.ps1
```
## What Gets Uploaded?
@@ -194,7 +207,7 @@ Recommended daily run, for example at 02:00:
```powershell
$action = New-ScheduledTaskAction `
-Execute "powershell.exe" `
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Trafag\SageSpain\Run-SpainExportAndUpload.ps1"
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Tools\rclone\Run-SpainRangeExportAndUpload-AllInOne.ps1"
$trigger = New-ScheduledTaskTrigger -Daily -At 02:00
@@ -210,7 +223,7 @@ If rclone is not in the PATH:
```powershell
$action = New-ScheduledTaskAction `
-Execute "powershell.exe" `
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Trafag\SageSpain\Run-SpainExportAndUpload.ps1 -RcloneExe C:\Tools\rclone\rclone.exe"
-Argument "-NoProfile -ExecutionPolicy Bypass -File C:\Tools\rclone\Run-SpainRangeExportAndUpload-AllInOne.ps1 -RcloneExe C:\Tools\rclone\rclone\rclone.exe"
```
## Check After The Run
@@ -239,7 +252,18 @@ https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Shared%20Documents/Imp
`rclone: command not found`
- rclone is not in the PATH.
- Use `-RcloneExe "C:\Tools\rclone\rclone.exe"`.
- Use `-RcloneExe "C:\Tools\rclone\rclone.exe"` or `-RcloneExe "C:\Tools\rclone\rclone\rclone.exe"`.
`Export script not found`
- You started the older wrapper `Run-SpainExportAndUpload.ps1`.
- For the single-file workflow start `Run-SpainRangeExportAndUpload-AllInOne.ps1`.
`CRITICAL: Can't set -v and --log-level`
- The server is running an old copy of the script that still contains `--verbose`.
- Remove the line `--verbose \`` from the rclone `copy` block, or replace the file with the current all-in-one script.
- The corrected upload block keeps `--log-level INFO` and does not use `--verbose`.
`directory not found`
+19 -1
View File
@@ -1,12 +1,14 @@
# RAG Finance
Stand: 2026-06-01
Stand: 2026-06-05
## Kurzstand
- Fuehrende Sicht: `Finance Summary`.
- `Finance Summary` nutzt dieselbe `FinanceRuleEngine` wie das zentrale Excel.
- `Management Analyse` bleibt Diagnose-/Plausibilitaetssicht, nicht fuehrende Finance-Zahl.
- Nach UX-Vereinfachung gibt es links eine schnellere Finance-Uebersicht; tiefe Diagnosefunktionen sind unter `Experten` gebuendelt.
- Neuer Expertenpunkt: `3D Datenanalyse` fuer interaktive visuelle Analyse und Simulation.
- `Management Analyse` hat zusaetzliche Finance-Reiter fuer Laender, Datenstatus, Abweichungen, Gutschriften-Kandidaten und Datenqualitaet.
- `Management Analyse` ist links aufklappbar; direkte Navigationspunkte springen in die einzelnen Reiter.
- Neu: `Spartenanalyse` mit Unterreitern `Finanzanalyse` und `Zentrale Zuordnung`.
@@ -19,6 +21,8 @@ Stand: 2026-06-01
- Management Analyse zeigt in `Laender` jetzt IC/2nd-party und `Ist ohne IC` als Diagnose.
- Wechselkurs-Anwendungsdatum ist in Settings konfigurierbar und wird in der Rohdaten-Diagnose angezeigt.
- Spartenanalyse war mit >90% nicht zugeordnet fachlich unplausibel; Materialabgleich normalisiert fuehrende Nullen und warnt bei >=90% ungeklaerter Abdeckung.
- Budgetkurse wurden als Finance-Kurse behandelt; CHF-Sicht bleibt getrennte Reporting-/Kontrollsicht, nicht stiller Ersatz fuer Hauswaehrungsabgleich.
- Browser-Hinweis: 3D-Ansicht wurde in Chrome als korrekt bestaetigt; Firefox zeigte auf dem Client Interaktions-/Zoomprobleme.
## Wichtige Regeln
@@ -47,6 +51,20 @@ Stand: 2026-06-01
- `Spartenanalyse > Zentrale Zuordnung`: Materialnummern aller Laender gegen TR-AG-Stamm pruefen.
- `Rohdaten Diagnose`: direkte Plausibilitaets-/Rohdatensicht auf `CentralSalesRecords`.
## Experten / 3D Datenanalyse
- Unter `Experten` gibt es den Punkt `3D Datenanalyse`.
- Zweck: Verlauf und Kennzahlen im Raum betrachten, nicht Ersatz fuer den offiziellen Soll/Ist-Wert.
- Funktionen:
- drehbare 3D-Ansicht mit Maus.
- Achsenbeschriftung fuer Zeit/Wert/Indikator.
- Auswahl sinnvoller Finance-Indikatoren.
- Diagrammarten wie Balken/Linien/weitere Analyseformen.
- einstellbare Labelgroesse.
- Schieberegler fuer Szenarien, u. a. Wechselkursveraenderungen.
- Realtime-Neuberechnung bei Szenarioaenderungen.
- Bekannter Hinweis: Wenn Interaktion/Zoom in Firefox fehlerhaft ist, mit Chrome pruefen.
## Spartenanalyse Kurzlogik
- Statuswerte:
+9 -6
View File
@@ -1,15 +1,18 @@
# RAG Project
Stand: 2026-05-29
Stand: 2026-06-05
## Kurzstand
- Fuehrende App: `TrafagSalesExporter`, publiziert als `BiDashboard`.
- Letzter dokumentierter Stand: alle Aenderungen bis `36ca822 Add browser favicon` umgesetzt und deployed.
- Validierung laut Doku: `80/80` Tests gruen, letzter Testlauf mit Artefaktpfad `C:\TMP\trafag-test-artifacts-favicon`.
- Letzter Deploy: 2026-05-29 13:47 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Neu im Finance/Management-Cockpit: aufklappbare Management-Navigation, Spartenanalyse-Unterreiter, Gruppierung/Top-10/Flaggen/Icon-UX und Finance-Schulungserweiterung.
- Neu im Browser: eigenes SVG-Favicon `wwwroot/favicon.svg`.
- Letzter dokumentierter Stand: Finance-Schnelluebersicht, Expertenbereich, 3D-Datenanalyse und Spanien-Sage-All-in-one-rclone-Upload.
- Validierung laut Doku: Finance-Sitzungsstand `82/82` Tests gruen; spaetere UI-/Deploy-Schritte wurden einzeln umgesetzt und deployed.
- Letzter dokumentierter Finance-Deploy: 2026-06-04 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Neu im Finance/Management-Cockpit: einfache Schnelluebersicht links sichtbar; tiefere Funktionen bleiben unter `Experten`.
- Neu im Expertenbereich: `3D Datenanalyse` mit drehbarer 3D-Grafik, Achsen, Diagrammarten, Indikatorauswahl, Labelgroesse und Simulation per Schieberegler.
- Spanien: `Run-SpainRangeExportAndUpload-AllInOne.ps1` exportiert Sage-Range direkt und laedt CSV/Summary via rclone nach SharePoint `trafag-bi:Import/Finance/Spanien`.
- Spanien: Default-Range ist heute minus 7 Tage bis heute; `ToDate` ist exklusiv.
- Spanien: rclone-Fehler `Can't set -v and --log-level` im All-in-one-Script behoben; aktuelle Datei enthaelt kein `--verbose` im Upload.
- Fuer normale Weiterarbeit diese Datei plus den passenden Themen-RAG laden.
## Aktive Themen
+143 -4
View File
@@ -1,6 +1,6 @@
# Last Change
Stand: 2026-06-01
Stand: 2026-06-05
Diese Datei ist fuer tokenarme RAG-Nutzung komprimiert.
@@ -8,8 +8,20 @@ Diese Datei ist fuer tokenarme RAG-Nutzung komprimiert.
- Fuehrender Kurzkontext: `docs/rag/PROJECT.md`.
- Themenrouter: `docs/RAG_ROUTER.md`.
- Letzter dokumentierter Code-Stand: Finance-Sitzungsnachtrag 2026-06-01 noch nicht deployt.
- Letzter dokumentierter Code-Stand: Finance-Dashboard-Vereinfachung, Expertenbereich mit 3D-Datenanalyse und Spanien-Sage-All-in-one-rclone-Upload.
- Letzte dokumentierte Validierung: `dotnet test TrafagSalesExporter.sln --verbosity minimal --artifacts-path C:\TMP\trafag-test-artifacts-finance-session-proof` mit `82/82` Tests gruen.
- Neu umgesetzt und deployed: Finance bekommt links eine einfache Schnelluebersicht; die bisherigen tieferen Analysefunktionen bleiben unter `Experten`.
- Neu umgesetzt und deployed: `Experten > 3D Datenanalyse` mit drehbarer 3D-Visualisierung, Achsenbeschriftung, waehlbaren Indikatoren, Diagrammarten und Simulation.
- Neu umgesetzt und deployed: 3D-Simulation mit Schiebereglern, u. a. fuer Wechselkurs-/Szenarioveraenderungen; Grafik reagiert in Echtzeit.
- Neu umgesetzt und deployed: 3D-Darstellung korrigiert fuer Canvas-Groesse, Achsen, Labelgroesse und breitere Indikatorauswahl.
- Bekannter Browser-Hinweis: 3D-Ansicht wurde in Chrome als korrekt bestaetigt; Firefox zeigte auf dem Client Probleme mit Interaktion/Groesse.
- Neu fuer Spanien: All-in-one-PS1 `SageSpainFinalExportPackage/Run-SpainRangeExportAndUpload-AllInOne.ps1` erstellt; es exportiert Sage direkt per SQL-Range und laedt CSV/Summary via rclone nach SharePoint.
- Neu fuer Spanien: Standard-Range ist letzte 7 Tage bis heute; `FromDate`/`ToDate` koennen per Parameter ueberschrieben werden.
- Neu fuer Spanien: SharePoint-Ziel wird vor Export per rclone geprueft/angelegt: `trafag-bi:Import/Finance/Spanien`.
- Neu fuer Spanien: rclone-Uploadfehler `Can't set -v and --log-level` behoben; `--verbose` wurde aus dem All-in-one-Upload entfernt.
- Neu fuer Spanien: rclone wird automatisch an mehreren Standardpfaden gesucht, inkl. `C:\Tools\rclone.exe`, `C:\Tools\rclone\rclone.exe`, `C:\Tools\rclone\rclone\rclone.exe` und `PATH`.
- Wichtig fuer Spanien: Nur das All-in-one-Script benoetigt keine separate `Export-SageSpainSalesCsv.ps1`; der alte Wrapper `Run-SpainExportAndUpload.ps1` braucht weiterhin das Export-Script daneben.
- Neu dokumentiert: Spanien-rclone-Anleitung und Package-README auf den All-in-one-Workflow aktualisiert.
- Neu umgesetzt: ES-Referenz 2025 auf `3'082'320.18 EUR` korrigiert; alter Sollwert `3'102'333.61 EUR` als Referenz-/Excel-Fehler dokumentiert.
- Neu umgesetzt: `FinanceProbe` nutzt dieselbe korrigierte ES-Referenz.
- Neu umgesetzt: Wechselkurs-Anwendungsdatum in Settings konfigurierbar (`PostingDate`, `InvoiceDate`, `ExtractionDate`) und in Rohdaten-Diagnose sichtbar.
@@ -31,10 +43,137 @@ Diese Datei ist fuer tokenarme RAG-Nutzung komprimiert.
- Neu umgesetzt und deployed: Produktsparte zeigt visuelle Kategorie-Icons fuer Gas/Density, Pressure/Druck, Temperatur/Thermostat, Switch/Schalter, Access/Zubehoer, UNASS und Sonstige.
- Neu umgesetzt und deployed: Finance-Schulung hat einen neuen Tab `Spartenanalyse` mit Navigation, Gruppierung, Top 10, Flaggen, Icons und Statusinterpretation.
- Neu umgesetzt und deployed: Browser-Favicon `wwwroot/favicon.svg` und Head-Link in `Components/App.razor`.
- Letzter Deploy: 2026-05-29 13:47 auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Aktueller Stand 2026-06-01 ist validiert, aber noch nicht deployt.
- Letzter dokumentierter Finance-Deploy: 2026-06-04 nach 3D-Datenanalyse-/Schnelluebersicht-Anpassungen auf `\\trch-webapp-bidashboard.trafagch.local\BiDashboard$\`.
- Aktueller Stand 2026-06-05: Spanien-Scriptfixes sind committed; Server muss die aktuelle All-in-one-PS1 verwenden, nicht alte Kopien mit `(1)` und nicht den alten Wrapper.
- Letzte Validierung: `dotnet test TrafagSalesExporter.sln --verbosity minimal --artifacts-path C:\TMP\trafag-test-artifacts-finance-session-proof` mit `82/82` Tests gruen.
## Nachtrag 2026-06-05 Spanien Sage / rclone Upload
Ziel:
- Spanien soll auf dem Sage-Server selbst exportieren und die Datei automatisch nach SharePoint laden.
- Nach dem alten Vollbestand werden kuenftig nur noch Range-/Delta-Exporte benoetigt.
Server-/rclone-Kontext:
- Spanien-Server laut Chat:
- IP: `194.30.41.41`
- Hostname: `WIN-4BJQJ9S1PVJ`
- VPS im Netzwerkprovider von Spanien, Wartung durch Spanien.
- Microsoft-365/rclone-Berechtigung wurde durch Admin genehmigt; rclone-Remote-Konfiguration war danach erfolgreich.
- Zielordner:
- Browser: `https://trafagag.sharepoint.com/sites/WorldwideBIPlatform/Shared%20Documents/Import/Finance/Spanien`
- rclone: `trafag-bi:Import/Finance/Spanien`
Umgesetzt:
- Neues Einzel-Script `SageSpainFinalExportPackage/Run-SpainRangeExportAndUpload-AllInOne.ps1`.
- Das Script macht alles in einem Lauf:
- Datum pruefen.
- rclone finden.
- SharePoint-Ziel pruefen/erstellen.
- Sage-SQL direkt lesen.
- Range-CSV und Summary schreiben.
- CSV/Summary per rclone hochladen.
- Upload via `rclone lsf` verifizieren.
- Default:
- `FromDate = heute - 7 Tage`
- `ToDate = heute`
- `ToDate` ist exklusiv.
- Parameter koennen ueberschrieben werden:
```powershell
.\Run-SpainRangeExportAndUpload-AllInOne.ps1 -FromDate "2026-06-01" -ToDate "2026-06-04"
```
rclone-Fix:
- Fehler im Serverlog:
```text
CRITICAL: Can't set -v and --log-level
```
- Ursache: rclone darf nicht gleichzeitig mit `--verbose` / `-v` und `--log-level INFO` gestartet werden.
- Fix im All-in-one-Script:
- `--verbose` aus dem `rclone copy` Uploadblock entfernt.
- `--log-level INFO` bleibt erhalten.
- Bei rclone-Fehlern werden die letzten 80 Logzeilen direkt ausgegeben.
rclone-Pfade:
- Automatische Suche prueft:
- expliziter Parameter `-RcloneExe`
- `rclone.exe` im Scriptordner
- `C:\Tools\rclone.exe`
- `C:\Tools\rclone\rclone.exe`
- `C:\Tools\rclone\rclone\rclone.exe`
- `rclone` aus `PATH`
Wichtige Bedienregel:
- Fuer den Ein-Datei-Betrieb immer starten:
```powershell
.\Run-SpainRangeExportAndUpload-AllInOne.ps1
```
- Nicht starten:
```powershell
.\Run-SpainExportAndUpload.ps1
```
Dieser alte Wrapper erwartet daneben `Export-SageSpainSalesCsv.ps1` und ist nicht der gewuenschte Ein-Datei-Workflow.
Commits:
- `e55a86c Add Spain all-in-one export upload script`
- `8e0b696 Default Spain export range to last seven days`
- `af097ca Fix Spain all-in-one rclone upload`
- `3fd19a8 Detect nested Spain rclone executable`
## Nachtrag 2026-06-04 Finance Schnelluebersicht / Experten / 3D Datenanalyse
Ziel:
- Finance Dashboard war fuer Finance/Andreas zu unuebersichtlich.
- Bestehende Funktionen bleiben erhalten, werden aber als Expertenbereich eingeordnet.
- Neue fuehrende Navigation soll links klarer sein: einfache Uebersicht zuerst, tiefe Analysen darunter.
Umgesetzt und deployed:
- Finance-Schnelluebersicht links sichtbarer gemacht.
- Bestehende tiefe Funktionen unter `Experten` zusammengefasst.
- Neuer Expertenpunkt `3D Datenanalyse`.
- 3D-Datenanalyse:
- drehbare 3D-Ansicht mit Maus.
- Achsenbeschriftung fuer Zeit/Werte/Indikatoren.
- waehlbare Indikatoren erweitert.
- Diagrammarten erweitert, u. a. Balken, Linien und weitere Analyseformen.
- Labelgroesse in der Grafik einstellbar.
- Canvas-/Frame-Groesse korrigiert, damit die Grafik nicht eingequetscht ist.
- Simulation mit Schiebereglern, u. a. fuer Wechselkurs-/Szenarioaenderungen.
- Realtime-Aktualisierung der Grafik bei Parameterveraenderungen.
Bekannte Beobachtung:
- In Chrome sah die 3D-Ansicht korrekt aus.
- In Firefox gab es auf dem Client Interaktions-/Zoomprobleme; vorerst als Browser-Hinweis merken.
Commits:
- `40805e0 Simplify finance dashboard overview`
- `b44e8ba Expose quick finance overview in navigation`
- `a8dc565 Add finance 3D data analysis`
- `13a7331 Improve finance 3D controls and simulation`
- `9409174 Fix finance 3D scenario scaling`
- `fde7f6b Add finance 3D chart modes`
- `1049216 Label finance 3D axes`
- `e33a2fd Expand finance 3D indicators`
- `9c63c36 Fix finance 3D canvas sizing`
- `cad2140 Add finance 3D label size control`
## Nachtrag 2026-06-01 Finance-Sitzung Andreas
Umgesetzt: