Amadeni
Workshop

UX workshop · Cycle 1

Long-running background tasks

AI checks, transcripts and reports take seconds to minutes. Today a spinner turns, and sometimes all you get at the end is “Server Error”.

Brief to the agent
The customer answered a query in the feedback draft; the send button stayed grey with “The privacy check is still running for a moment.” … Only about two and a half minutes after the last keystroke was the check finished.

From the customer portal (Hub #307, shortened); error case from #270: in production Convex truncates error.message to “Server Error”.

Recreated with made-up data
  1. 1. Enter content
  2. 2. Check privacy
  3. 3. Agree and send

Three answers to queries, four screenshots attached.

Demo, 20 times faster than real time

Design round 1

What we adopted from the designer's proposal and what we deliberately did not. Adopted means: it now lives in the target version, in a component or in a rule.

Adopted

  • Check while writing: each answer and screenshot is checked in the background as soon as it is done, instead of everything at the end.
  • The send step names what leaves, to whom, and what was redacted (now R9).
  • Nothing sends itself: sending stays an explicit click with consent (R9).

Not adopted

  • Preview images of every redaction right inside the form. What matters to the customer is that something was redacted and what; the send step shows the images.
  • Without limits: one check per answer costs model calls on every save. The workshop therefore only starts it after a pause of a few seconds.

Related rules

The rules are maintained in German.

R7

Lange Läufe zeigen Schritte statt Spinner

Alles, was länger als etwa drei Sekunden dauert, zeigt benannte Schritte, die vergangene Zeit und eine Erwartung („dauert meist 1 bis 2 Minuten“).

  • Der Lauf gehört dem Server, nicht dem Browser-Tab. Die Seite darf verlassen werden; der Stand ist beim Wiederkommen noch da.
  • Eingaben bleiben während des Laufs sichtbar und werden nicht gesperrt, wenn der Lauf sie nicht braucht.

R8

Fehler sagen, was passiert ist und was man tun kann

Eine Fehlermeldung nennt in einem Satz, was nicht geklappt hat, ob Eingaben erhalten sind und was man jetzt tun kann. „Server Error“ allein ist nie eine Meldung.

  • Fachliche Fehler (ConvexError mit data) zeigen den Text aus data. Technische Details stehen eingeklappt darunter.
  • Immer ein nächster Schritt: „Erneut versuchen“, „Entwurf behalten und später weitermachen“ oder ein Kontakt. Eingaben gehen bei einem Fehler nie verloren.
  • Ein Fehler bleibt dort, wo er entsteht: am Feld, am Eintrag, am Bild. Der Rest der Seite bleibt bedienbar.
  • Meldungen im Fluss sind getönte Alerts (destructive, warning, success, info), keine selbst gebauten farbigen Kästen.

R9

Nichts sendet sich selbst

Was das Haus verlässt (an Kundinnen, an KI-Modelle, an Dritte), geht erst auf einen ausdrücklichen Klick raus. Der Sendeschritt nennt, was rausgeht, an wen und was vorher verändert wurde.

  • Der Knopf benennt die Folge („Zustimmen und an die KI übermitteln“), nicht „Weiter“.
  • Prüfungen dürfen im Hintergrund vorlaufen, während jemand schreibt; das Senden selbst passiert nie automatisch.
  • Vorher steht da, was übermittelt wird: Empfänger, Inhalte, Schwärzungen.
All rules