Feedback melden — Bugs, Features, Verbesserungsvorschläge

KI

Wofür ist der Feedback-Button da?

Wenn Sie im täglichen Arbeiten mit SpeamCore etwas auffällt — ein Knopf reagiert nicht, eine Eingabe ist umständlich, eine Funktion fehlt — melden Sie das gezielt über den Feedback-Button unten rechts in der App.

So landen Ihre Hinweise strukturiert bei Kevin und dem IT-Team — nicht als verstreute Mails oder Anrufe, sondern als zentrale Liste mit allen Details (Screenshot, betroffenes Element, ggf. Aufzeichnung). Je besser Sie beschreiben, desto leichter ist die Bearbeitung.

Der KI-Chat ist die alternative Variante: über den Link „Mit KI ausarbeiten →" im Feedback-Modal können Sie Ihren Vorschlag oder Bug zusammen mit der KI vorbereiten — die KI hilft dabei, alle nötigen Infos sauber zu strukturieren, bevor Sie absenden.

Diese Anleitung zeigt Ihnen, wie Sie Feedback richtig erfassen — egal ob Bug, Feature-Wunsch oder Verbesserungsvorschlag.

Wann nutze ich das?

• Bug gefunden — etwas funktioniert nicht wie erwartet (Knopf reagiert nicht, Fehlermeldung, Berechnung falsch).
• Feature-Wunsch — eine Funktion fehlt, die Ihre Arbeit erleichtern würde.
• Verbesserungsvorschlag — etwas funktioniert, aber zu umständlich (zu viele Klicks, ungünstige Reihenfolge, unklare Beschriftung).
• Frage zur Funktionsweise — wenn etwas unklar ist und Sie nichts in der Doku finden.

Nicht über das Feedback-Tool:

• Akute Notfälle (System komplett down, Datenverlust droht) — direkt Kevin / IT anrufen.
• Schulungs-Fragen zu Themen die in der Doku stehen — erst Doku/KI-Chat fragen.
• Geschäftliche Anfragen an andere Mitarbeiter — über den normalen Mail-/Chat-Weg.

i

Voraussetzung

• Sie sind in SpeamCore eingeloggt — der Feedback-Button ist überall sichtbar.
• Sie haben den Bug/das Feature gerade vor Augen oder kurz vorher gesehen.
• Bei Element-Markierung oder Vorgangs-Aufzeichnung: Sie sind auf der relevanten Seite.

Den Feedback-Button finden

Unten rechts in der App, im Footer-Bereich:

• ℹ️ API Version (Backend-Version)
• ℹ️ App Version (Frontend-Version)
• ⚙️ Feedback — der Button mit Zahnrad-Symbol

Klick auf Feedback öffnet das Eingabe-Modal „Fehler melden" (auch wenn Sie etwas anderes als einen Fehler melden — die Kategorie wählen Sie im Dropdown).

So füllen Sie das Feedback-Modal richtig aus

1

Kategorie wählen — Was möchten Sie melden?

Im obersten Dropdown wählen Sie aus, um was es geht. Drei Kategorien (Code-verifiziert: bug, feature_request, improvement):

Kategorie	Wann?
Bug / Fehler (bug)	Etwas funktioniert nicht oder anders als dokumentiert
Feature-Wunsch (feature_request)	Eine Funktion fehlt komplett
Verbesserungsvorschlag (improvement)	Etwas funktioniert, könnte aber besser/schneller sein

Bei Unsicherheit: Bug / Fehler wählen — Kevin oder das Team kann es bei Bedarf umkategorisieren.

2

Titel — kurz und konkret

Der Titel ist Pflichtfeld. Eine kurze sprechende Zeile, die das Problem oder den Wunsch in einem Satz auf den Punkt bringt.

Gute Titel:

• „Speichern-Button reagiert nicht beim Anlegen eines Auftrags"
• „Filter im Kunden-Modul vergisst meine Auswahl beim Wechsel zwischen Tabs"
• „Wunsch: Massen-Export der Mitarbeiter-Liste als CSV"
• „Mahn-Vorlage zeigt falsche Anrede bei männlichen Kunden"

