Installation Scripte hinzugefügt

Installation-Scripte.md

@@ -0,0 +1,75 @@
+# Installation-Scripte
+
+**Helper Scripts für automatisierte furt-Installation**
+
+## Getestet unter
+- OpenBSD 7.7
+- Debian 12  
+- Arch Linux
+
+## Script-System verstehen
+
+Die furt-Helper-Scripts entstanden aus mehreren manuellen Installationen und automatisieren wiederkehrende Aufgaben. Jedes Script übernimmt einen spezifischen Aspekt der Installation und kann sowohl einzeln als auch als Teil der orchestrierten Installation verwendet werden.
+
+Das modulare Design ermöglicht es einzelne Komponenten zu debuggen, zu erweitern oder bei Bedarf zu überspringen. Alle Scripts folgen POSIX-Shell-Konventionen für maximale Kompatibilität zwischen BSD- und Linux-Systemen.
+
+## Script-Übersicht
+
+Das `install.sh` Orchestrator-Script koordiniert sechs spezialisierte Helper Scripts:
+
+### Fresh Installation (alle 6 Phasen)
+1. **[setup-user.sh](setup-user-sh.md)** - System-Benutzer erstellen
+2. **[setup-directories.sh](setup-directories-sh.md)** - Verzeichnisstruktur anlegen
+3. **[sync-files.sh](sync-files-sh.md)** - Source-Code installieren
+4. **[create-service.sh](create-service-sh.md)** - System-Service integrieren
+5. **[validate-config.sh](validate-config-sh.md)** - Konfiguration validieren
+6. **[health-check.sh](health-check-sh.md)** - Service-Status prüfen
+
+### Upgrade Installation (3 Phasen)
+```bash
+./install.sh --upgrade
+```
+Führt nur Schritte 2, 3 und 5 aus - überspringt Benutzer-Erstellung und Service-Installation.
+
+## Script-Koordination
+
+Die Scripts arbeiten in einer definierten Reihenfolge zusammen:
+
+**Phase 1 → 2:** User aus Phase 1 für Directory-Ownership
+**Phase 2 → 3:** Verzeichnisse aus Phase 2 für Code-Installation  
+**Phase 3 → 4:** Code aus Phase 3 für Service-Templates
+**Phase 4 → 5:** Service-Konfiguration validieren
+**Phase 5 → 6:** Gesamtsystem testen
+
+## Einzelne Scripts verwenden
+
+Jedes Script kann für Debugging oder spezielle Anwendungsfälle einzeln ausgeführt werden:
+
+```bash
+# Nur Konfiguration validieren
+sudo ./scripts/validate-config.sh
+
+# Health-Check gegen Remote-Host
+./scripts/health-check.sh --host 192.168.1.100
+
+# Source-Code ohne Service-Neustart aktualisieren
+sudo ./scripts/sync-files.sh
+```
+
+## Script-Erweiterungen
+
+Neue Scripts können einfach in die `scripts/`-Verzeichnis hinzugefügt und vom Orchestrator aufgerufen werden. Das System ist für Erweiterungen designt ohne die bestehende Funktionalität zu beeinträchtigen.
+
+## Fehlerdiagnose
+
+Bei Script-Fehlern hilft das modulare Design bei der Lokalisierung:
+
+```bash
+# Debug-Modus für einzelne Scripts
+sh -x ./scripts/setup-directories.sh
+
+# Scripts auch bei Fehlern weiterlaufen lassen
+# Temporär 'set -e' entfernen für mehr Kontext
+```
+
+**Detaillierte Dokumentation:** Jedes der 6 Helper Scripts hat eine eigene Dokumentationsseite mit Code-Beispielen und Erweiterungsmöglichkeiten.