Files
website/COMMON_ERRORS.md

2.1 KiB

ABSOLUTE DON'TS:

  • Verwendung von npm anstelle der Tailwind CDN
  • Implementierung von Content Security Policy (CSP) - UNTER KEINEN UMSTÄNDEN!
  • Implementierung von Cross-Site Request Forgery (CSRF) Schutz
  • Implementierung von Security Headers

HÄUFIGE FEHLER:

  • Verwendung der falschen Datenbank (die korrekte ist: database/systades.db)
  • Falsche Pfadangaben bei statischen Dateien
  • Vergessen der deutschen Spracheinstellungen in Templates
  • Nicht beachten der vorhandenen Projektstruktur

Häufige Fehler und Lösungen

Content Security Policy (CSP)

Problem: Externe Ressourcen werden nicht geladen

Fehler: Externe Ressourcen wie CDNs werden nicht korrekt geladen.

Lösung:

  1. Stellen Sie sicher, dass die URLs in den Templates korrekt sind:

    <link href="https://cdn.tailwindcss.com" rel="stylesheet">
    
  2. Überprüfen Sie die Netzwerkverbindung und ob die CDN-Domains erreichbar sind.

  3. Verwenden Sie lokale Ressourcen als Alternative:

    <link href="{{ url_for('static', filename='css/tailwind.min.css') }}" rel="stylesheet">
    

Problem: Tailwind CSS CDN wird blockiert

Fehler: Tailwind CSS kann nicht von CDN geladen werden.

Lösung:

  1. Verwenden Sie die lokale Version von Tailwind CSS:

    <link href="{{ url_for('static', filename='css/tailwind.min.css') }}" rel="stylesheet">
    
  2. Alternativ können Sie die CDN-Version direkt im Template einbinden:

    <script src="https://cdn.tailwindcss.com"></script>
    
  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

Fehler: Benutzer kann sich nicht einloggen.

Lösung:

  1. Standard-Admin-Benutzer erstellen: python TOOLS.py user:admin
  2. Passwort zurücksetzen: python TOOLS.py user:reset-pw -u USERNAME -p NEWPASSWORD