fix: Bugsweep #12 — A11y-Fixes + Mechanismus-Korrektur im Regressionstest

- settings_dialog.py: Browse-Buttons ohne accessibleName/accessibleDescription;
  _create_browse_button()-Factory eingeführt, Buttons als Instanzvariablen gespeichert
- explorer_panel.py: Refresh- und Collapse-Button sowie Filter-Input ohne
  accessibleName/accessibleDescription — Screenreader-Nutzer ohne Kontext
- test_settings_application.py: Regressionstest für Browse-Button-A11y
- test_explorer_panel_accessibility.py: Regressionstest für Explorer-Toolbar-A11y
- test_bugsweep_regressions.py: Mechanismus-Kommentar korrigiert (Race = stale
  Qt-Queue-Event, nicht Doppel-connect über separate QObjects)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: lukisch

src/gui/dialogs/settings_dialog.py

@@ -203,22 +203,26 @@ def _create_build_tab(self) -> QWidget:
         self.pyinstaller_path = QLineEdit()
         self.pyinstaller_path.setPlaceholderText("(System-Standard)")
         pyinstaller_row.addWidget(self.pyinstaller_path)
-        
-        browse_btn = QPushButton("...")
-        browse_btn.setMaximumWidth(40)
-        browse_btn.clicked.connect(lambda: self._browse_file(self.pyinstaller_path, "PyInstaller auswählen"))
-        pyinstaller_row.addWidget(browse_btn)
+
+        self.pyinstaller_browse_btn = self._create_browse_button(
+            accessible_name="PyInstaller-Datei auswählen",
+            description="Öffnet die Dateiauswahl für den PyInstaller-Pfad.",
+            callback=lambda: self._browse_file(self.pyinstaller_path, "PyInstaller auswählen"),
+        )
+        pyinstaller_row.addWidget(self.pyinstaller_browse_btn)
         pi_layout.addRow("PyInstaller:", pyinstaller_row)
-        
+
         output_row = QHBoxLayout()
         self.output_dir = QLineEdit()
         self.output_dir.setText("dist")
         output_row.addWidget(self.output_dir)
-        
-        browse_out_btn = QPushButton("...")
-        browse_out_btn.setMaximumWidth(40)
-        browse_out_btn.clicked.connect(lambda: self._browse_folder(self.output_dir, "Ausgabeverzeichnis"))
-        output_row.addWidget(browse_out_btn)
+
+        self.output_dir_browse_btn = self._create_browse_button(
+            accessible_name="Ausgabeverzeichnis auswählen",
+            description="Öffnet die Ordnerauswahl für das Standard-Ausgabeverzeichnis.",
+            callback=lambda: self._browse_folder(self.output_dir, "Ausgabeverzeichnis"),
+        )
+        output_row.addWidget(self.output_dir_browse_btn)
         pi_layout.addRow("Ausgabe:", output_row)
 
         layout.addWidget(pi_group)
@@ -307,11 +311,13 @@ def _create_sync_tab(self) -> QWidget:
         self.backup_path = QLineEdit()
         self.backup_path.setPlaceholderText("Backup-Verzeichnis")
         backup_row.addWidget(self.backup_path)
-        
-        browse_backup = QPushButton("...")
-        browse_backup.setMaximumWidth(40)
-        browse_backup.clicked.connect(lambda: self._browse_folder(self.backup_path, "Backup-Verzeichnis"))
-        backup_row.addWidget(browse_backup)
+
+        self.backup_browse_btn = self._create_browse_button(
+            accessible_name="Backup-Verzeichnis auswählen",
+            description="Öffnet die Ordnerauswahl für den Backup-Pfad.",
+            callback=lambda: self._browse_folder(self.backup_path, "Backup-Verzeichnis"),
+        )
+        backup_row.addWidget(self.backup_browse_btn)
         backup_layout.addRow("Backup-Pfad:", backup_row)
 
         self.auto_backup = QCheckBox("Automatische Backups")
@@ -373,9 +379,19 @@ def _create_appearance_tab(self) -> QWidget:
 
         layout.addWidget(accent_group)
         layout.addStretch()
-        
+
         return widget
