Feedback-Modul

VibeKit sammelt Produktfeedback und bietet Administratoren eine begrenzte Oberfläche zur Triage. Neue Einsendungen bleiben privat, bis ein Administrator bewusst auswählt, was veröffentlicht wird.

Übersicht

Benutzer können über das Widget Ideen, Fehlerberichte und allgemeines Feedback senden. Administratoren prüfen die Einsendungen im Adminbereich. Ein öffentliches Feedback-Board ist optional und zeigt nur ausdrücklich veröffentlichte Einträge.

Wichtigste Funktionen

• In-App-Widget: Ein Slide-Over-Sheet, das auf der Startseite, den Marketing-Seiten und in der SaaS-Anwendung aufgerufen werden kann.
• Kategorisierung: Einsendungen werden als Funktionsanfrage (FEATURE), Fehlerbericht (BUG) oder Allgemein (OTHER) erfasst.
• Kontext-Erfassung: Erfasst eine übermittelte Seiten-URL und einen optionalen, geprüften Bildanhang. Benutzer können zusätzlich ausdrücklich ein prüfbares Diagnostikpaket senden.
• Admin-Verwaltung: Filtern nach Status (OPEN, PLANNED, IN_PROGRESS, COMPLETED, DECLINED), Volltextsuche und direkte Statusaktualisierung.
• Rate Limiting: Limits für Einsendungen und Stimmen nutzen serverseitig abgeleitete Konto- oder Netzwerksignale; eine vom Browser übermittelte ID ist kein Identitätsnachweis.

Datenschutz und Veröffentlichung

Feedback-Berichte, Administratorantworten und Anhänge haben getrennte Veröffentlichungssteuerungen. Neue Einsendungen sind in allen drei Steuerungen privat. Die Veröffentlichung eines Berichts veröffentlicht weder Antwort noch Anhang; eine Antwort darf erst öffentlich sein, wenn auch der Bericht öffentlich ist. Autoren sehen den Verlauf ihrer angemeldeten Einsendungen; öffentliche Besucher erhalten nur ausdrücklich öffentliche Felder.

Das optionale Diagnostikpaket ist standardmäßig aus und kann vor dem Senden geprüft werden. Es enthält eine bereinigte Seiten-/Referenz-URL, Viewport- und Bildschirmwerte, Browsersprache und User-Agent sowie bis zu 25 gefilterte Konsolenwarnungen oder -fehler. Es enthält keine Kontoidentität und wird nicht auf Auth-, Reset-, Checkout-, Einladungs-, Onboarding-, Einstellungs-, Admin- oder API-Routen erfasst.

Wenn das öffentliche Board aktiv ist, verwendet anonymes Abstimmen das First-Party-Cookie vibekit-feedback-voter. Es ist ein nicht sprechendes, signiertes, host-only HttpOnly-Cookie mit maximal einem Jahr Laufzeit. Es unterstützt eine Stimme pro Browser und ist keine Kontoidentität; angemeldete Stimmen verwenden stattdessen das Konto.

Konfiguration

Das Feedback-Modul kann in config.ts aktiviert oder deaktiviert werden:

export const config = {
  // ...
  feedback: {
    enabled: true,
  },
};

Wenn das aufgelöste Feedback-Modul deaktiviert ist (Admin-Überschreibungen haben Vorrang vor config.feedback.enabled), wird das Widget ausgeblendet, die Seite /app/admin/feedback liefert einen 404-Fehler und die API lehnt Einreichungen ab.