Čítač číselné řady po smazání posledních dokladů pokračuje dál
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Nejvyšší faktura v řadě je FV-0048. Uživatel smaže FV-0049 až FV-0053 (omylem vystavené). Vystaví novou — a dostane FV-0054. V řadě vznikne díra pěti čísel, kterou účetní musí vysvětlovat, přestože smazané doklady už nikde neexistují.
Root cause
Sekce “Root cause”Číslo přiděluje atomický UPDATE number_series SET next_number = next_number + 1 … RETURNING — správně proti souběhu, ale čítač zná jen
jeden směr. Tři mazací cesty (detail, hromadná akce, veřejné API) dělaly
DELETE FROM invoices a čítače se nedotkly. Formulář pro ruční úpravu řady
navíc snížení čítače zakazuje („číslo lze pouze zvyšovat“), takže uživatel
to nemohl opravit ani sám.
Zrcadlový bug už byl v systému dřív opravený: import dokladů čítač
posunul nahoru (GREATEST(next, max + 1)), aby nevznikaly duplicity. Směr
dolů nikdo nedopsal.
Fix
Sekce “Fix”Čistá funkce + jeden helper, volaný ze všech tří mazacích cest po DELETE:
// nová hodnota čítače po smazáníconst candidate = remaining.length ? Math.max(...remaining) + 1 // nejvyšší zbývající v řadě + 1 : Math.min(...deleted); // v řadě nic nezbylo → nejnižší smazanéreturn Math.min(currentNext, candidate); // NIKDY nezvyšovat- Pořadové číslo se parsuje podle šablony řady (
{prefix}{year}-{number:4}→ regex s escapovaným prefixem); čísla mimo šablonu (DRAFT-…, jiný prefix) se ignorují. Math.minzaručí, že smazání prostřední faktury čítač nezmění (díra uvnitř řady zůstává — to je účetně správně) a že ručně nastavený vyšší start řady přežije.UPDATE … WHERE id = $1 AND next_number = $původní— guard proti souběhu s právě probíhajícím claimem.- Helper nikdy nehází: selhání přepočtu nesmí shodit mazání.
Jednorázové srovnání existujících dat: najít řady, kde
next_number > max(parsed) + 1, a snížit jen tam, kde audit log potvrzuje
smazání právě těch čísel v mezeře. Jinak může jít o záměrný start řady.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
SELECT … WHERE next_number > max(parsed_number) + 1přes všechny řady; porovnat s audit logem mazání. - Anti-pattern: čítač/sekvence udržovaný ručně v tabulce, který zvyšuje jen „create“, zatímco „delete“ o něm neví. Totéž platí pro počítadla položek, zůstatky skladu, součty objednávek.
- Lepší přístup: jedna funkce
recomputeCounter(seriesId)volaná po create, delete i importu; nebo čítač odvozovat dotazem a tabulkovou hodnotu používat jen jako spodní hranici. - Past:
grep -rn 'DELETE FROM .*invoices'— každý výskyt musí být následován přepočtem řady. Zapomenutá cesta (veřejné API) je typické místo.
Sister bugs / související
Sekce “Sister bugs / související”- Aplikace obchází generátor čísel — stejná tabulka řad, opačný symptom (duplicitní čísla).