Dvě implementace zaokrouhlení a fail-closed kontrola zablokovaly výplaty
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”„Přestaly se propisovat provize.“ Část nových smluv nedostala provizi vůbec, u jiných provize zůstala ve stavu „čeká na zálohu“, i když záloha byla zaplacená. Většina smluv přitom fungovala, takže to vypadalo náhodně.
Root cause
Sekce “Root cause”Výpočtový modul měl vlastní round2:
function round2(n: number) { return Math.round(n * 100) / 100; }Kontrolní modul (idempotentní „ensure“, který po události ověří, že řádky odpovídají očekávání, a při neshodě odmítne zapsat) používal sdílený helper:
export function round2(n: number) { return Number((n || 0).toFixed(2)); }Pro hodnoty typu 1071.385 dá první 1071.39, druhý 1071.38 (reprezentace ve floating pointu). Kontrola po vytvoření porovnávala částky na rovnost → výjimka → transakce rollback → provize nevznikla. U dřívějších řádků stejná neshoda vyhodila anomálii „drift“ a zablokovala posun do výplaty.
Fix
Sekce “Fix”Výpočet importuje tentýž round2 jako kontrola (jediný zdroj pravdy). Zaseklé záznamy se opravily výhradně funkcemi enginu (idempotentní ensure = založení / catch-up, recompute = srovnání částek), žádné ruční UPDATE. Historické řádky s haléřovým rozdílem, které už prošly výplatou, se nechaly být.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "Math.round(.*100) / 100\|toFixed(2)"— více než jedna implementace = riziko; read-only sken všech záznamů přes kontrolní funkci a histogram verdiktů. - Anti-pattern: lokální kopie pomocné funkce „protože je to jednořádkové“; fail-closed kontrola, jejíž selhání končí jen v logu serveru.
- Lepší přístup: peníze v
Decimal, jedinýmoney.round2, kontrola s tolerancí 0,01 Kč jen pro čtení historických řádků, a každé fail-closed odmítnutí jako viditelný alert pro back office.
Sister bugs / související
Sekce “Sister bugs / související”- Fail-closed finanční báze při přeplatku zálohy (klient poslal víc) rovněž zastaví výplatu — potřebuje operační postup (vratka / dobropis), ne kódovou opravu.