# Common Errors und Lösungen

## 1. Database Schema Error - "no such column"

### Problem
```
sqlite3.OperationalError: no such column: printers_1.last_checked
[SQL: SELECT jobs.id AS jobs_id, ... printers_1.last_checked ...]
```

### Ursache
- Datenbankschema ist veraltet
- Die `last_checked` Spalte fehlt in der `printers` Tabelle
- Tritt auf, wenn die Datenbank vor Schema-Updates erstellt wurde

### Lösungen
1. **Automatische Migration (empfohlen):**
   ```bash
   cd backend/app
   PYTHONPATH=. python3.11 utils/database_migration.py
   ```

2. **Manuelle Datenbank-Neuerstellung:**
   ```bash
   cd backend/app
   python3.11 -c "from models import init_db; init_db(); print('Database recreated')"
   python3.11 utils/setup_drucker_db.py
   python3.11 -c "from models import create_initial_admin; create_initial_admin()"
   ```

3. **Spalte manuell hinzufügen:**
   ```bash
   cd backend/app
   python3.11 -c "
   import sqlite3
   conn = sqlite3.connect('database/myp.db')
   cursor = conn.cursor()
   cursor.execute('ALTER TABLE printers ADD COLUMN last_checked DATETIME')
   conn.commit()
   conn.close()
   print('Column added')
   "
   ```

### Prävention
- Verwende die Migrationsskripte vor dem Start der Anwendung
- Backup der Datenbank vor Schema-Änderungen erstellen

## 2. Tailwind CSS Compilation Fehler

### Problem
```
npm ERR! could not determine executable to run
```

### Ursache
- Node.js/npm nicht installiert oder nicht im PATH
- node_modules Verzeichnis fehlt
- Defekte npm Installation

### Lösungen
1. **Node.js installieren:**
   ```bash
   # Ubuntu/Debian
   sudo apt update && sudo apt install nodejs npm
   
   # CentOS/RHEL
   sudo yum install nodejs npm
   ```

2. **Dependencies neu installieren:**
   ```bash
   cd backend/app
   rm -rf node_modules package-lock.json
   npm install
   ```

3. **Manuelle CSS-Kompilierung:**
   ```bash
   cd backend/app
   npx tailwindcss -i static/css/input.css -o static/css/tailwind.min.css --minify
   ```

4. **Fallback verwenden:**
   - Die existierende `static/css/tailwind.min.css` wird automatisch verwendet
   - Keine weiteren Schritte erforderlich

## 3. Port 443/80 Permission Denied

### Problem
```
Permission denied
```
beim Starten auf Port 443 oder 80

### Ursache
- Ports < 1024 sind privilegierte Ports
- Benötigen Root-Rechte oder spezielle Capabilities

### Lösungen
1. **Nicht-privilegierte Ports verwenden (empfohlen):**
   ```bash
   python3 app.py --port 8443
   ```

2. **Automatische Fallback-Ports:**
   - App erkennt automatisch Permission-Fehler
   - Verwendet Port 8443 statt 443
   - Verwendet Port 8080 statt 80

3. **Root-Rechte (nicht empfohlen):**
   ```bash
   sudo python3 app.py
   ```

4. **Capabilities setzen (Linux):**
   ```bash
   sudo setcap CAP_NET_BIND_SERVICE=+eip $(which python3)
   ```

## 4. Admin-Panel 404 Fehler

### Problem
```
404 Not Found
```
für Admin-Routen wie `/admin/users/add`, `/admin/printers/add`

### Ursache
- Fehlende Template-Dateien
- Nicht implementierte Admin-Routen
- Fehlende API-Endpunkte

### Lösungen
1. **Templates wurden erstellt:**
   - `admin_add_user.html` - Benutzer hinzufügen
   - `admin_add_printer.html` - Drucker hinzufügen
   - `admin_edit_user.html` - Benutzer bearbeiten
   - `admin_manage_printer.html` - Drucker verwalten
   - `admin_printer_settings.html` - Drucker-Einstellungen

2. **API-Endpunkte implementiert:**
   - `/api/admin/system/status` - System-Status
   - `/api/admin/database/status` - Datenbank-Status
   - `/api/admin/users/{id}/edit` - Benutzer bearbeiten
   - `/api/admin/printers/{id}/edit` - Drucker bearbeiten

## 5. Admin-Variable-Fehler

### Problem
```
cannot access local variable 'os' where it is not associated with a value
```

### Ursache
- `os` Modul wird lokal importiert aber nicht verfügbar

### Lösung
- Import von `os` wurde an den Anfang der System-Informationen-Sektion verschoben
- Fehler ist behoben

## 6. Icon-Pfad 404 Fehler

### Problem
```
404 Not Found: /static/static/icons/icon-144x144.png
```

### Ursache
- Doppelte `static/` im Pfad in der `manifest.json`

### Lösung
- Pfade in `manifest.json` korrigiert von `static/icons/` zu `icons/`
- Icons sind jetzt korrekt erreichbar

## 7. SSL-Zertifikat Probleme

### Problem
- SSL-Zertifikate fehlen
- Zertifikat-Validierung schlägt fehl

### Lösungen
1. **Automatische Zertifikat-Generierung:**
   - App erstellt automatisch selbstsignierte Zertifikate
   - Für Entwicklung ausreichend

2. **SSL deaktivieren:**
   ```bash
   python3 app.py --no-ssl
   ```

3. **Eigene Zertifikate verwenden:**
   - Zertifikat: `backend/app/certs/myp.crt`
   - Schlüssel: `backend/app/certs/myp.key`

