Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -8,7 +8,7 @@ Use this order before reaching for any destructive command:
|
||||
|
||||
1. **Migration applied but app fails at boot** — Most likely cause: code does not yet handle a new column, OR new column lacks a backfill. Prefer **forward-fix**: deploy a hotfix patch that handles the schema, then continue.
|
||||
2. **Migration breaks data integrity** — Restore from the most recent verified backup. Do not run `prisma migrate resolve --rolled-back` against production data without a backup snapshot.
|
||||
3. **Seed produced wrong rows** — Idempotent seeds (the boilerplate's permissions/entitlements seeds are idempotent by design) tolerate re-runs after manual cleanup. Non-idempotent seed sections should never run in production.
|
||||
3. **Lokaler/historischer Seed erzeugte falsche Zeilen** — Nur in einer wegwerfbaren lokalen Datenbank bereinigen und erneut prüfen. Allgemeines Seeding oder ein Re-Run gegen Staging/Produktion ist unter erzwungener RLS verboten.
|
||||
|
||||
## Reverting a migration locally
|
||||
|
||||
@@ -59,6 +59,8 @@ If step 3 fails halfway through, `prisma migrate resolve --rolled-back <migratio
|
||||
|
||||
## Undoing a seed run
|
||||
|
||||
> **Staging/Produktion:** Allgemeines Seeding ist unter erzwungener RLS nicht freigegeben. Die folgenden historischen Bereinigungshinweise sind keine Erlaubnis, den Produktions-Seed oder `permissions:sync` gegen eine produktionsnahe Datenbank auszuführen.
|
||||
|
||||
The boilerplate's production seed (`packages/db/dist/production-seed.server.js`) is gated on `NODE_ENV=production` and explicit `SEED_ADMIN_EMAIL` / `SEED_ADMIN_PASSWORD`. It is idempotent for the canonical permission/entitlement rows but may insert demo data when `SEED_DEMO_DATA=true` accidentally leaks into a non-local environment.
|
||||
|
||||
Undo procedure:
|
||||
@@ -72,7 +74,7 @@ psql "$DATABASE_URL" -c "SELECT id, name FROM \"Tenant\" WHERE slug IN ('acme-co
|
||||
# 3. Delete in dependency order (children first). NEVER use DELETE without a WHERE clause on a production database.
|
||||
```
|
||||
|
||||
After cleanup, re-run the canonical (non-demo) seed to confirm idempotency:
|
||||
Nur gegen eine wegwerfbare lokale Datenbank darf anschließend der kanonische (nicht Demo-)Seed zur Idempotenzprüfung erneut laufen:
|
||||
|
||||
```sh
|
||||
SEED_DEMO_DATA=false NODE_ENV=production node packages/db/dist/production-seed.server.js
|
||||
@@ -80,13 +82,13 @@ SEED_DEMO_DATA=false NODE_ENV=production node packages/db/dist/production-seed.s
|
||||
|
||||
## Permission/role sync rollback
|
||||
|
||||
`pnpm run permissions:sync` is idempotent. To undo an unwanted permission rename:
|
||||
Der produktive Deploy verwendet nicht `pnpm run permissions:sync`, sondern den fail-closed globalen Reconcile in `start.sh migrate`. Schlägt er fehl, werden seine Katalogänderungen und temporären DML-Grants an `hivegrid_rls_definer` gemeinsam zurückgerollt; `FORCE ROW LEVEL SECURITY` bleibt aktiv. Bereits zuvor erfolgreich angewandte Prisma-Migrationen bleiben bestehen.
|
||||
|
||||
1. Revert the offending commit in `packages/db/src/permissions-seed.server.ts`.
|
||||
2. Re-run `pnpm run permissions:sync` against staging.
|
||||
3. Run `verify:permission-matrix` to assert documentation parity.
|
||||
1. Rollout gestoppt lassen und den redigierten Fehlernachweis sichern; weder allgemeinen Seed noch `permissions:sync` starten.
|
||||
2. Katalogdefinition oder Reconcile-Code per geprüftem Forward-Fix korrigieren und den vollständigen One-shot-Pfad erneut ausführen.
|
||||
3. Hat ein fehlerhafter Reconcile bereits committed, vor jeder Datenkorrektur Backup/Restore-Punkt bestätigen und die Korrektur als explizit freigegebene, auditierte Operator-Aktion ausführen.
|
||||
|
||||
Permission rows themselves are immutable identifiers; the seed only adds/updates. Manual `DELETE FROM "Permission" WHERE name = '…'` is risky because foreign-key references in `RolePermission` will cascade.
|
||||
Tenant-eigene Rollen und Rollen mit `isTemplateOrigin = true` dürfen auch beim Rollback nicht automatisiert verändert oder nachgezogen werden. Manuelles `DELETE FROM "Permission" WHERE name = '…'` bleibt wegen kaskadierender `RolePermission`-Referenzen unzulässig.
|
||||
|
||||
## Practice drill
|
||||
|
||||
|
||||
Reference in new issue
Block a user