Cable-consolidation/docs/02_Entwicklung_Setup.md

Entwickler-Setup & Guideline

Wenn du weitere Features zum Cable Consolidation Add-In hinzufügen möchtest, hilft dir dieses Dokument beim lokalen Setup.

1. Lokale Entwicklungsumgebung

Voraussetzungen:

• Node.js (>= 16.x)
• npm (wird mit Node.js installiert)
• Microsoft Excel Desktop-App (für Windows/Mac) oder Office 365 Web

Installation:

git clone https://gitea.casademm.de/Peacock/Cable-consolidation.git
cd Cable-consolidation
npm install

2. Den Entwicklungs-Server starten

Um Änderungen lokal zu testen, führe aus:

npm start

Was passiert dabei?

1. Der Befehl startet einen lokalen HTTPS-Webserver (webpack-dev-server) auf Port 3037 (oder wie in der webpack.config.js angegeben).
2. Es führt im Hintergrund (wenn auf Windows) ein Skript aus, das die manifest.xml an dein lokales Excel Desktop "sideloadet".
3. Deine Excel App öffnet sich automatisch. Du findest den Add-In Button unter "Start" (Ganz rechts).
4. Wenn du Code-Dateien (.tsx, .ts, .css) speicherst, wird das Add-In im Aufgabenbereich dank "Hot Module Replacement" sofort automatisch neu geladen.

3. Typische Fehler & Lösungen

• Zertifikatsfehler im Browser: Web-Add-Ins erfordern zwingend HTTPS. Falls der Dev-Server meckert, dass kein Zertifikat vorhanden ist, führe aus: npx office-addin-dev-certs install
• CORS-Probleme bei externen Requests: Solange ihr alles komplett im Frontend macht (wie beim SheetJS-Upload), gibt es keine CORS Probleme. Falls ihr künftig aber APIs vom Firmen-Backend abfragen wollt, müsst ihr an Nginx (bzw. dem Backend) entsprechende Access-Control-Allow-Origin Header setzen.

4. Für die Produktion bauen

Wenn du ein neues Feature fertiggestellt hast, musst du das Projekt bauen, um minifizierte, optimierte JavaScript-Bundles zu erhalten:

npm run build

Das Ergebnis liegt anschließend im Ordner /dist. Die dortigen Dateien müssen dann einfach auf den Produktions-Server (kabel.casademm.de) hochgeladen und dort überschrieben werden.