Přeskočit na obsah

Nová fail-closed kontrola hledá vazbu, kterou historická data nemají — blokuje legitimní operace

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

Uživatel u dokončené smlouvy klikne „Vystavit finální fakturu“ a dostane chybu „Zaplacená záloha ZF-… nemá daňový doklad — nejdřív vystavte DD“. Daňový doklad přitom existuje, je zaplacený a je vidět na kartě. Postihlo to všechny smlouvy, jejichž daňový doklad vznikl před zavedením explicitní vazby (v tomto systému 126 z 221 dokladů).

Deset dní předtím se po incidentu (finální faktura bez odpočtu zálohy) přidala fail-closed kontrola: „zaplacená zálohová faktura musí mít nestornovaný daňový doklad“. Kontrola hledala doklad jen přes relaci childInvoices (sloupec parentInvoiceId):

const paidZfWithoutDd = (await prisma.invoice.findMany({
where: { contractId, type: "ZALOHOVA_FAKTURA", status: "PAID" },
select: { number: true, childInvoices: { where: { type: "DANOVY_DOKLAD", status: { not: "CANCELLED" } } } },
})).filter((z) => z.childInvoices.length === 0);
if (paidZfWithoutDd.length > 0) return 400;

Vazba parentInvoiceId se ale zapisuje až od září; starší doklady mají null. Jiná část systému (generátor daňového dokladu) na to už myslela a používala fallback „stejná smlouva + stejná částka“ — nová kontrola toto pravidlo nezopakovala. Na klonu i v testech to prošlo, protože testovací data vazbu měla.

  1. Kontrola přijme i doklad bez vazby na téže smlouvě se stejnou částkou (stejné pravidlo jako generátor dokladu):
const legacyDds = await prisma.invoice.findMany({ where: { contractId, type: "DANOVY_DOKLAD", status: { not: "CANCELLED" }, parentInvoiceId: null } });
const paidZfWithoutDd = paidZfs.filter((z) => z.childInvoices.length === 0 && !legacyDds.some((d) => d.totalPrice.equals(z.totalPrice)));
  1. Jednorázový backfill vazeb: pro každý doklad bez vazby najít na smlouvě právě jednu nestornovanou zálohovou fakturu se stejnou částkou (bez jiného navázaného dokladu) a vazbu doplnit — dry-run vypsal 126 kandidátů, 0 nejednoznačných, 0 bez zálohové faktury; pak apply.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: před nasazením guardu pustit SQL „kolik existujících záznamů by novou podmínkou neprošlo“; pokud > 0, nejde nasadit bez fallbacku/backfillu.
  • Anti-pattern: kontrola postavená výhradně na sloupci/vazbě, která v DB existuje teprve od určitého data; testy jen nad čerstvými daty.
  • Lepší přístup: jedno sdílené pravidlo „patří tento doklad k té záloze?“ použité generátorem i kontrolou; migrace, která vazbu zavádí, zároveň dopočítá historii.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 16. 10. 2026 2:00
Provozuje aiarchitekt.cz