diff --git a/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md b/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md index ef5fe60..eaabb1a 100644 --- a/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md +++ b/TrafagSalesExporter/NEXT_STEPS_2026-04-15.md @@ -2,6 +2,27 @@ Stand: 2026-05-20 +## Nachtrag 2026-05-20 Technische Architektur-SVG + +Erstellt: + +```text +docs/SYSTEMARCHITEKTUR_TECHNISCH_2026-05-20.svg +``` + +Zielgruppe: + +- Systemarchitekt / Serveradmin / technischer Projektkontext. + +Abgrenzung: + +- Nur produktive Applikation. +- Keine Testapp, Probe-Tools oder temporaeren Analyseprogramme. + +Naechster geplanter Schritt: + +- Separate Keyuser-Prozessdoku als zweite SVG erstellen: was wann in der App zu tun ist, inklusive Import, Standortexport, zentraler Excel, Finance-Pruefung und offener fachlicher Rueckfragen. + ## Nachtrag 2026-05-20 DE Alphaplan-Excel provisorisch eingebaut Erledigt: diff --git a/TrafagSalesExporter/docs/SYSTEMARCHITEKTUR_TECHNISCH_2026-05-20.svg b/TrafagSalesExporter/docs/SYSTEMARCHITEKTUR_TECHNISCH_2026-05-20.svg new file mode 100644 index 0000000..5b9bd63 --- /dev/null +++ b/TrafagSalesExporter/docs/SYSTEMARCHITEKTUR_TECHNISCH_2026-05-20.svg @@ -0,0 +1,285 @@ + + + + + + + + + + + + + + + + + + + TrafagSalesExporter / BiDashboard - technische Systemarchitektur + Stand 2026-05-20 | Produktive Applikation ohne Test-/Probeprogramme | ASP.NET Core Blazor Server, SQLite, SharePoint, SAP/HANA/OData/Manual Excel + + + Deployment und Laufzeit + Fuehrendes Projekt: TrafagSalesExporter.csproj + Publish-Ausgabe: BiDashboard.dll, keine EXE/AppHost + IIS URL: https://trch-webapp-bidashboard.trafagch.local/BiDashboard/ + Runtime: .NET 8 / ASP.NET Core Hosting Bundle + Publish-Ziel: \\trch-webapp-bidashboard.trafagch.local\BiDashboard$\ | web.config: dotnet .\BiDashboard.dll, stdout logs .\logs\stdout, out-of-process Diagnose + + + + Benutzer + Browser im Trafag-Netz + Finance / HR / Admin + + + Authentisierung + IIS / Windows Auth vorbereitet + AD-Rollen aktuell deaktivierbar + HR und Finance: eigene Logins + + + Blazor Server UI + Dashboard / Export Dashboard + Finance Vergleich / Management Analyse + HR KPI + Admin: Standorte, Settings, Transformationen, Logs + + + Startup / Background + DatabaseInitializationService + DatabaseSchemaMaintenanceService + TimerBackgroundService + + + SQLite + trafag_exporter.db + WAL/SHM auf Server + App-Pool braucht Modify + + + + + + + + + Applikationskern und Services + + + ExportOrchestrationService + Startet Einzel-/Alle-Exporte + Status fuer UI und Timer + Schreibt ExportLogs + + + SiteExportService + Quelle je Standort aufloesen + Adapter ausfuehren + Lokale/SharePoint-Ausgabe + + + DataSourceAdapterResolver + ConnectionKind entscheidet + HANA / SAP Gateway / Manual Excel + einheitliches SalesRecord-Modell + + + Transformationen + RecordTransformationService + TransformationCatalog + Copy, Replace, Currency, FirstNonEmpty + + + CentralSalesRecordService + Standortdaten ersetzen + Batch Insert in CentralSalesRecords + Grundlage fuer Cockpits und Endexcel + + + + + + + + + ConsolidatedExportService + Sales_All_yyyy-MM-dd.xlsx + zentraler Export aus CentralSalesRecords + + + ExcelExportService + Standortdateien und Endexcel + Finance-Spalten + Hilfe-Blatt + + + FinanceReconciliationService + Soll/Ist gegen FinanceReferences + Landeslogiken: IT, UK, ES, DE vorbereitet + + + ManagementCockpitService + Analysen aus Einzeldateien + Analysen aus CentralSalesRecords + + + HR KPI Services + HrKpiService + AccessService + liest HR-Excel-Dateien aus konfiguriertem Ordner + + + + + + + + + Datenquellen und Adapter + + + SAP HANA / BI1 / SAGE + HanaQueryService + HanaDataSourceAdapter + FR/IT/US B1, IN SAGE/HANA + Schema je Standort + + + SAP Gateway / OData + SapGatewayService + SapCompositionService + Quellen, Joins, Feldmappings + CH/AT ZSCHWEIZ + + + Manual Excel / CSV + ManualExcelImportService + lokal, UNC oder SharePoint Download + UK Sage, ES Sage CSV, DE Alphaplan + konfigurierbare Spaltenmappings + + + SharePoint / Graph + SharePointUploadService + Upload Standort-/Zentraldateien + Download Manual Imports + ClientId/TenantId/Secret aus Settings + + + Dateisystem / Output + lokaler Standardpfad ./output + optionale Standort-/Zentralpfade + Sales_TRxx_yyyy-MM-dd.xlsx + Sales_All_yyyy-MM-dd.xlsx + + + + + + + + + + + Persistenzmodell SQLite - wichtigste Tabellen + + + Sites + Standorte, TSC, Land + SourceSystem, ManualImportFilePath + + + SourceSystemDefinitions + ConnectionKind + SAP / BI1 / SAGE / MANUAL_EXCEL + + + Mappings + SapSource/Join/FieldMappings + ManualExcelColumnMappings + + + CentralSalesRecords + normalisierte SalesRecord-Zeilen + Basis fuer Endexcel/Cockpit + + + ExportSettings + Datumfilter, Timer, Pfade + Debug Live-Logging + + + SharePointConfigs + SiteUrl, ExportFolder + Tenant/Client/Secret + + + Finance-Tabellen + FinanceReferences + BudgetRates, IntercompanyRules + + + Logs + AppEventLogs + ExportLogs + + + + Betrieb, Security, fachliche Besonderheiten + + + Zugriff + Security.Enabled steuert globale AD-Policy + Finance/HR Cockpit eigene Passwortsperren + + + Serveranforderungen + .NET 8 Hosting Bundle + kein Microsoft Excel noetig + + + Finance-Sonderregeln + IT: Trafag Italia ausgeschlossen + DE: Alphaplan provisorisch vorbereitet + + + IIS Diagnose + diag.txt beweist korrekten Pfad + Event Viewer bei 500 pruefen + + + + UI + + Service + + SQLite/Persistenz + + externes System + + Security/Betrieb + Quelle: Codebasis TrafagSalesExporter, Stand 2026-05-20 + diff --git a/TrafagSalesExporter/lastchange.md b/TrafagSalesExporter/lastchange.md index 848cba3..45d2927 100644 --- a/TrafagSalesExporter/lastchange.md +++ b/TrafagSalesExporter/lastchange.md @@ -1,5 +1,21 @@ # Last Change 2026-05-04 +## Technische Systemarchitektur SVG 2026-05-20 + +Erstellt: + +- `docs/SYSTEMARCHITEKTUR_TECHNISCH_2026-05-20.svg` + +Inhalt: + +- Laufzeit und IIS-Publish als `BiDashboard.dll` ohne EXE/AppHost. +- Blazor-UI, Authentisierung, Start-/Background-Services. +- Applikationskern: Export-Orchestrierung, Standortexport, Adapter, Transformationen, zentrale Tabelle. +- Datenquellen: SAP HANA/BI1/SAGE, SAP Gateway/OData, Manual Excel/CSV, SharePoint. +- Persistenzmodell mit wichtigsten SQLite-Tabellen. +- Output-/SharePoint-Pfade, Finance-Sonderregeln, HR/Finance-Zugriff und Betriebspruefpunkte. +- Test-/Probeprogramme sind bewusst nicht enthalten. + ## IT Finance-Methode fachlich bestaetigt 2026-05-20 Entscheid: