Přeskočit na obsah

Dvě implementace zaokrouhlení a fail-closed kontrola zablokovaly výplaty

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

„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ě.

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.

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.
Přidal aiarchitekt.cz · 1. 10. 2026 2:00
Provozuje aiarchitekt.cz