Přeskočit na obsah

Cronem zapsaný stav „po splatnosti“ přežije posun splatnosti do budoucna

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

Uživatel vystaví fakturu se splatností 14 dní. Po uplynutí splatnosti ji systém správně označí „Po splatnosti“. Uživatel fakturu otevře, posune datum vystavení i splatnost o měsíc dopředu a uloží. Seznam i detail dál ukazují červený badge „Po splatnosti“, přestože splatnost je za tři týdny. Stav se nezmění ani po dalším uložení, ani druhý den.

Stav OVERDUE je persistovaný sloupec status, nikoli hodnota počítaná z due_date. Zapisuje ho jen denní cron:

UPDATE invoices SET status = 'OVERDUE'
WHERE status IN ('ISSUED','SENT','VIEWED')
AND remaining_amount > 0
AND due_date < CURRENT_DATE;

Cron zná jen jeden směr (→ OVERDUE). Editační endpoint zapíše nové due_date, ale sloupec status nechá být — žádný kód cestu OVERDUE → ISSUED/SENT neřeší. UI sice pro „fakticky po splatnosti“ počítá z due_date, ale badge bere status z DB přednostně:

// seznam: derivace z data se použije jen pro NE-overdue statusy
const overdue = isOverdue(invoice.due_date, invoice.status); // status OVERDUE → false
<StatusBadge status={overdue ? "OVERDUE" : invoice.status} /> // ale status === "OVERDUE"

Výsledek: dvě pravdy (datum říká „v pořádku“, status říká „po splatnosti“) a vyhrává ta zastaralá.

Čistá funkce rozhodne přechod z aktuálního stavu, data a historie dokladu; volá se po každém uložení dokladu, ne jen z cronu:

export function resolveOverdueTransition(i: {
status: string; type: string; pastDue: boolean;
remaining: string; sentAt: Date | null; viewedAt: Date | null;
}) {
if (i.status === "OVERDUE") {
if (i.pastDue) return null; // stále po splatnosti
if (i.viewedAt) return "VIEWED"; // vrať se tam, kde doklad byl
if (i.sentAt) return "SENT";
return "ISSUED";
}
if (!["ISSUED","SENT","VIEWED"].includes(i.status)) return null;
if (!INVOICE_TYPES.includes(i.type)) return null;
if (!i.pastDue || !(Number(i.remaining) > 0)) return null;
return "OVERDUE"; // stejná pravidla jako cron
}

Důležité detaily:

  • pastDue počítá databáze (due_date < CURRENT_DATE), aby časová zóna seděla s cronem a nevznikl den, kdy cron a editace nesouhlasí.
  • UPDATE … WHERE id = $1 AND status = $původní — guard na původní status dělá zápis idempotentní při souběhu s cronem.
  • Přechod zpět vrací doklad do stavu podle historie (sent_at, portal_viewed_at), ne natvrdo na ISSUED — jinak by se ztratila informace, že doklad už byl odeslán.
  • Přechod do OVERDUE z editace posílá stejný webhook jako cron: pro integrace je to stejná událost bez ohledu na to, kdo ji vyvolal.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: grep -rn "SET status = 'OVERDUE'" (nebo jiný odvozený stav) a pro každý zdrojový sloupec v podmínce (due_date) najít všechny UPDATE … due_date =. Každý z nich musí stav přepočítat, nebo je to bug.
  • Anti-pattern: stavový automat, kde jeden přechod vlastní cron a opačný přechod nevlastní nikdo. Komentář typu „cron to srovná“ u editace je varovný signál — cron srovná jen jeden směr.
  • Lepší přístup: jedna čistá funkce resolveXTransition(row) jako jediný zdroj pravidel; cron i editační endpoint ji volají. Alternativně stav nepersistovat vůbec a počítat ho v dotazu (CASE WHEN due_date < CURRENT_DATE …), pokud na něm nezávisí webhooky nebo notifikace.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 22. 10. 2026 2:00
Provozuje aiarchitekt.cz