Schlechte Titel:

• „Funktioniert nicht" (was funktioniert nicht?)
• „Bug" (welcher Bug?)
• „Idee" (welche?)
• „Hilfe!" (zu unspezifisch)

Faustregel: Wenn Kevin nur den Titel liest, soll er das Problem in 5 Sekunden erfassen können.

3

Beschreibung — die drei W-Fragen

Im Beschreibungsfeld geht es um die Geschichte hinter dem Titel. Nutzen Sie folgendes Schema:

1. Was haben Sie versucht?
   z. B. „Ich wollte einen neuen Wartungsauftrag für Kunde Müller GmbH anlegen."

2. Was war Ihre Erwartung?
   z. B. „Nach Klick auf Speichern sollte der Auftrag mit Auftragsnummer angelegt werden."

3. Was ist tatsächlich passiert?
   z. B. „Der Speichern-Button wird nach dem Klick grau, dreht sich kurz, aber
   nichts passiert. Kein Fehler-Toast, kein neuer Auftrag in der Liste."

Zusatz-Infos die helfen:

• Browser — Chrome / Edge / Firefox / Safari + Version (steht unter den Browser-Einstellungen).
• Gerät — PC / Tablet / Smartphone, ggf. Hersteller.
• Wann gemerkt — heute, seit gestern, seit einer Weile?
• Reproduzierbar? — passiert es immer, manchmal, einmalig?
• Welche Schritte führen dazu? — kurz nummeriert.

Je mehr Sie schreiben, desto besser — Kevin oder das IT-Team verlieren keine Zeit mit Rückfragen.

4

Priorität setzen — ehrlich einschätzen

Die Priorität hilft dem Team, die Reihenfolge der Bearbeitung zu planen. Vier Stufen (Code-verifiziert: low, medium, high, critical — primär für Bug-Reports relevant; Feld ist optional/nullable bei Feature-Wünschen):

Priorität	Wann?
niedrig (low)	„nice to have" — kein Druck, irgendwann mal
mittel (medium)	Wäre angenehm in den nächsten Wochen behoben
hoch (high)	Behindert mich täglich, brauche zeitnah eine Lösung
kritisch (critical)	Ich kann mit SpeamCore nicht weiterarbeiten / Datenverlust droht

KI

Stolperstein — Priorität ehrlich setzen

Versuchen Sie nicht, alle Meldungen auf kritisch zu setzen, damit Sie schneller bearbeitet werden. Kevin und das Team sehen schnell, wenn jemand übertreibt — und es entwertet die echten kritischen Meldungen anderer. Faustregel: Kritisch nur, wenn Sie wirklich nicht arbeiten können.

5

Element markieren — zeigen statt beschreiben

Wenn das Problem an einem bestimmten Knopf, Feld oder Bereich in SpeamCore hängt:

1. Klick auf Element markieren (blauer Button mit Klammer-Symbol).
2. Das Modal schiebt sich aus dem Weg, Sie sehen wieder die Anwendung.
3. Klicken Sie auf das Element, das das Problem verursacht (z. B. den Speichern-Button, das defekte Feld).
4. Das Element wird markiert + die Info automatisch in die Meldung übernommen.

Damit muss Kevin nicht raten, welcher der zehn Speichern-Buttons gemeint ist — er sieht direkt, wo Sie waren.

6

Vorgang aufzeichnen — Schritt für Schritt

Wenn das Problem mehrere Klicks oder eine bestimmte Reihenfolge voraussetzt:

1. Klick auf Vorgang aufzeichnen (Button mit Play-Symbol).
2. Das Modal schiebt sich aus dem Weg, eine kleine Aufzeichnungs-Steuerung erscheint.
3. Reproduzieren Sie das Problem — klicken Sie genau die Schritte, die zum Fehler führen.
4. Klick auf Stopp wenn der Fehler aufgetreten ist.
5. Die Aufzeichnung wird automatisch an die Meldung angehängt.

