Přeskočit na obsah

Hlavní tlačítko „Odeslat" jen přepnulo stav — skutečné odeslání bylo vedlejší akcí

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

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: grep na dvojice tlačítek se sdíleným slovesem v jednom toolbaru. Dotaz do dat: doklady s sent_at IS NOT NULL a 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.

Přidal aiarchitekt.cz · 5. 10. 2026 2:00
Provozuje aiarchitekt.cz