-    
+
+    def _create_browse_button(self, accessible_name: str, description: str, callback) -> QPushButton:
+        """Erzeugt einen kompakten Browse-Button mit sprechendem A11y-Kontext."""
+        button = QPushButton("...")
+        button.setMaximumWidth(40)
+        button.setToolTip(accessible_name)
+        button.setAccessibleName(accessible_name)
+        button.setAccessibleDescription(description)
+        button.clicked.connect(callback)
+        return button
+
     def _browse_file(self, line_edit: QLineEdit, title: str):
         """Datei auswählen"""
         path, _ = QFileDialog.getOpenFileName(self, title)

src/gui/panels/explorer_panel.py

@@ -51,12 +51,20 @@ def _setup_ui(self):
 
         self.refresh_btn = QPushButton("🔄")
         self.refresh_btn.setToolTip("Aktualisieren")
+        self.refresh_btn.setAccessibleName("Explorer aktualisieren")
+        self.refresh_btn.setAccessibleDescription(
+            "Lädt die aktuelle Projektstruktur im Explorer neu."
+        )
         self.refresh_btn.setMaximumWidth(30)
         self.refresh_btn.clicked.connect(self._refresh)
         header.addWidget(self.refresh_btn)
-        
+
         self.collapse_btn = QPushButton("⬆")
         self.collapse_btn.setToolTip("Alle zuklappen")
+        self.collapse_btn.setAccessibleName("Explorer zuklappen")
+        self.collapse_btn.setAccessibleDescription(
+            "Klappt alle aktuell geöffneten Ordner im Explorer zu."
+        )
         self.collapse_btn.setMaximumWidth(30)
         self.collapse_btn.clicked.connect(self._collapse_all)
         header.addWidget(self.collapse_btn)
@@ -66,6 +74,11 @@ def _setup_ui(self):
         # Filter
         self.filter_input = QLineEdit()
         self.filter_input.setPlaceholderText("🔍 Dateien filtern...")
