Dávkový job počítá částku z aktuálního nastavení místo zmrazeného pravidla předpisu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”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.
Root cause
Sekce “Root cause”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íkconst amount = amountDueAt(rule, today) - sum(receipts); // hrubé příjmyFix
Sekce “Fix”Job používá totéž vyhodnocení jako zbytek systému:
const rule = ruleOf(payment); // zmrazené fee_rule z předpisuconst s = settle(rule, receipts, refunds, today); // čisté příjmy, dluh k datuif (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.