Přeskočit na obsah

Nastavení v administraci existuje, ale žádný kód ho nečte

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

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ň.

Dva nezávislé problémy stejné rodiny „pravda je na více místech“:

  1. Nastavení bez čtenáře. Sloupec default_vat_rate měl zápis (formulář nastavení → API → DB) a zobrazení, ale grep př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, API default(21) ve třech schématech). Protože zadrátovaná hodnota = nejčastější reálná hodnota, chyba byla roky neviditelná.
  2. 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 %, vatMode zůstal. Server ho uložil bez kontroly a PDF podle něj tisklo doložku neplátce vedle vyčíslené DPH.

Jeden modul (čisté funkce + tenký loader) a všechny cesty přes něj:

defaultVatRateFor(org) // neplátce → 0; jinak org.defaultVatRate, fallback 21
normalizeVatForOrg(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: vatRate polož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 defaultVatRate z 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 = NULL u dokladu plátce s DPH > 0 a vat_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(), ne default()), 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í”
Přidal aiarchitekt.cz · 5. 11. 2026 1:00
Provozuje aiarchitekt.cz