Hlavní tlačítko „Odeslat" jen přepnulo stav — skutečné odeslání bylo vedlejší akcí
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Uživatel otevře doklad, klikne na velké modré Odeslat, stav se změní na „Odesláno” a časová osa to potvrdí. Protistrana ale nikdy nic nedostane. Zjistí se to až při urgenci („nic nám nepřišlo”) nebo při auditu historie odeslání, kde u dokladu nejsou žádné adresy.
Root cause
Sekce “Root cause”Toolbar nabízel dvě akce se skoro stejným názvem a obrácenou vizuální váhou:
{canSend && ( <Button onClick={() => changeStatus("SENT")}> {/* primární, plné */} Odeslat </Button>)}...<Button variant="outline" onClick={openSendDialog}> {/* nenápadné */} Odeslat e-mailem</Button>První jen volá status endpoint (status: "SENT"), druhé teprve otevře dialog,
který doklad skutečně pošle a zapíše příjemce do historie. Uživatel bere
primární tlačítko jako „tu správnou” akci — a nemá jak poznat rozdíl, protože
výsledek vypadá identicky: stav „Odesláno” a razítko v časové ose.
Diagnostika v datech je jednoznačná: doklad má vyplněné sent_at a
STATUS_CHANGE v auditu, ale nula řádků v logu odeslaných e-mailů a žádná
EMAIL_SENT akce.
Fix
Sekce “Fix”Prohodit váhu a doslovně pojmenovat, co která akce dělá:
{canSend && ( <Button variant="outline" /* už ne primární */ title="Jen přepne stav — e-mail se neodešle" onClick={() => changeStatus("SENT")}> Označit jako odeslané </Button>)}
<Button onClick={openSendDialog}> /* primární */ Odeslat e-mailem</Button>Druhá polovina opravy je zpětná čitelnost: do časové osy vypiš konkrétní adresy z logu, a když log chybí, napiš to otevřeně („označeno ručně — e-mail neodešel”). Jinak se stav „Odesláno” nedá odlišit od skutečného odeslání.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grepna dvojice tlačítek se sdíleným slovesem v jednom toolbaru. Dotaz do dat: doklady ssent_at IS NOT NULLa nulovým počtem záznamů v logu odeslání — každý takový je buď tenhle bug, nebo ruční předání (a to musí jít rozlišit). - Anti-pattern: primární tlačítko volá jen
changeStatus(...). Změna interního stavu skoro nikdy není hlavní akce obrazovky. - Lepší přístup: sloveso v labelu = efekt navenek. „Označit jako X” pro stav, „Odeslat/Vystavit/Zaplatit” pro akci s vnějším dopadem.
Sister bugs / související
Sekce “Sister bugs / související”Stejná rodina: UI nenabízí inverzní akci, kterou API umí (stornovaný doklad šel přes API vrátit do vystaveného stavu, ale v rozhraní pro to nebylo tlačítko — a potvrzovací dialog navíc tvrdil, že akci nelze vzít zpět). Pokaždé, když dialog slibuje „nelze vrátit”, ověř, jestli to platí i o API.