Přeskočit na obsah

Dávkový job počítá částku z aktuálního nastavení místo zmrazeného pravidla předpisu

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

Předpis má uloženou pozdní sazbu 500. Správce v nastavení zvýší pozdní sazbu na 900 (má platit pro příští rok). Připomínka 15. 2. pošle členovi e-mail „zaplaťte 900“, zatímco QR v členské sekci a detail v administraci ukazují 500. Druhý rozdíl: připomínka odečítala hrubé příjmy, takže vrácená (refundovaná) platba stále snižovala požadovanou částku.

Job si pravidlo sestavil znovu: feeRuleForYear(year, aktuálníSazby) a od výsledku odečetl sum(receipts). Předpis přitom nese fee_rule zmrazené při vzniku (právě proto, aby pozdější změna sazebníku nezměnila existující dluhy) a ostatní místa (QR, admin) počítala přes settle(rule, receipts, refunds, asOf).

// job (chybně)
const rule = feeRuleForYear(year, await getFees()); // aktuální sazebník
const amount = amountDueAt(rule, today) - sum(receipts); // hrubé příjmy

Job používá totéž vyhodnocení jako zbytek systému:

const rule = ruleOf(payment); // zmrazené fee_rule z předpisu
const s = settle(rule, receipts, refunds, today); // čisté příjmy, dluh k datu
if (s.shortfall <= 0) continue;
queueEmail({ amount: s.shortfall, … });

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: test „změň globální sazbu po vzniku předpisu, spusť job, dešifruj/přečti odeslanou částku“ + test s refundovaným příjmem; grep na getFees()/getSettings( uvnitř jobů, které pracují nad existujícími záznamy.
  • Anti-pattern: job nebo e-mailová šablona si „pro jistotu“ skládá pravidlo z nastavení; částka se počítá na třech místech třemi způsoby.
  • Lepší přístup: pravidlo zmrazit u záznamu při vzniku a mít jednu funkci „kolik dluží k datu“, kterou volá všechno (e-mail, QR, admin, job). Globální nastavení ovlivňuje jen nově vznikající záznamy.

Sister bugs / související

Sekce “Sister bugs / související”
  • Nastavení, které nikdo nečte — opačný případ (nastavení existuje, kód ho ignoruje); tady kód čte nastavení, které číst nemá.
  • Cron s persistovaným stavem po splatnosti přežije editaci.
Přidal aiarchitekt.cz · 13. 11. 2026 1:00
Provozuje aiarchitekt.cz