+        self.filter_input.setToolTip("Dateien im Explorer filtern")
+        self.filter_input.setAccessibleName("Dateifilter")
+        self.filter_input.setAccessibleDescription(
+            "Filtert die im Explorer angezeigten Projektdateien."
+        )
         self.filter_input.textChanged.connect(self._apply_filter)
         self.filter_input.setStyleSheet("""
             QLineEdit {

tests/test_bugsweep_regressions.py

@@ -1,17 +1,17 @@
 """
 Bugsweep Run #12 — Regressionstests (2026-06-20)
 
-Bug #12-1: ai_panel.py — Zombie-Signal-Verbindung beim Neustart des Workers.
-           _start_request() ersetzte self._worker ohne den alten response_received-
-           Signal-Slot zu trennen. Nach Worker-Beendigung (isRunning=False) liegt
-           das Signal noch in der Qt-Event-Queue; ein neuer Worker + erneutes connect()
-           erzeugt zwei aktive Verbindungen → _on_response wird doppelt aufgerufen
-           (doppelte Chat-Nachricht, falscher Loading-State).
-           Fix Teil 1: disconnect() vor dem Ersetzen des Workers (RuntimeError abfangen
-           falls kein Slot mehr verbunden) — verhindert neue doppelte Connections.
-           Fix Teil 2: Identitäts-Guard in _on_response (self.sender() is not self._worker
-           → return) — verwirft Events veralteter Worker, die bereits in der Qt-Event-Queue
-           lagen, bevor disconnect() aufgerufen werden konnte.
+Bug #12-1: ai_panel.py — Stale-Response-Race beim Neustart des Workers.
+           Jeder AIWorker besitzt ein eigenes response_received-Signal (separate QObjects,
+           keine gemeinsame Connection). Das eigentliche Problem: Worker1 hat isRunning()=False
+           zurückgegeben, aber sein emittiertes Signal liegt noch in der Qt-Event-Queue.
+           Wird danach ein neuer Worker2 gestartet, kann _on_response Worker1's verspätete
+           Antwort als Worker2-Antwort behandeln — falsche Chat-Nachricht, falscher Loading-State.
+           Fix Teil 1: disconnect() vor dem Ersetzen des Workers (RuntimeError abfangen) —
+           defensive Maßnahme, verkürzt das Race-Fenster aber eliminiert es nicht vollständig.
+           Fix Teil 2 (der robuste Teil): Identitäts-Guard in _on_response
+           (self.sender() is not self._worker → return) — verwirft Events veralteter Worker
+           die noch in der Qt-Event-Queue lagen; dieser Guard schließt die Race vollständig.
 """
 import os
 import re

tests/test_explorer_panel_accessibility.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+"""Regressionstests für die Explorer-Barrierefreiheit."""
+
+import importlib.util
+import os
+import sys
+import unittest
+from pathlib import Path
+
+os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+
+from PySide6.QtWidgets import QApplication
+
+EXPLORER_PANEL_PATH = Path(__file__).parent.parent / "src" / "gui" / "panels" / "explorer_panel.py"
+EXPLORER_PANEL_SPEC = importlib.util.spec_from_file_location(
+    "devcenter_explorer_panel",
+    EXPLORER_PANEL_PATH,
+)
+EXPLORER_PANEL_MODULE = importlib.util.module_from_spec(EXPLORER_PANEL_SPEC)
+assert EXPLORER_PANEL_SPEC.loader is not None
+EXPLORER_PANEL_SPEC.loader.exec_module(EXPLORER_PANEL_MODULE)
+ExplorerPanel = EXPLORER_PANEL_MODULE.ExplorerPanel
+
+
+class ExplorerPanelAccessibilityTests(unittest.TestCase):
+    """Sichert sprechende Namen für die kompakte Explorer-Toolbar."""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.app = QApplication.instance() or QApplication([])
+
+    def test_compact_explorer_controls_expose_accessible_context(self):
+        panel = ExplorerPanel()
+
+        self.assertEqual(panel.refresh_btn.toolTip(), "Aktualisieren")
+        self.assertEqual(panel.refresh_btn.accessibleName(), "Explorer aktualisieren")
+        self.assertIn("Projektstruktur", panel.refresh_btn.accessibleDescription())
+
+        self.assertEqual(panel.collapse_btn.toolTip(), "Alle zuklappen")
+        self.assertEqual(panel.collapse_btn.accessibleName(), "Explorer zuklappen")
+        self.assertIn("geöffneten Ordner", panel.collapse_btn.accessibleDescription())
+
+        self.assertEqual(panel.filter_input.toolTip(), "Dateien im Explorer filtern")
+        self.assertEqual(panel.filter_input.accessibleName(), "Dateifilter")
+        self.assertIn("Projektdateien", panel.filter_input.accessibleDescription())
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

tests/test_settings_application.py

@@ -45,6 +45,34 @@ def test_settings_dialog_saves_highlight_current_line(self):
 
         self.assertFalse(settings.get("editor.highlight_current_line"))
 
+    def test_settings_dialog_browse_buttons_expose_accessible_context(self):
+        settings = self._temp_settings()
+        dialog = SettingsDialog(settings)
+
+        browse_buttons = [
+            (
+                dialog.pyinstaller_browse_btn,
+                "PyInstaller-Datei auswählen",
+                "Öffnet die Dateiauswahl für den PyInstaller-Pfad.",
+            ),
+            (
+                dialog.output_dir_browse_btn,
+                "Ausgabeverzeichnis auswählen",
+                "Öffnet die Ordnerauswahl für das Standard-Ausgabeverzeichnis.",
+            ),
+            (
+                dialog.backup_browse_btn,
+                "Backup-Verzeichnis auswählen",
+                "Öffnet die Ordnerauswahl für den Backup-Pfad.",
+            ),
+        ]
+
+        for button, accessible_name, description in browse_buttons:
+            self.assertEqual(button.text(), "...")
+            self.assertEqual(button.toolTip(), accessible_name)
+            self.assertEqual(button.accessibleName(), accessible_name)
+            self.assertEqual(button.accessibleDescription(), description)
+
     def test_main_window_applies_editor_settings_to_open_tabs(self):
         settings = self._temp_settings()
         settings.set("editor.font_family", "Courier New")