ui

design/feedback_guide.md

@@ -0,0 +1,91 @@
+# FEEDBACK_GUIDE.md
+
+## Zweck
+Dieses Dokument definiert **konsistentes visuelles Feedback** in Form von Alerts und Toasts.
+
+Ziel:
+- klare Zustände
+- keine Überraschungen
+- sofort verständliche Rückmeldungen
+
+---
+
+## Grundregeln
+
+- Feedback ist immer sichtbar
+- Feedback ist textlich eindeutig
+- Farbe unterstützt – ersetzt aber nicht die Aussage
+
+---
+
+## Alerts
+
+Alerts sind **statisch** und kontextgebunden.
+
+Typische Nutzung:
+- Formularfehler
+- Systemzustände
+- Konfigurationsprobleme
+
+### Beispiele
+
+```html
+<div class="alert success">Einstellungen gespeichert</div>
+<div class="alert warning">Unvollständige Konfiguration</div>
+<div class="alert error">Speichern fehlgeschlagen</div>
+```
+
+Regeln:
+- Alert steht nahe am betroffenen Inhalt
+- kein automatisches Verschwinden
+
+---
+
+## Toasts
+
+Toasts sind **temporär** und nicht blockierend.
+
+Typische Nutzung:
+- Erfolgsmeldungen
+- kurze Hinweise
+- Hintergrundaktionen
+
+### Beispiel
+
+```html
+<div class="toast success">Änderungen übernommen</div>
+```
+
+Regeln:
+- niemals kritisch
+- immer zeitlich begrenzt
+- dürfen ignoriert werden
+
+---
+
+## Wann was?
+
+| Situation | Element |
+|---------|---------|
+| Formular ungültig | Alert |
+| Aktion erfolgreich | Toast |
+| Kritischer Fehler | Alert |
+| Hintergrundinfo | Toast |
+
+---
+
+## Anti-Patterns
+
+- Toasts für Fehler
+- Alerts ohne Text
+- Farben ohne Bedeutung
+- mehrere Feedback-Typen gleichzeitig
+
+---
+
+## Status
+
+Version: **v1.0 (Baseline)**
+
+Dieses Dokument ergänzt `COMPONENT_GUIDE.md`.
+