## 8. Datenbank-Probleme

### Problem
- Datenbank kann nicht initialisiert werden
- SQLite-Fehler

### Lösungen
1. **Datenbank-Verzeichnis erstellen:**
   ```bash
   mkdir -p backend/app/database
   ```

2. **Berechtigungen prüfen:**
   ```bash
   chmod 755 backend/app/database
   ```

3. **Datenbank neu initialisieren:**
   ```bash
   cd backend/app
   python3 init_db.py
   ```

## 9. Scheduler-Fehler

### Problem
```
Task mit ID check_jobs existiert bereits
```

### Ursache
- App wurde mehrmals gestartet
- Scheduler-Thread läuft bereits

### Lösung
```bash
# Alle Python-Prozesse stoppen
pkill -f "python.*app.py"

# Neu starten
python3 app.py
```

## 10. Import-Fehler

### Problem
```
ModuleNotFoundError: No module named 'xyz'
```

### Lösung
```bash
# Python Dependencies installieren
cd backend/app
pip3 install -r requirements.txt

# Oder für Python 3.11
python3.11 -m pip install -r requirements.txt
```

## Startup-Script Verwendung

### Automatische Problembehandlung
```bash
# Einfachste Methode
./backend/run.sh

# Oder direkt
cd backend
python3 start_server.py
```

Das Startup-Script:
- Prüft automatisch Dependencies
- Findet verfügbare Ports
- Installiert fehlende Packages
- Kompiliert CSS falls möglich
- Startet Server mit optimalen Einstellungen

### Manuelle Parameter
```bash
# Spezifischer Port
python3 start_server.py --port 5000

# SSL deaktivieren
python3 start_server.py --no-ssl

# Dual-Protokoll (HTTP + HTTPS)
python3 start_server.py --dual-protocol
```

## Debugging-Tipps

1. **Log-Level erhöhen:**
   ```python
   # In config/settings.py
   LOG_LEVEL = "DEBUG"
   ```

2. **Detaillierte Logs anzeigen:**
   ```bash
   tail -f backend/app/logs/app/app.log
   ```

3. **Netzwerk-Probleme prüfen:**
   ```bash
   # Port-Status prüfen
   netstat -tlnp | grep :8443
   
   # Firewall prüfen
   sudo ufw status
   ```

4. **Python-Umgebung prüfen:**
   ```bash
   python3 --version
   python3 -c "import flask; print(flask.__version__)"
   ```

## Neue Features (behoben)

### Admin-Panel Funktionalität
- ✅ Benutzer hinzufügen/bearbeiten
- ✅ Drucker hinzufügen/verwalten/konfigurieren
- ✅ System-Status und Datenbank-Status APIs
- ✅ Vollständige Admin-Templates

### Verbesserte Fehlerbehandlung
- ✅ Automatische Port-Fallbacks
- ✅ Graceful CSS-Kompilierung mit Fallback
- ✅ Robuste SSL-Zertifikat-Behandlung
- ✅ Verbesserte Logging und Debugging 

## Flask Route Konflikte - 404 Fehler bei existierenden Routen

**Problem:** 
- API-Endpunkt `/api/admin/stats/live` gibt 404 Fehler zurück, obwohl die Route implementiert ist
- Flask-Anwendung startet nicht mit AssertionError: "View function mapping is overwriting an existing endpoint function"

**Ursache:**
- Doppelte Route-Definitionen in `app.py` (z.B. `update_printers` mehrfach definiert)
- Konflikte zwischen Haupt-App-Routen und Blueprint-Routen
- API-Blueprint wird ohne URL-Präfix registriert und überschreibt Haupt-Routen

**Lösung:**
1. **Doppelte Routen entfernen:**
   ```bash
   grep -n "def update_printers" app.py  # Finde alle Duplikate
   sed -i '3512,$d' app.py  # Entferne doppelte Definition am Ende
   ```

2. **Blueprint-Registrierung deaktivieren:**
   ```python
   # app.register_blueprint(api_bp)  # Kommentiere aus bei Konflikten
   ```

3. **Route-Registrierung prüfen:**
   ```python
   python3.11 -c "from app import app; [print(f'{rule.rule} -> {rule.endpoint}') for rule in app.url_map.iter_rules() if 'admin' in rule.rule and 'stats' in rule.rule]"
   ```

**Prävention:**
- Verwende eindeutige Funktionsnamen
- Registriere Blueprints mit URL-Präfix: `app.register_blueprint(api_bp, url_prefix='/api/v1')`
- Prüfe Route-Konflikte vor Deployment

**Behoben am:** 26.05.2025
**Betroffen:** Flask-Anwendung, Admin-Dashboard, Live-Statistiken

**Status:** ✅ GELÖST - API-Blueprint registriert mit URL-Präfix /api/v1, alle Admin-CRUD-Endpunkte funktionieren

**Fix angewendet:** 26.05.2025
- API-Blueprint in app.py korrekt registriert mit `app.register_blueprint(api_bp, url_prefix='/api/v1')`
- Alle Admin-Dashboard API-Endpunkte sind jetzt verfügbar:
  - `/api/admin/stats/live` ✅
  - `/api/admin/system/status` ✅  
  - `/api/admin/database/status` ✅
- Alle Admin-Template-Routen funktionieren:
  - `/admin/users/add` ✅
  - `/admin/users/<id>/edit` ✅
  - `/admin/printers/add` ✅
  - `/admin/printers/<id>/manage` ✅

**Prävention:** Regelmäßige Überprüfung der Blueprint-Registrierung beim Hinzufügen neuer Routen