bugfix-protokoll

# Bugfix-Protokoll: Systematisches 6-Phasen Debugging Strukturiertes Vorgehen bei Bugs — von der Symptom-Analyse bis zur Verifikation. Verhindert planloses Herumprobieren und stellt sicher, dass Fixes nachhaltig sind. --- ## Uebersicht | Phase | Name | Ziel | Max. Zeit | |-------|------|------|-----------| | 1 | Schnell-Checks | Offensichtliche Ursachen ausschliessen | 2 min | | 2 | Diagnose | Ursache lokalisieren | 10 min | | 3 | Isolierter Test | Bug reproduzierbar machen | 5 min | | 4 | Fix | Minimale Korrektur | 10 min | | 5 | Verifikation | Fix pruefen + Seiteneffekte | 5 min | | 6 | Dokumentation | Wissen sichern | 2 min | **20-Minuten-Regel:** Wenn nach 20 Minuten kein Fortschritt → Ansatz wechseln oder Hilfe holen. --- ## Phase 1: Schnell-Checks (2 min) Bevor du tief einsteigst — pruefe die haeufigsten Ursachen: ### Checkliste - [ ] **Syntax-Fehler?** Fehlermeldung genau lesen, Zeile pruefen - [ ] **Import-Fehler?** Modul installiert? Richtiger Name? Circular Import? - [ ] **Tippfehler?** Variablen-/Funktionsnamen korrekt? - [ ] **Falscher Datentyp?** String statt Int? None wo Objekt erwartet? - [ ] **Veralteter Cache?** `__pycache__` loeschen, Neustart - [ ] **Falsche Umgebung?** Richtiges venv aktiv? Richtige Python-Version? - [ ] **Encoding?** UTF-8 vs. cp1252 (Windows-Klassiker) ### Schnell-Aktionen ```bash # Cache leeren find . -name "__pycache__" -type d -exec rm -rf {} + 2>&1 find . -name "*.pyc" -delete 2>&1 # Imports pruefen python -c "import mod...