Posouzení nové platby povýší staré platby téhož dokladu na „nové vstupy“
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Smlouva měla zálohu uhrazenou už dřív, ve starší verzi systému, která si k platbě neukládala rozhodnutí o navazujících krocích. Později na tutéž smlouvu přišla drobná platba na jiný, stále částečně uhrazený doklad. Systém založil zakázku a seznam materiálu, jako by záloha byla dokončená právě teď, a to podle pravidel platných dnes, ne v době úhrady.
Root cause
Sekce “Root cause”Krok po uložení platby rozhoduje, zda právě tato platba překročila práh („záloha je celá“), a podle toho zaznamená záměr dalších akcí. Při doplňování podpory starších dokladů bez řádků plateb se vstup rozšířil:
// CHYBNĚ: „vstupem“ jsou všechny platby právě hrazeného dokladuconst inputs = payments.filter((p) => p.checkpointPending || createdNow.has(p.id) || currentInvoiceIds.has(p.invoiceId),);- Třetí podmínka měla pokrýt jen doklad, který nemá žádný řádek platby. Zasáhla ale každý doklad, takže i platby staré měsíce se tvářily jako nové.
- Jedna z cest (částečná bankovní úhrada) navíc konkrétní novou platbu vůbec nepředávala, takže se bez té podmínky neobešla.
- Práh „bez nových vstupů nebyl splněn, s nimi ano“ pak vyšel pravdivě i tam, kde byl splněn dávno.
Test s jednou platbou na čisté smlouvě to neodhalí; je potřeba smlouva s historií a další platba.
Fix
Sekce “Fix”const inputs = payments.filter((p) => p.checkpointPending || createdNow.has(p.id));// doklad sám je vstupem jen u staršího volání bez platby a jen když nemá žádný řádek platbyconst legacy = !newPaymentId && invoiceHasNoPaymentRows ? [invoice] : [];- ID nově vzniklé platby se předává ze všech cest (ruční potvrzení, částečná i plná bankovní úhrada, automatické párování).
- Platný starší záznam rozhodnutí, který zůstal otevřený po chybě, se dál dokončí podle původních pravidel. Oprava tedy není plošný zákaz dohánění.
- Historie bez záznamu rozhodnutí vede jen k výstraze pro člověka. Peníze a doklady se uloží, navazující akce se nevymýšlí.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: u každého kroku „po platbě“ se ptej, podle čeho pozná, co je nové. Podezřelé je odvozování z agregátu (součet dokladu, stav smlouvy) místo z ID události.
- Test: smlouva se splněným prahem bez záznamu rozhodnutí, pak malá platba na jiný i na tentýž doklad; ručně, bankou i automatickým párováním; opakování téhož řádku. Navazující akce nesmí vzniknout a výstraha má být jedna.
- Protitest: skutečná nová dokončující platba a starší otevřený záznam rozhodnutí se zpracovat musí.
- Anti-pattern: kompatibilní větev pro stará data napsaná jako obecná podmínka. Výjimku vyjádři přesně („doklad bez jediného řádku platby“) a jen pro volání, které novou platbu nezná.
- Lepší přístup: rozhodnutí zapisovat ve stejné transakci jako platbu a pozdější kroky řídit jen jím.
Sister bugs / související
Sekce “Sister bugs / související”- Dávkový job počítá částku z aktuálního nastavení místo zmrazeného pravidla — stejné riziko: dnešní pravidla použitá na dřívější skutečnost.
- Fail-closed kontrola ignoruje legacy záznamy bez vazby — opačná chyba při práci se staršími daty.
- Krok po platbě vrací ID dokladu, který nemusel vzniknout — nalezeno ve stejném řezu.