Přeskočit na obsah

Čítač číselné řady po smazání posledních dokladů pokračuje dál

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

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

Čí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.

Č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.min zaručí, ž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) + 1 př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í”
Přidal aiarchitekt.cz · 25. 10. 2026 2:00
Provozuje aiarchitekt.cz