Krok po platbě vrací ID dokladu, který nemusel vzniknout
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Zálohová faktura byla uhrazená a k platbě existoval daňový doklad na celou částku. Na stejnou fakturu pak přišla další, drobná bankovní platba (přeplatek). Přiřazení skončilo chybou 500 s hláškou o čtení vlastnosti z null, platba se neuložila a řádek výpisu zůstal nespárovaný. Při každém dalším pokusu totéž.
Root cause
Sekce “Root cause”let created: Doc | null = null;if (uncoveredAmount > 0) created = await issueDocumentForPayment(…);// … stavové kroky …return created!.id; // doklad nevznikl → TypeError → rollback celé platbyDoklad k platbě vzniká jen na část, kterou ještě žádný doklad nekryje. U přeplatku je tato část nulová, takže nevznikne nic — a to je správně. Návratová hodnota ale s tím nepočítala a vykřičník kontrolu typů umlčel. Chyba nastala až na samém konci, po všech správných krocích.
Fix
Sekce “Fix”return created ? created.id : null;- Funkce vrací
null, když doklad nevznikl a nebyl zablokovaný kontrolou; chyba validace se dál šíří jako chyba. - Volající s volitelným výsledkem počítají: platba se uloží, řádek výpisu se spáruje, doklad zůstane jeden.
- Na přeplatek se dál vztahují stávající pravidla; oprava nezavádí automatickou vratku ani zdanění.
Test: plná úhrada, potom dalších pár stokorun na tutéž fakturu ručně i automatickým párováním. Očekává se úspěch, vyšší přijatá částka, stále jeden doklad, žádná nová navazující akce a odmítnutí opakování téhož řádku.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: grep na
!.id,!.numbera podobné vynucení u proměnných, které se plní uvnitř podmínky. - Test: ke každé platební cestě přidej případ „nic dalšího už vzniknout nemá“ (přeplatek, opakovaná úhrada, doklad vystavený předem). Nestačí ověřit, že odpověď není 500; zkontroluj uložené částky a počet dokladů.
- Anti-pattern: vynucené „není null“ jako náhrada za rozhodnutí, co má volající dostat.
- Pozor na různé vstupní cesty: automatické párování nemusí už uhrazené doklady vůbec nabízet. Test pro něj musí použít případ, který tou cestou skutečně jde, jinak ověřuje něco, co se stát nemůže.
Sister bugs / související
Sekce “Sister bugs / související”- Posouzení nové platby povýší staré platby téhož dokladu na „nové vstupy“ — nalezeno ve stejném řezu.
- Součet dokladů není peněžní plnění