Nastavení v administraci existuje, ale žádný kód ho nečte
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Firma přepne režim na „plátce DPH“, v nastavení uvidí pole „výchozí sazba DPH“ s hodnotou 21 % a uloží. Nové faktury skutečně nabízejí 21 % — ale ne díky nastavení. Kdyby uživatel zadal 12 %, nic by se nestalo. Zároveň faktury vystavené v režimu neplátce s ručně přidanou DPH nesou na PDF doložku „neplátce DPH“ a přitom účtují daň.
Root cause
Sekce “Root cause”Dva nezávislé problémy stejné rodiny „pravda je na více místech“:
- Nastavení bez čtenáře. Sloupec
default_vat_rateměl zápis (formulář nastavení → API → DB) a zobrazení, alegreppřes celou aplikaci našel nulu čtení. Výchozí sazba byla zadrátovaná na sedmi místech (prázdný řádek faktury, editace, šablony opakovaných faktur, pokladna, ceník, APIdefault(21)ve třech schématech). Protože zadrátovaná hodnota = nejčastější reálná hodnota, chyba byla roky neviditelná. - Režim DPH jako stav formuláře. Formulář si při načtení zjistil,
že firma je neplátce, nastavil
vatMode = "non_payer"a vynuloval položky. Když uživatel pak položkám ručně dal 21 %,vatModezůstal. Server ho uložil bez kontroly a PDF podle něj tisklo doložku neplátce vedle vyčíslené DPH.
Fix
Sekce “Fix”Jeden modul (čisté funkce + tenký loader) a všechny cesty přes něj:
defaultVatRateFor(org) // neplátce → 0; jinak org.defaultVatRate, fallback 21normalizeVatForOrg(org, payloadVatMode, items) // neplátce: vatMode 'non_payer' + všechny položky 0 // plátce: položka bez sazby ← výchozí; 'non_payer' z formuláře se ZAHODÍ- Zod:
vatRatepoložky je volitelné — server doplní výchozí sazbu, aby i API klient bez znalosti sazby dostal správný doklad. - Server je autorita nad
vat_mode: formulář může navrhnout, DB uloží jen hodnotu konzistentní s režimem firmy. - Klientské formuláře čtou
defaultVatRatez profilu firmy a předávají ho do továrny na prázdný řádek (emptyLineItem(rate)), místo konstanty. - Jednorázová oprava dat:
vat_mode = NULLu dokladu plátce s DPH > 0 avat_mode = 'non_payer'(jediný výskyt v systému, nalezen dotazem přes všechny tenanty).
Past při hromadné opravě dat
Sekce “Past při hromadné opravě dat”Při přepnutí na plátce se nabízí plošně přepsat 0 % → 21 % ve všech šablonách. Ne. Šablona se smíšenými sazbami (0 i 21 na různých řádcích) nese záměr per položku — typicky plnění do jiného členského státu EU s přenesenou daní. Plošný přepis ho zničí (stalo se, vráceno rekonstrukcí z posledních vygenerovaných faktur). Pravidlo: automaticky měnit jen šablony, kde jsou všechny řádky 0 %; smíšené nahlásit k revizi.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: pro každý sloupec v tabulce nastavení
grep -rn "<nazev>" src/— hledat čtení mimo formulář nastavení a jeho API. Nula = mrtvé nastavení. Druhý grep:default(21),?? 21,|| "21"— každý výskyt je kandidát na nahrazení čtením nastavení. - Anti-pattern: UI přidá pole „aby to tam bylo“, backend ho uloží, nikdo nenapojí spotřebitele; konstanta zůstane v kódu, protože „to je stejně 21“.
- Lepší přístup: jedna funkce
defaultXFor(org)jako jediný zdroj výchozí hodnoty; schéma vstupu výchozí hodnotu nezná (optional(), nedefault()), doplní ji server podle kontextu tenanta. Test: změň nastavení na netypickou hodnotu (12 %) a ověř, že se propsala.
Sister bugs / související
Sekce “Sister bugs / související”- Cronem zapsaný stav přežije editaci — jiný tvar téhož: hodnota žije na dvou místech a jedno z nich nikdo neaktualizuje.