So kann Kevin oder die IT-KI den Fehler selbst nachstellen — ohne dass Sie 10x telefonisch erklären müssen.

KI

Was wird aufgezeichnet?

Die Aufzeichnung erfasst Ihre Klick-Sequenz und Bildschirm-Aktivität in der SpeamCore-Anwendung. Sensible Inhalte (Mitarbeiter-Daten, Kunden-Adressen) sind dabei zu sehen — die Aufzeichnung geht aber nur intern an Kevin und das IT-Team, nicht extern.

7

Screenshot aufnehmen — wenn ein Bild reicht

Wenn ein einzelner Bildschirm-Zustand (z. B. eine Fehlermeldung) das Problem zeigt:

1. Klick auf Screenshot aufnehmen (Button mit Kamera-Symbol).
2. Das Modal schiebt sich aus dem Weg.
3. Der aktuelle Bildschirm wird automatisch erfasst und an die Meldung angehängt.

Wann Screenshot vs. Vorgangs-Aufzeichnung?

Situation	Wahl
Eine sichtbare Fehlermeldung oder ein falsches Layout	Screenshot
Falsche Berechnung in einem Feld	Screenshot
Ein Knopf reagiert nach 3 Klicks nicht mehr	Vorgang aufzeichnen
Filter verschwindet beim Tab-Wechsel	Vorgang aufzeichnen

Beides geht auch — Screenshot und Vorgangs-Aufzeichnung in derselben Meldung.

KI

Screenshots auf iPhone, iPad und Android

In der nativen SpeamCore-App auf iOS/Android läuft der Screenshot direkt über die App — kein zusätzliches Pop-up, keine Erlaubnis-Frage. Im Browser fragt der Computer einmalig nach dem Tab/Fenster, das er aufnehmen soll. In sehr alten Browsern wird ein 3-2-1-Countdown gezeigt, damit Sie nicht versehentlich den Cursor mit erfassen.

8

Bilder anhängen — mehr als ein Screenshot

Manchmal reicht ein einzelner Screenshot nicht — zum Beispiel wenn Sie eine Eingabe, das daraus entstehende Ergebnis und einen Vergleich aus einer anderen Software zeigen wollen.

So fügen Sie weitere Bilder hinzu:

1. Klick auf Bild hinzufügen (Büroklammer- oder Bild-Symbol unterhalb des Screenshots).
2. Im Datei-Dialog eine oder mehrere Bilddateien auswählen (Mehrfach-Auswahl mit Cmd / Ctrl oder Shift).
3. Die ausgewählten Bilder erscheinen als kleine Vorschau-Kacheln unterhalb des Screenshots.
4. Falsches Bild dabei? Auf das X in der Ecke der Vorschau klicken — Bild wird entfernt.

Was wird unterstützt:

• Nur Bildformate (PNG, JPG, GIF, HEIC, WebP). Andere Dateien werden ignoriert.
• Beliebige Anzahl — der Server akzeptiert alles, die Browser-Quota begrenzt die praktische Obergrenze.
• Die Bilder werden erst beim Absenden hochgeladen. Bis dahin liegen sie nur lokal in Ihrem Browser.

KI

Datenschutz auch bei Anhängen

Anhänge unterliegen denselben Regeln wie Screenshots — keine sensiblen Personal- oder Kundendaten in den Bildern, wenn die Meldung an alle Admins eines Mandanten sichtbar wird. Im Zweifel die Bilder vorher in einem Editor anonymisieren.

9

Entwurf bleibt erhalten — auch beim Schließen

Falls Sie das Drawer schließen müssen (Telefonat dazwischen, anderer Vorgang dazwischen), bleibt Ihr Entwurf erhalten:

