Nová fail-closed kontrola hledá vazbu, kterou historická data nemají — blokuje legitimní operace
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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ů).
Root cause
Sekce “Root cause”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.
Fix
Sekce “Fix”- 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)));- 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í”- Dvě cesty vystavení dokladu — párovač zná jen jednu — stejná rodina: dvě místa, dvě pravidla.
- Časová zóna u řezu období (UTC vs. lokální den) — původní incident, kvůli kterému tato kontrola vznikla.