🎉 Feat(docs): Added new error handling documentation and roadmap images

backend/docs/COMMON_ERRORS.md

@@ -136,9 +136,30 @@ Das System verwendet einen 5-Minuten Sicherheitspuffer, bevor es einen Job beend
 | `POST /api/jobs/<id>/extend` | Job-Laufzeit verlängern |
 | `POST /api/jobs/<id>/finish` | Job manuell beenden (Admin) |
 
+## Benutzer-Authentifizierung
+
+### Schema-Problem beim User-Load - "tuple index out of range"
+
+**Problem:**
+```
+2025-05-31 23:08:12 - [APP] app - [WARN] WARNING - Schema-Problem beim User-Load für ID 1: tuple index out of range
+```
+
+**Ursache:** Der Flask-Login User-Loader versuchte auf Tupel-Indizes zuzugreifen, die nicht existierten, wenn die Fallback-Logik mit manueller SQL-Abfrage verwendet wurde.
+
+**Lösungen:**
+1. Der User-Loader wurde mit robuster Tupel-Behandlung überarbeitet
+2. Mehrstufiges Fallback-System implementiert:
+   - Primär: ORM-Query
+   - Sekundär: Erweiterte manuelle SQL-Abfrage
+   - Tertiär: Notfall-User-Objekt
+3. Alle Tupel-Zugriffe mit Längen-Prüfungen versehen
+
+**Behoben in:** app.py (User-Loader Funktion)
+
 ## Flask-Login Fehler
 
-### AttributeError: 'User' object has no attribute 'is_authenticated'
+### UserMixin-Attribute fehlen
 
 **Problem:**
 ```