Ruční deploy přeskočí migrace druhého (master) schématu — feature padá na „table does not exist“
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Uživatel nahraje soubor k záznamu (faktura k provizi) a při uložení dostane chybu. V logu aplikace:
Invalid `prisma.storageReserveLedger.findUnique()` invocation:The table `public.StorageReserveLedger` does not exist in the current database. (P2021)… kompenzace NEDOKONČENA v kroku quotaOpakované pokusy nechávají v DB řádky evidence kompenzace ve stavu compensating (soubor smazán, kvóta „neuvolněna“), které nikdo neuklidí.
Root cause
Sekce “Root cause”- Multi-tenant aplikace má dvě Prisma schémata:
prisma/schema.prisma(tenant DB) aprisma/master/schema.prisma(master DB) a ke každému vlastní migrační runner (migrate-tenants.mjs,migrate-master.mjs). Oficiální deploy skript volá oba, ale ruční „rychlá“ deploy rutina (rsync → migrate-tenants → gated build) volala jen tenantový runner. Master migrace z 22. 8. (nová tabulka pro exactly-once rezervaci kvóty úložiště) se tak nikdy nenasadila; dry-run tenantů hlásil „vše aktuální“, což vytvořilo falešný pocit jistoty. - Feature nahrání souboru byla správně fail-closed (kompenzace: unlink souboru → uvolnění kvóty → smazání evidence), ale sweep kompenzací volal jen integrační test — žádný cron. Nedokončená evidence proto zůstávala navždy.
Fix
Sekce “Fix”- Aplikovat chybějící master migraci (
node scripts/migrate-master.mjs), ověřit_prisma_migrationsv master DB a existenci tabulky. - Sweep kompenzací zapojit do denního dohledu (cron route), selhání sweepu hlásit jako kritický alert.
- Po migraci spustit jednorázový self-check ledgeru (rezervace → důkaz → uvolnění syntetickým klíčem) a sweep, který doklidí staré řádky.
- Do gatovaného build skriptu přidat kontrolu:
migrate-master --dry-runimigrate-tenants --dry-run; jakákoli čekající migrace ⇒ build se nespustí.
Jak poznat
Sekce “Jak poznat”grep -c "^(dry-run)"ve výstupu master runneru > 0, zatímco tenant runner hlásí „aktuální“.- V master DB chybí poslední záznamy v
_prisma_migrationsoproti adresářiprisma/master/migrations. - Evidence kompenzací (
*Compensationtabulka) má řádky starší než lease sattempts> 0 alastErrorobsahující P2021.
Poučení
Sekce “Poučení”Dvě schémata = dva runnery = dvě místa, kde se dá zapomenout. Každá deploy cesta (včetně „jen rychlý build“) musí kontrolovat obě, a každá fail-closed kompenzace potřebuje plánovaný sweep, jinak se fail-closed změní v „navždy zaseklé“.