background, mindmap

COMMON_ERRORS.md

@@ -16,7 +16,82 @@
 - Vergessen der Mindmap-Datenstruktur gemäß der Roadmap
 
 # Häufige Fehler und Lösungen
-D
+
+## Datenbankfehler
+
+### Fehler: "no such column: user.password"
+
+**Fehlerbeschreibung:**
+```
+sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) no such column: user.password
+[SQL: SELECT user.id AS user_id, user.username AS user_username, user.email AS user_email, user.password AS user_password, user.created_at AS user_created_at, user.is_active AS user_is_active, user.role AS user_role 
+FROM user 
+WHERE user.id = ?]
+```
+
+**Ursache:**
+Die Spalte `password` fehlt in der Tabelle `user` der SQLite-Datenbank. Dies kann durch eine unvollständige Datenbankinitialisierung oder ein fehlerhaftes Schema-Update verursacht worden sein.
+
+**Lösung:**
+
+1. **Datenbank reparieren mit dem Fix-Skript**
+
+   ```bash
+   python fix_user_table.py
+   ```
+
+   Dieses Skript:
+   - Prüft, ob die Tabelle `user` existiert und erstellt sie, falls nicht
+   - Prüft, ob die Spalte `password` existiert und fügt sie hinzu, falls nicht
+
+2. **Standardbenutzer erstellen**
+
+   ```bash
+   python create_default_users.py
+   ```
+
+   Dieses Skript:
+   - Erstellt Standardbenutzer (admin, user), falls keine vorhanden sind
+   - Setzt Passwörter mit korrektem Hashing
+
+3. **Datenbank testen**
+
+   ```bash
+   python test_app.py
+   ```
+
+   Dieses Skript überprüft:
+   - Ob die Datenbank existiert
+   - Ob die Tabelle `user` korrekt konfiguriert ist
+   - Ob Benutzer vorhanden sind
+
+## Häufige Ursachen für Datenbankfehler
+
+1. **Inkonsistente Datenbankschemas**
+   - Unterschiede zwischen dem SQLAlchemy-Modell und der tatsächlichen Datenbankstruktur
+   - Fehlende Spalten, die in den Modellen definiert sind
+
+2. **Falsche Datenbankinitialisierung**
+   - Die Datenbank wurde nicht korrekt initialisiert
+   - Fehler bei der Migration oder dem Schema-Update
+
+3. **Datenbankdatei-Korrumpierung**
+   - Die SQLite-Datenbankdatei wurde beschädigt
+   - Lösung: Sicherung wiederherstellen oder Datenbank neu erstellen
+
+## Vorbeugende Maßnahmen
+
+1. **Regelmäßige Backups**
+   - Tägliche Sicherung der Datenbankdatei
+
+2. **Schema-Validierung**
+   - Regelmäßige Überprüfung der Datenbankstruktur
+   - Automatisierte Tests für Datenbankschema
+
+3. **Datenbankmigration**
+   - Verwenden Sie Flask-Migrate für strukturierte Datenbank-Updates
+   - Dokumentieren Sie alle Schemaänderungen
+
 ## Content Security Policy (CSP)
 
 ### Problem: Externe Ressourcen werden nicht geladen
@@ -79,15 +154,6 @@ D
 
 3. Stellen Sie sicher, dass die Datei `static/css/tailwind.min.css` existiert und aktuell ist.
 
-## Datenbank-Fehler
-
-### Problem: Datenbank existiert nicht
-**Fehler:** SQLite-Datenbank kann nicht geöffnet werden.
-
-**Lösung:**
-1. Datenbank initialisieren: `python TOOLS.py db:rebuild`
-2. Sicherstellen, dass das Datenbankverzeichnis existiert und Schreibrechte hat
-
 ## Authentifizierung
 
 ### Problem: Login funktioniert nicht