• Titel, Beschreibung, Kategorie, Priorität und das markierte Element werden lokal in Ihrem Browser gespeichert.
• Sobald Sie das Feedback-Drawer wieder öffnen, finden Sie alles wieder vor. Sie sehen oben einen kleinen Hinweis „Entwurf wiederhergestellt".
• Nicht gespeichert werden: Screenshot und zusätzliche Bild-Anhänge — die müssen Sie neu erstellen / wieder hochladen, wenn Sie sie weiterhin wünschen.
• Ein Entwurf bleibt bis zu 7 Tage liegen. Ältere Entwürfe werden automatisch verworfen.
• Endgültig löschen können Sie den Entwurf über den Button Verwerfen (Papierkorb-Symbol). Es erscheint eine Sicherheitsabfrage.

Damit verlieren Sie keine Beobachtung mehr, nur weil zwischendurch etwas Wichtigeres ansteht.

10

Absenden

Wenn alle Pflichtfelder gefüllt sind (Titel ist Pflicht), wird der Absenden-Button aktiv (vorher grau).

1. Klick auf Absenden.
2. Die Meldung geht an Kevin und das IT-Team.
3. Sie erhalten eine Bestätigung im Modal — Meldungs-Nummer.
4. Modal schließt automatisch.

Sie bekommen per Mail oder In-App-Notification Bescheid, sobald die Meldung bearbeitet wird.

Meldungen einsehen — zwei Wege

Weg 1 — Schnellzugriff im Modal: Oben rechts im Feedback-Modal auf Meine Meldungen (Listen-Symbol) klicken.

Weg 2 — Über die Modul-Route: Direkt aufrufen unter https://<mandant>.speamcore.com/feedback — also z. B.:

• KFT: https://kft.speamcore.com/feedback
• SpeamCore-intern: https://speam.speamcore.com/feedback
• Demo: https://demo.speamcore.com/feedback

Pro Mandant eine eigene Subdomain (siehe Multi-Mandanten). Die Sicht hängt davon ab, wer eingeloggt ist.

Was Sie als normaler Anwender sehen

Auf /feedback und im Modal-Schnellzugriff sehen Sie ausschließlich Ihre eigenen Meldungen — die Sie selbst abgeschickt haben. Keine Meldungen von Kollegen, keine fremden Vorgänge. Sechs Status-Stufen (Code-verifiziert: open, in_review, planned, in_progress, done, rejected):

Status	Bedeutung
Offen (open)	Frisch gemeldet, von Kevin / IT noch nicht bearbeitet
In Prüfung (in_review)	Wird gerade evaluiert — ist es ein Bug? Macht das Feature Sinn?
Eingeplant (planned)	Bearbeitung steht im Sprint-/Backlog-Plan
In Bearbeitung (in_progress)	Entwickler arbeitet aktiv daran
Erledigt (done)	Bug gefixt / Feature umgesetzt — meist mit nächstem App-Update verfügbar
Abgelehnt (rejected)	Wird nicht umgesetzt (mit Begründung)

So bleiben Sie informiert, was mit Ihren Hinweisen passiert — ohne dass die Meldungen anderer für Sie sichtbar sind.

Was Admins / Kevin sehen

Anwender mit dem CASL-Recht do:ViewAllFeedback (typisch Admins, IT-Team, Kevin) sehen unter /feedback alle Meldungen aller Anwender ihres Mandanten — sortier- und filterbar nach:

• User — wer hat gemeldet (reportedBy)?
• Status — open / in_review / planned / in_progress / done / rejected
• Priorität — critical / high / medium / low (oder nicht gesetzt)
• Kategorie — bug / feature_request / improvement
• Datum — neueste / älteste

Die Sichtbarkeits-Logik ist im BE-Service feedback.service.ts umgesetzt: ohne do:ViewAllFeedback filtert die API automatisch auf reportedBy === currentEmployeeId. Damit hat das IT-Team den kompletten Überblick und kann Doppelungen, Häufungen und Trends erkennen — z. B. „mehrere User melden den gleichen Speichern-Bug seit gestern" → Priorität automatisch hochstufen.

KI

Mandanten-Trennung

