Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -13,13 +13,19 @@ The web seed path in `apps/web/app/utils/services/rolesAndPermissionsService.ts`
This document intentionally summarizes the public role and permission shape only. It must not include secrets, environment values, tokens, passwords, or seeded credential material.
## Deploy-Reconcile und AD-29
`start.sh migrate` führt nach erfolgreichem Prisma-Deploy einen fail-closed Reconcile des globalen `Permission`-Katalogs, der fünf globalen Defaultrollen (`tenantId IS NULL`) und ihrer katalogeigenen `RolePermission`-Links aus. Der Schritt schreibt keine `UserRole`-Zuordnung direkt und ist kein allgemeiner Seed. Beim bewusst beibehaltenen Cleanup veralteter globaler Default-Adminrollen entfernt der vorhandene Fremdschlüssel-Cascade jedoch auch Zuordnungen zu genau diesen globalen Altrollen; Zuordnungen der fünf kanonischen Rollen und tenant-eigener Rollen liegen außerhalb dieses Cleanups.
Tenant-eigene Rollen (`tenantId IS NOT NULL`) sowie Rollen mit `isTemplateOrigin = true` liegen nach AD-29 außerhalb dieses Deploy-Vertrags. Eine kanonische globale Rolle mit `isTemplateOrigin = true` wird nicht still normalisiert, sondern lässt den Reconcile vor Rollen-DML fail-closed abbrechen; auch der Stale-Cleanup erfasst nur globale Nicht-Template-Rollen. Bestehende Tenants werden niemals automatisch nachgezogen und bleiben unberührt. Ein Bestandsnachzug ist ausschließlich als explizit freigegebene und auditierte Operator-Aktion zulässig. Allgemeines Seeding in Staging oder Produktion bleibt unter erzwungener RLS verboten.
## Admin roles
| Role | Type | Assigned to new users by default? | Intended capability summary |
| --- | --- | --- | --- |
| SuperAdmin | `admin` | No | Full admin surface owner. Receives every static `admin.*` permission and is also included in seed-time dynamic entity permissions. |
The operator/admin host intentionally seeds no additional default admin roles. Former default admin roles such as Product Designer, Developer, Auditor, Marketing, and Guest are removed during permission sync when they are still marked as default admin roles.
The operator/admin host intentionally seeds no additional default admin roles. Former default admin roles such as Product Designer, Developer, Auditor, Marketing, and Guest are removed during permission sync when they are still marked as global, non-template default admin roles; their foreign-key-bound user assignments are removed with them by the documented cascade.
## App roles
@@ -68,6 +74,8 @@ Each generated entity permission is seeded with role coverage for:
## Seed behavior
Dieser Abschnitt beschreibt das vorhandene Seed-Werkzeug, nicht einen zulässigen Staging-/Produktions-Deploypfad. Der automatische Deploy verwendet ausschließlich den oben beschriebenen globalen Reconcile; allgemeines Seeding bleibt verboten.
`seedRolesAndPermissions(adminEmail)` performs the role and permission seed in these phases:
1. Sync static admin roles, app roles, permissions, and role-permission links through `@hivegrid/db/permissions-seed.server`.