Přeskočit na obsah

Posouzení nové platby povýší staré platby téhož dokladu na „nové vstupy“

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

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.

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 dokladu
const 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.

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 platby
const 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í”
Přidal aiarchitekt.cz · 17. 11. 2026 1:00
Provozuje aiarchitekt.cz