Wie überall in SpeamCore gilt auch hier die Mandanten-Trennung (siehe Multi-Mandanten) — Admins eines Mandanten sehen nur die Meldungen ihres eigenen Mandanten. Übergreifende Sichten (z. B. KFT-Meldungen aus dem SpeamCore-internen Mandant) sind nur für SpeamCore-Plattform-Betreiber möglich.

KI

Datenschutz-Hinweis

Da Admins alle Meldungen ihres Mandanten sehen, keine sensiblen Personal-/Kundendaten in die Beschreibung tippen — auch wenn das Feedback in dem Bereich liegt. Statt „Mitarbeiter Müller hat Lohnzettel-Fehler" lieber „Lohnzettel-Modul zeigt bei einem Mitarbeiter falschen Bruttobetrag — siehe markiertes Element und Aufzeichnung".

Screenshots zeigen automatisch, was auf Ihrem Bildschirm sichtbar ist — bei sensiblen Bereichen vorab Daten anonymisieren oder Vorgang ohne reale Kunden-Daten reproduzieren (im Demo-Mandant).

KI-Chat als Alternative

Im Feedback-Modal oben gibt es den Hinweis:

„Du kannst Bugs oder Feature-Ideen auch mit dem KI-Chat ausarbeiten."

Mit dem Link „Mit KI ausarbeiten →" öffnet sich der KI-Chat in einer neuen Sicht. Sie beschreiben das Problem in natürlicher Sprache, die KI:

• Stellt Rückfragen, falls Infos fehlen
• Schlägt einen passenden Titel + strukturierte Beschreibung vor
• Hilft Ihnen Priorität und Kategorie zu wählen
• Übernimmt am Ende alles automatisch ins Feedback-Formular zur Endkontrolle und zum Absenden

Wann KI-Chat nutzen?

• Sie wissen nicht, wie Sie das Problem in technische Worte fassen
• Sie sind unsicher ob es ein Bug oder gewolltes Verhalten ist
• Sie möchten beim Tippen Zeit sparen

Wichtig — auch hier gilt: Kontrolle bleibt beim Anwender. Die KI bereitet vor, Sie prüfen die fertige Meldung und drücken auf Absenden.

Tipps für gute Meldungen

!

Mehrere Probleme in einer Meldung

Vermeiden. Pro Meldung eine Sache. Wenn Sie drei verschiedene Bugs gefunden haben, lieber drei separate Meldungen — sonst werden Teile vergessen oder die Bearbeitung blockiert auf einem Punkt.

!

Frust statt Fakten

Vermeiden Sie Sätze wie „Das war heute schon das fünfte Mal!" oder „Wer hat das so designed?!". Bleiben Sie sachlich — Kevin und das Team haben es nicht persönlich auf Sie abgesehen. Sachliche Meldungen werden schneller bearbeitet als emotionale.

!

Screenshot statt Beschreibung

Ein Screenshot ohne Beschreibung ist nur halb so wertvoll. Immer beides: Beschreibung plus Screenshot/Aufzeichnung. Der Screenshot zeigt was falsch ist, die Beschreibung erklärt warum es ein Problem ist.

!

Doppelte Meldung

Bevor Sie melden, kurz unter Meine Meldungen schauen, ob Sie das gleiche Problem schon mal gemeldet haben. Doppelte Meldungen verlangsamen die Bearbeitung. Wenn Sie unsicher sind: trotzdem melden, mit Hinweis „evtl. dupliziert mit Meldung Nr. XXX".

Was passiert nach dem Absenden?

Typische Bearbeitungszeiten:

Priorität	Reaktion / Bearbeitung
kritisch	Reaktion meist innerhalb Stunden, Fix nach Möglichkeit am gleichen Tag
hoch	Reaktion 1-2 Tage, Bearbeitung in nächster Update-Welle
mittel	Reaktion innerhalb einer Woche, Bearbeitung in Backlog
niedrig	Sammeln und in einer Verbesserungs-Welle abarbeiten

Verwandte Tutorials

• KI-Chat-Aktionen — der zweite Weg zum Feedback
• Erste-Hilfe-Karte — was tun bei akutem Problem
• Tipps und Tricks — Doku-Querschnitt