Obecná a konkrétní refundace rezervují tytéž peníze dvakrát
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”K předpisu je přijato 500. Matrikář zadá obecnou žádost o refundaci 400 a poté žádost o refundaci 400 vázanou na konkrétní příjem. Obě projdou. V evidenci je rezervováno 800 proti 500 přijatým; při vyplacení by klub vrátil víc, než dostal. Chyba je sekvenční, zámek ji sám neřeší.
Root cause
Sekce “Root cause”Kontrola porovnávala „už rezervováno“ a „přijato“ jen ve stejném rozsahu jako nový požadavek:
const pool = input.receiptId ? receipts.filter(r => r.id === input.receiptId) : receipts;const received = sum(pool);const already = sum(refunds.filter(f => input.receiptId ? f.receipt_id === input.receiptId : true));if (already + amount > received) throw 422;Obecná rezervace (bez receipt_id) se při kontrole konkrétního příjmu nezapočítala a naopak konkrétní rezervace nesnížily pool pro obecnou. Dva rozsahy, dvě nezávislé účetnictví nad jedněmi penězi.
Fix
Sekce “Fix”Dvě kontroly najednou nad jedním poolem (bez zamítnutých žádostí, vyplacené zůstávají započtené):
const active = refunds.filter(f => f.status !== "rejected");if (sum(active) + amount > sum(receipts)) throw 422; // globální zůstatekif (receiptId) { const onReceipt = sum(active.filter(f => f.receipt_id === receiptId)); if (onReceipt + amount > receipt.amount) throw 422; // kapacita položky}Plus navazující místo, které refundaci žádalo automaticky (zamítnutí zaplacené žádosti), teď žádá jen čistý zůstatek (přijato − už rezervováno), jinak samo narazí na novou invariantu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: test „obecná + konkrétní“ v obou pořadích, s více položkami (300 + 200), se zamítnutou (uvolní) i vyplacenou (neuvolní) rezervací a paralelně.
- Anti-pattern: filtr
poolpodle rozsahu požadavku a porovnání jen uvnitř něj; každý typ rezervace si vede vlastní součet. - Lepší přístup: jeden disponibilní zůstatek na agregát, lokální limity jako dodatečná podmínka, a každá automatická rezervace (storno, zamítnutí) si zůstatek nejdřív zjistí.
Sister bugs / související
Sekce “Sister bugs / související”- Odvozený stav přepočítaný ze snapshotu vlastní transakce — stejný agregát, souběhová část problému.