SkillMate/INSTALLATION.md

SkillMate Installation und Einrichtung

📋 Systemvoraussetzungen

Minimum:

• Node.js: Version 18.0.0 oder höher
• NPM: Version 8.0.0 oder höher (wird mit Node.js installiert)
• Speicherplatz: Mindestens 500 MB freier Speicher
• RAM: Mindestens 4 GB RAM
• Betriebssystem: Windows 10/11, macOS 10.15+, Linux (Ubuntu 20.04+)

Empfohlen:

• Node.js: Version 20.x LTS
• RAM: 8 GB oder mehr
• CPU: Dual-Core oder besser

🚀 Schnellstart

Windows

1. Laden Sie Node.js herunter und installieren Sie es:

   • Besuchen Sie https://nodejs.org/
   • Laden Sie die LTS-Version herunter
   • Führen Sie den Installer aus

2. Führen Sie den SkillMate Installer aus:

   # PowerShell als Administrator öffnen (nicht erforderlich, aber empfohlen)
   cd C:\Pfad\zu\SkillMate
   
   # Installer ausführen
   .\install.ps1
   

3. Starten Sie SkillMate:

   • Doppelklicken Sie auf die Desktop-Verknüpfung "SkillMate"
   • Oder führen Sie aus: .\start-skillmate.bat

Linux/macOS

1. Installieren Sie Node.js:

   # Ubuntu/Debian
   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
   sudo apt-get install -y nodejs
   
   # macOS mit Homebrew
   brew install node
   

2. Führen Sie den Installer aus:

   cd /pfad/zu/SkillMate
   chmod +x install.sh
   ./install.sh
   

3. Starten Sie SkillMate:

   ./start-skillmate.sh
   

📁 Projektstruktur nach Installation

SkillMate/
├── backend/
│   ├── .env                 # Backend-Konfiguration
│   ├── data/
│   │   └── skillmate.db     # SQLite Datenbank
│   ├── uploads/             # Hochgeladene Dateien
│   └── logs/                # Log-Dateien
├── frontend/
│   └── .env                 # Frontend-Konfiguration
├── admin-panel/
│   └── .env                 # Admin-Panel-Konfiguration
├── shared/                  # Gemeinsame TypeScript-Definitionen
├── start-skillmate.bat      # Windows Start-Script
├── start-skillmate.sh       # Linux/Mac Start-Script
└── start-skillmate.ps1      # PowerShell Start-Script

⚙️ Konfiguration

Backend (.env)

Die wichtigsten Einstellungen in backend/.env:

# Server-Port (Standard: 3001)
PORT=3001

# Umgebung (development/production)
NODE_ENV=production

# Datenbank-Pfad
DATABASE_PATH=./data/skillmate.db

# JWT Secret (automatisch generiert, NICHT TEILEN!)
JWT_SECRET=ihr-geheimer-schlüssel

# JWT Ablaufzeit
JWT_EXPIRES_IN=7d

# CORS URLs (Frontend und Admin-Panel)
CORS_ORIGIN=http://localhost:5173,http://localhost:5174

# Upload-Einstellungen
UPLOAD_DIR=./uploads
MAX_FILE_SIZE=5242880  # 5MB in Bytes

# Sync-Einstellungen für Netzwerk
NODE_ID=eindeutige-node-id
NODE_TYPE=local  # oder "admin" für Admin-Server

# Logging
LOG_LEVEL=info  # debug, info, warn, error
LOG_DIR=./logs

Frontend/Admin-Panel (.env)

# Backend API URL
VITE_API_URL=http://localhost:3001/api

# App-Name und Version
VITE_APP_NAME=SkillMate
VITE_APP_VERSION=1.0.0

🔐 Erster Login

Standard-Zugangsdaten:

• Benutzername: admin
• Passwort: admin123

⚠️ WICHTIG: Ändern Sie das Passwort sofort nach dem ersten Login!

🌐 Netzwerk-Konfiguration

Admin-Server einrichten

1. Setzen Sie in backend/.env:

   NODE_TYPE=admin
   

2. Öffnen Sie das Admin-Panel

3. Navigieren Sie zu "Netzwerk & Synchronisation"

4. Fügen Sie lokale Knoten hinzu

Lokalen Knoten einrichten

1. Setzen Sie in backend/.env:

   NODE_TYPE=local
   

2. Verwenden Sie den API-Key vom Admin-Server

Firewall-Einstellungen

Öffnen Sie folgende Ports falls nötig:

• 3001: Backend API
• 5173: Frontend (nur für Entwicklung)
• 5174: Admin-Panel (nur für Entwicklung)

🛠️ Fehlerbehebung

"Node.js ist nicht installiert"

• Installieren Sie Node.js von https://nodejs.org/
• Starten Sie Ihr Terminal/PowerShell neu

"Port bereits belegt"

• Ein anderer Dienst nutzt bereits den Port
• Beenden Sie den Dienst oder ändern Sie den Port in der .env

"Datenbank-Fehler"

• Löschen Sie backend/data/skillmate.db
• Führen Sie den Installer erneut aus

"Build-Fehler bei SQLite"

Linux/macOS:

sudo apt-get install build-essential python3
# oder
brew install python

Windows:

npm install --global windows-build-tools

📊 Datenbank-Verwaltung

Backup erstellen

# Linux/macOS
cp backend/data/skillmate.db backend/data/skillmate_backup_$(date +%Y%m%d).db

# Windows
copy backend\data\skillmate.db backend\data\skillmate_backup_%date:~-4,4%%date:~-10,2%%date:~-7,2%.db

Datenbank zurücksetzen

1. Stoppen Sie alle SkillMate-Dienste
2. Löschen Sie backend/data/skillmate.db
3. Starten Sie SkillMate neu (Datenbank wird automatisch erstellt)

🔄 Updates

Automatisches Update (wenn Git installiert)

git pull origin main
npm install  # im Hauptverzeichnis
cd backend && npm install && npm run build
cd ../frontend && npm install
cd ../admin-panel && npm install

Manuelles Update

1. Laden Sie die neueste Version herunter
2. Sichern Sie Ihre .env Dateien und die Datenbank
3. Überschreiben Sie die Dateien
4. Führen Sie den Installer erneut aus

🆘 Support

Bei Problemen:

1. Überprüfen Sie die Logs in backend/logs/
2. Stellen Sie sicher, dass alle Abhängigkeiten installiert sind
3. Führen Sie den Installer erneut aus

🔒 Sicherheitshinweise

1. Ändern Sie das Standard-Passwort sofort nach der Installation
2. Sichern Sie die .env Dateien - sie enthalten sensible Daten
3. Verwenden Sie HTTPS in Produktionsumgebungen
4. Beschränken Sie den Zugriff auf die Admin-Panel URL
5. Regelmäßige Backups der Datenbank durchführen

📈 Performance-Optimierung

Für Produktionsumgebungen:

1. Frontend/Admin-Panel bauen:

   cd frontend && npm run build
   cd ../admin-panel && npm run build
   

2. Nginx als Reverse Proxy verwenden

3. PM2 für Prozess-Management:

   npm install -g pm2
   pm2 start backend/dist/index.js --name skillmate-backend
   pm2 save
   pm2 startup
   

📝 Lizenz

SkillMate ist für den internen Gebrauch in Sicherheitsbehörden entwickelt. Weitergabe und kommerzielle Nutzung nur mit ausdrücklicher Genehmigung.