update docs and README

README.md

@@ -40,6 +40,7 @@ Alle ausführlichen Leitfäden und Dokumentationen findest du im Ordner [`/docs`
 2. **[Entwickler-Setup](./docs/02_Entwicklung_Setup.md)**: Wie setze ich das Projekt lokal auf und entwickle weiter?
 3. **[Benutzerhandbuch](./docs/03_Benutzerhandbuch.md)**: Die Schritt-für-Schritt Anleitung für die Endnutzer.
 4. **[Deployment & Hosting](./docs/04_Deployment.md)**: Wie kommt das Tool auf den Ubuntu-Server und in das M365 Admin Center?
+5. **[Lokales Prod-Add-In (Sideloading)](./docs/05_Lokales_Prod_Sideloading.md)**: Wie lade ich das Produktions-Add-in in meiner lokalen Excel-App, wenn der Dev-Server nicht läuft?
 
 ---
 

docs/05_Lokales_Prod_Sideloading.md

@@ -0,0 +1,54 @@
+# Lokales Testen des Produktions-Add-Ins (Sideloading)
+
+Wenn der lokale Entwicklungs-Server (`npm start`) nicht läuft, kann das Produktions-Add-In (welches auf dem Live-Server gehostet wird) nicht einfach in der Excel Desktop-App über das Microsoft Admin-Center "hochgeladen" werden.
+Um die Produktions-Version (`manifest.prod.xml`) dauerhaft lokal in Excel zu installieren, nutzt man unter Windows einen **freigegebenen Netzwerkordner (Shared Folder)**.
+
+Folge dieser Schritt-für-Schritt-Anleitung, um dein lokales Excel für das Produktions-Add-In einzurichten:
+
+## 1. Vorbereitung des Produktions-Manifests
+
+1. Stelle sicher, dass du eine tagesaktuelle Version der `manifest.prod.xml` hast. Du kannst diese unter anderem **direkt aus dem entwickelten Add-In herunterladen**, wenn du es lokal laufen hast (Link unten im Add-In: *Prod-Manifest (.xml)*).
+2. Diese Datei enthält die echten Produktions-URLs statt der `localhost`-Adressen.
+
+*(Optional: Wenn du Dev- und Prod-Add-In gleichzeitig in Excel nutzen möchtest, stelle sicher, dass die `<Id>` in der `manifest.prod.xml` von der ID in der normalen `manifest.xml` abweicht.)*
+
+## 2. Einen lokalen Ordner freigeben (Shared Folder)
+
+Excel Desktop benötigt zwingend einen Netzwerkpfad (Share), um Manifeste lokal zu finden.
+
+1. Erstelle irgendwo auf deinem PC einen neuen Ordner, z. B. `C:\ExcelManifests`.
+2. Lege deine heruntergeladene `manifest.prod.xml` in diesen Ordner.
+3. Klicke im Windows Explorer mit der **rechten Maustaste** auf den Ordner -> **Eigenschaften**.
+4. Gehe zum Reiter **Freigabe** und klicke auf **Erweiterte Freigabe...**.
+5. Setze den Haken bei **Diesen Ordner freigeben**. Merke dir den Freigabenamen (meist der Ordnername, z.B. `ExcelManifests`).
+6. Klicke auf **OK** und schließe die Eigenschaften. Du solltest nun den Netzwerkpfad sehen (z. B. `\\DeinPCName\ExcelManifests` oder `\\localhost\ExcelManifests`).
+
+## 3. Den Ordner in Excel als "Trusted Catalog" hinzufügen
+
+Damit Excel diesen freigegebenen Ordner nach Manifesten durchsucht:
+
+1. Öffne ein beliebiges lokales **Excel**.
+2. Gehe auf **Datei** -> **Optionen** -> **Trust Center** (bzw. Sicherheitscenter).
+3. Klicke auf den Button **Einstellungen für das Trust Center...**.
+4. Wähle im linken Menü **Vertrauenswürdige Add-In-Kataloge** aus.
+5. Trage unten bei **Katalog-URL** den Netzwerkpfad aus Schritt 2 ein (z. B. `\\localhost\ExcelManifests`).
+6. Klicke auf **Katalog hinzufügen**.
+7. **WICHTIG:** Setze den Haken bei **Im Menü anzeigen** (Show in Menu) für diesen neuen Eintrag!
+8. Klicke auf **OK** und **starte Excel komplett neu**.
+
+## 4. Das Produktions-Add-in in Excel laden
+
+Nach dem Neustart von Excel:
+
+1. Gehe im Menüband auf den Reiter **Einfügen** -> **Add-Ins abrufen** (Get Add-ins).
+2. Oben im erscheinenden Dialogfenster siehst du nun einen neuen Reiter namens **FREIGEGEBENER ORDNER** (Shared Folder).
+3. Klicke darauf. Dort taucht nun dein Produktions-Add-in auf.
+4. Klicke auf **Hinzufügen**.
+
+**Das war's!** 
+Ab sofort kannst du dein Produktions-Add-in ganz normal über das Menü starten, auch wenn dein lokaler Entwicklungs-Server aus ist.
+
+### Updates des Add-Ins
+Da die Excel Desktop-App bei jedem Start des Add-Ins die aktuellsten React/Web-Dateien von deinem Server lädt, musst du diesen Prozess **nicht** bei jedem Update wiederholen. 
+
+Du musst die `manifest.prod.xml` im Ordner `C:\ExcelManifests` nur dann aktualisieren (überschreiben) und das Add-In neu in Excel laden, wenn sich grundlegende Metadaten im Manifest ändern (wie z. B. der Name des Add-Ins, die URL, Icons oder angeforderte Berechtigungen).

webpack.config.js

@@ -72,6 +72,11 @@ module.exports = async (env, options) => {
             from: "assets/*",
             to: "assets/[name][ext][query]",
           },
+          {
+            from: "docs/*",
+            to: "docs/[name][ext][query]",
+            noErrorOnMissing: true,
+          },
           {
             from: "manifest*.xml",
             to: "[name]" + "[ext]",