Add technical architecture SVG

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:

TrafagSalesExporter/docs/SYSTEMARCHITEKTUR_TECHNISCH_2026-05-20.svg

@@ -0,0 +1,285 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1800" height="1400" viewBox="0 0 1800 1400">
+  <defs>
+    <style>
+      .bg { fill: #f6f7f9; }
+      .title { font: 700 34px Arial, sans-serif; fill: #111827; }
+      .subtitle { font: 400 16px Arial, sans-serif; fill: #4b5563; }
+      .section { font: 700 18px Arial, sans-serif; fill: #111827; }
+      .box-title { font: 700 15px Arial, sans-serif; fill: #111827; }
+      .txt { font: 400 13px Arial, sans-serif; fill: #1f2937; }
+      .small { font: 400 12px Arial, sans-serif; fill: #4b5563; }
+      .tiny { font: 400 11px Arial, sans-serif; fill: #4b5563; }
+      .pill { font: 700 12px Arial, sans-serif; fill: #374151; }
+      .layer { fill: #ffffff; stroke: #d1d5db; stroke-width: 1.2; }
+      .ui { fill: #e8f2ff; stroke: #2563eb; stroke-width: 1.4; }
+      .service { fill: #f0ecff; stroke: #6d28d9; stroke-width: 1.4; }
+      .data { fill: #eaf8ef; stroke: #15803d; stroke-width: 1.4; }
+      .external { fill: #fff7ed; stroke: #ea580c; stroke-width: 1.4; }
+      .security { fill: #fff1f2; stroke: #be123c; stroke-width: 1.4; }
+      .output { fill: #eef2ff; stroke: #4338ca; stroke-width: 1.4; }
+      .note { fill: #fffbeb; stroke: #d97706; stroke-width: 1.2; }
+      .line { stroke: #374151; stroke-width: 1.5; fill: none; marker-end: url(#arrow); }
+      .line-soft { stroke: #6b7280; stroke-width: 1.2; fill: none; marker-end: url(#arrowSoft); }
+      .line-green { stroke: #15803d; stroke-width: 1.5; fill: none; marker-end: url(#arrowGreen); }
+      .line-orange { stroke: #ea580c; stroke-width: 1.5; fill: none; marker-end: url(#arrowOrange); }
+      .dash { stroke-dasharray: 6 5; }
+    </style>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#374151" />
+    </marker>
+    <marker id="arrowSoft" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#6b7280" />
+    </marker>
+    <marker id="arrowGreen" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#15803d" />
+    </marker>
+    <marker id="arrowOrange" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#ea580c" />
+    </marker>
+  </defs>
+
+  <rect class="bg" x="0" y="0" width="1800" height="1400" />
+  <text class="title" x="48" y="58">TrafagSalesExporter / BiDashboard - technische Systemarchitektur</text>
+  <text class="subtitle" x="50" y="86">Stand 2026-05-20 | Produktive Applikation ohne Test-/Probeprogramme | ASP.NET Core Blazor Server, SQLite, SharePoint, SAP/HANA/OData/Manual Excel</text>
+
+  <rect class="layer" x="40" y="118" width="1720" height="90" rx="8" />
+  <text class="section" x="60" y="148">Deployment und Laufzeit</text>
+  <text class="txt" x="60" y="174">Fuehrendes Projekt: TrafagSalesExporter.csproj</text>
+  <text class="txt" x="360" y="174">Publish-Ausgabe: BiDashboard.dll, keine EXE/AppHost</text>
+  <text class="txt" x="770" y="174">IIS URL: https://trch-webapp-bidashboard.trafagch.local/BiDashboard/</text>
+  <text class="txt" x="1270" y="174">Runtime: .NET 8 / ASP.NET Core Hosting Bundle</text>
+  <text class="small" x="60" y="196">Publish-Ziel: \\trch-webapp-bidashboard.trafagch.local\BiDashboard$\ | web.config: dotnet .\BiDashboard.dll, stdout logs .\logs\stdout, out-of-process Diagnose</text>
+
+  <!-- Actors and hosting -->
+  <rect class="external" x="70" y="250" width="210" height="78" rx="8" />
+  <text class="box-title" x="92" y="276">Benutzer</text>
+  <text class="small" x="92" y="298">Browser im Trafag-Netz</text>
+  <text class="small" x="92" y="316">Finance / HR / Admin</text>
+
+  <rect class="security" x="340" y="236" width="250" height="110" rx="8" />
+  <text class="box-title" x="362" y="262">Authentisierung</text>
+  <text class="small" x="362" y="286">IIS / Windows Auth vorbereitet</text>
+  <text class="small" x="362" y="304">AD-Rollen aktuell deaktivierbar</text>
+  <text class="small" x="362" y="322">HR und Finance: eigene Logins</text>
+
+  <rect class="ui" x="650" y="226" width="470" height="135" rx="8" />
+  <text class="box-title" x="672" y="252">Blazor Server UI</text>
+  <text class="small" x="672" y="276">Dashboard / Export Dashboard</text>
+  <text class="small" x="672" y="294">Finance Vergleich / Management Analyse</text>
+  <text class="small" x="672" y="312">HR KPI</text>
+  <text class="small" x="672" y="330">Admin: Standorte, Settings, Transformationen, Logs</text>
+
+  <rect class="service" x="1180" y="236" width="270" height="110" rx="8" />
+  <text class="box-title" x="1202" y="262">Startup / Background</text>
+  <text class="small" x="1202" y="286">DatabaseInitializationService</text>
+  <text class="small" x="1202" y="304">DatabaseSchemaMaintenanceService</text>
+  <text class="small" x="1202" y="322">TimerBackgroundService</text>
+
+  <rect class="data" x="1510" y="236" width="210" height="110" rx="8" />
+  <text class="box-title" x="1532" y="262">SQLite</text>
+  <text class="small" x="1532" y="286">trafag_exporter.db</text>
+  <text class="small" x="1532" y="304">WAL/SHM auf Server</text>
+  <text class="small" x="1532" y="322">App-Pool braucht Modify</text>
+
+  <path class="line" d="M280 289 H340" />
+  <path class="line" d="M590 289 H650" />
+  <path class="line" d="M1120 292 H1180" />
+  <path class="line-green" d="M1450 292 H1510" />
+
+  <!-- Main application services -->
+  <rect class="layer" x="40" y="400" width="1720" height="325" rx="8" />
+  <text class="section" x="60" y="430">Applikationskern und Services</text>
+
+  <rect class="service" x="80" y="470" width="260" height="105" rx="8" />
+  <text class="box-title" x="102" y="496">ExportOrchestrationService</text>
+  <text class="small" x="102" y="520">Startet Einzel-/Alle-Exporte</text>
+  <text class="small" x="102" y="538">Status fuer UI und Timer</text>
+  <text class="small" x="102" y="556">Schreibt ExportLogs</text>
+
+  <rect class="service" x="390" y="470" width="260" height="105" rx="8" />
+  <text class="box-title" x="412" y="496">SiteExportService</text>
+  <text class="small" x="412" y="520">Quelle je Standort aufloesen</text>
+  <text class="small" x="412" y="538">Adapter ausfuehren</text>
+  <text class="small" x="412" y="556">Lokale/SharePoint-Ausgabe</text>
+
+  <rect class="service" x="700" y="470" width="285" height="105" rx="8" />
+  <text class="box-title" x="722" y="496">DataSourceAdapterResolver</text>
+  <text class="small" x="722" y="520">ConnectionKind entscheidet</text>
+  <text class="small" x="722" y="538">HANA / SAP Gateway / Manual Excel</text>
+  <text class="small" x="722" y="556">einheitliches SalesRecord-Modell</text>
+
+  <rect class="service" x="1035" y="470" width="285" height="105" rx="8" />
+  <text class="box-title" x="1057" y="496">Transformationen</text>
+  <text class="small" x="1057" y="520">RecordTransformationService</text>
+  <text class="small" x="1057" y="538">TransformationCatalog</text>
+  <text class="small" x="1057" y="556">Copy, Replace, Currency, FirstNonEmpty</text>
+
+  <rect class="service" x="1370" y="470" width="285" height="105" rx="8" />
+  <text class="box-title" x="1392" y="496">CentralSalesRecordService</text>
+  <text class="small" x="1392" y="520">Standortdaten ersetzen</text>
+  <text class="small" x="1392" y="538">Batch Insert in CentralSalesRecords</text>
+  <text class="small" x="1392" y="556">Grundlage fuer Cockpits und Endexcel</text>
+
+  <path class="line" d="M340 522 H390" />
+  <path class="line" d="M650 522 H700" />
+  <path class="line" d="M985 522 H1035" />
+  <path class="line-green" d="M1320 522 H1370" />
+  <path class="line-green" d="M1512 575 V640 H1615 V346" />
+
+  <rect class="service" x="80" y="610" width="260" height="80" rx="8" />
+  <text class="box-title" x="102" y="636">ConsolidatedExportService</text>
+  <text class="small" x="102" y="660">Sales_All_yyyy-MM-dd.xlsx</text>
+  <text class="small" x="102" y="678">zentraler Export aus CentralSalesRecords</text>
+
+  <rect class="service" x="390" y="610" width="260" height="80" rx="8" />
+  <text class="box-title" x="412" y="636">ExcelExportService</text>
+  <text class="small" x="412" y="660">Standortdateien und Endexcel</text>
+  <text class="small" x="412" y="678">Finance-Spalten + Hilfe-Blatt</text>
+
+  <rect class="service" x="700" y="610" width="285" height="80" rx="8" />
+  <text class="box-title" x="722" y="636">FinanceReconciliationService</text>
+  <text class="small" x="722" y="660">Soll/Ist gegen FinanceReferences</text>
+  <text class="small" x="722" y="678">Landeslogiken: IT, UK, ES, DE vorbereitet</text>
+
+  <rect class="service" x="1035" y="610" width="285" height="80" rx="8" />
+  <text class="box-title" x="1057" y="636">ManagementCockpitService</text>
+  <text class="small" x="1057" y="660">Analysen aus Einzeldateien</text>
+  <text class="small" x="1057" y="678">Analysen aus CentralSalesRecords</text>
+
+  <rect class="service" x="1370" y="610" width="285" height="80" rx="8" />
+  <text class="box-title" x="1392" y="636">HR KPI Services</text>
+  <text class="small" x="1392" y="660">HrKpiService + AccessService</text>
+  <text class="small" x="1392" y="678">liest HR-Excel-Dateien aus konfiguriertem Ordner</text>
+
+  <path class="line-soft" d="M144 575 V610" />
+  <path class="line-soft" d="M520 575 V610" />
+  <path class="line-soft" d="M842 575 V610" />
+  <path class="line-soft" d="M1177 575 V610" />
+
+  <!-- Sources -->
+  <rect class="layer" x="40" y="760" width="1720" height="260" rx="8" />
+  <text class="section" x="60" y="790">Datenquellen und Adapter</text>
+
+  <rect class="external" x="80" y="830" width="270" height="120" rx="8" />
+  <text class="box-title" x="102" y="856">SAP HANA / BI1 / SAGE</text>
+  <text class="small" x="102" y="880">HanaQueryService</text>
+  <text class="small" x="102" y="898">HanaDataSourceAdapter</text>
+  <text class="small" x="102" y="916">FR/IT/US B1, IN SAGE/HANA</text>
+  <text class="small" x="102" y="934">Schema je Standort</text>
+
+  <rect class="external" x="410" y="830" width="270" height="120" rx="8" />
+  <text class="box-title" x="432" y="856">SAP Gateway / OData</text>
+  <text class="small" x="432" y="880">SapGatewayService</text>
+  <text class="small" x="432" y="898">SapCompositionService</text>
+  <text class="small" x="432" y="916">Quellen, Joins, Feldmappings</text>
+  <text class="small" x="432" y="934">CH/AT ZSCHWEIZ</text>
+
+  <rect class="external" x="740" y="830" width="300" height="120" rx="8" />
+  <text class="box-title" x="762" y="856">Manual Excel / CSV</text>
+  <text class="small" x="762" y="880">ManualExcelImportService</text>
+  <text class="small" x="762" y="898">lokal, UNC oder SharePoint Download</text>
+  <text class="small" x="762" y="916">UK Sage, ES Sage CSV, DE Alphaplan</text>
+  <text class="small" x="762" y="934">konfigurierbare Spaltenmappings</text>
+
+  <rect class="external" x="1100" y="830" width="270" height="120" rx="8" />
+  <text class="box-title" x="1122" y="856">SharePoint / Graph</text>
+  <text class="small" x="1122" y="880">SharePointUploadService</text>
+  <text class="small" x="1122" y="898">Upload Standort-/Zentraldateien</text>
+  <text class="small" x="1122" y="916">Download Manual Imports</text>
+  <text class="small" x="1122" y="934">ClientId/TenantId/Secret aus Settings</text>
+
+  <rect class="output" x="1430" y="830" width="270" height="120" rx="8" />
+  <text class="box-title" x="1452" y="856">Dateisystem / Output</text>
+  <text class="small" x="1452" y="880">lokaler Standardpfad ./output</text>
+  <text class="small" x="1452" y="898">optionale Standort-/Zentralpfade</text>
+  <text class="small" x="1452" y="916">Sales_TRxx_yyyy-MM-dd.xlsx</text>
+  <text class="small" x="1452" y="934">Sales_All_yyyy-MM-dd.xlsx</text>
+
+  <path class="line-orange" d="M350 890 H700" />
+  <path class="line-orange" d="M680 890 H740" />
+  <path class="line-orange" d="M1040 890 H1100" />
+  <path class="line-orange" d="M1370 890 H1430" />
+  <path class="line-soft dash" d="M890 830 V720" />
+  <path class="line-soft dash" d="M1215 830 V690" />
+
+  <!-- Data model -->
+  <rect class="layer" x="40" y="1055" width="1055" height="285" rx="8" />
+  <text class="section" x="60" y="1085">Persistenzmodell SQLite - wichtigste Tabellen</text>
+
+  <rect class="data" x="70" y="1120" width="230" height="88" rx="8" />
+  <text class="box-title" x="92" y="1146">Sites</text>
+  <text class="small" x="92" y="1168">Standorte, TSC, Land</text>
+  <text class="small" x="92" y="1186">SourceSystem, ManualImportFilePath</text>
+
+  <rect class="data" x="330" y="1120" width="230" height="88" rx="8" />
+  <text class="box-title" x="352" y="1146">SourceSystemDefinitions</text>
+  <text class="small" x="352" y="1168">ConnectionKind</text>
+  <text class="small" x="352" y="1186">SAP / BI1 / SAGE / MANUAL_EXCEL</text>
+
+  <rect class="data" x="590" y="1120" width="230" height="88" rx="8" />
+  <text class="box-title" x="612" y="1146">Mappings</text>
+  <text class="small" x="612" y="1168">SapSource/Join/FieldMappings</text>
+  <text class="small" x="612" y="1186">ManualExcelColumnMappings</text>
+
+  <rect class="data" x="850" y="1120" width="215" height="88" rx="8" />
+  <text class="box-title" x="872" y="1146">CentralSalesRecords</text>
+  <text class="small" x="872" y="1168">normalisierte SalesRecord-Zeilen</text>
+  <text class="small" x="872" y="1186">Basis fuer Endexcel/Cockpit</text>
+
+  <rect class="data" x="70" y="1230" width="230" height="78" rx="8" />
+  <text class="box-title" x="92" y="1256">ExportSettings</text>
+  <text class="small" x="92" y="1278">Datumfilter, Timer, Pfade</text>
+  <text class="small" x="92" y="1296">Debug Live-Logging</text>
+
+  <rect class="data" x="330" y="1230" width="230" height="78" rx="8" />
+  <text class="box-title" x="352" y="1256">SharePointConfigs</text>
+  <text class="small" x="352" y="1278">SiteUrl, ExportFolder</text>
+  <text class="small" x="352" y="1296">Tenant/Client/Secret</text>
+
+  <rect class="data" x="590" y="1230" width="230" height="78" rx="8" />
+  <text class="box-title" x="612" y="1256">Finance-Tabellen</text>
+  <text class="small" x="612" y="1278">FinanceReferences</text>
+  <text class="small" x="612" y="1296">BudgetRates, IntercompanyRules</text>
+
+  <rect class="data" x="850" y="1230" width="215" height="78" rx="8" />
+  <text class="box-title" x="872" y="1256">Logs</text>
+  <text class="small" x="872" y="1278">AppEventLogs</text>
+  <text class="small" x="872" y="1296">ExportLogs</text>
+
+  <!-- Operational notes -->
+  <rect class="layer" x="1130" y="1055" width="630" height="285" rx="8" />
+  <text class="section" x="1150" y="1085">Betrieb, Security, fachliche Besonderheiten</text>
+
+  <rect class="security" x="1160" y="1120" width="270" height="86" rx="8" />
+  <text class="box-title" x="1182" y="1146">Zugriff</text>
+  <text class="small" x="1182" y="1168">Security.Enabled steuert globale AD-Policy</text>
+  <text class="small" x="1182" y="1186">Finance/HR Cockpit eigene Passwortsperren</text>
+
+  <rect class="note" x="1460" y="1120" width="270" height="86" rx="8" />
+  <text class="box-title" x="1482" y="1146">Serveranforderungen</text>
+  <text class="small" x="1482" y="1168">.NET 8 Hosting Bundle</text>
+  <text class="small" x="1482" y="1186">kein Microsoft Excel noetig</text>
+
+  <rect class="note" x="1160" y="1230" width="270" height="86" rx="8" />
+  <text class="box-title" x="1182" y="1256">Finance-Sonderregeln</text>
+  <text class="small" x="1182" y="1278">IT: Trafag Italia ausgeschlossen</text>
+  <text class="small" x="1182" y="1296">DE: Alphaplan provisorisch vorbereitet</text>
+
+  <rect class="note" x="1460" y="1230" width="270" height="86" rx="8" />
+  <text class="box-title" x="1482" y="1256">IIS Diagnose</text>
+  <text class="small" x="1482" y="1278">diag.txt beweist korrekten Pfad</text>
+  <text class="small" x="1482" y="1296">Event Viewer bei 500 pruefen</text>
+
+  <!-- Legend -->
+  <rect class="ui" x="60" y="1355" width="22" height="16" rx="3" />
+  <text class="tiny" x="90" y="1368">UI</text>
+  <rect class="service" x="145" y="1355" width="22" height="16" rx="3" />
+  <text class="tiny" x="175" y="1368">Service</text>
+  <rect class="data" x="255" y="1355" width="22" height="16" rx="3" />
+  <text class="tiny" x="285" y="1368">SQLite/Persistenz</text>
+  <rect class="external" x="415" y="1355" width="22" height="16" rx="3" />
+  <text class="tiny" x="445" y="1368">externes System</text>
+  <rect class="security" x="585" y="1355" width="22" height="16" rx="3" />
+  <text class="tiny" x="615" y="1368">Security/Betrieb</text>
+  <text class="tiny" x="1470" y="1368">Quelle: Codebasis TrafagSalesExporter, Stand 2026-05-20</text>
+</svg>

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: