Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/utils/services/shkRoles.server.ts
T
2026-07-08 16:15:37 +02:00

129 lines
5.6 KiB
TypeScript

import { loadWebConfig } from "@hivegrid/config";
import { db } from "~/utils/db.server";
// R-P2b — SHK-Standard-Rollen (vom Partner genannt). PROVISORISCH/ANPASSBAR: datengetrieben, per
// Tenant als Template geseedet (upsert, idempotent). Die fachspezifischen Rechte (CRM/Leads/Projekte/
// Auftraege) haengen sich PRO PHASE an, sobald die Entitaeten existieren; bei P2 differenzieren nur die
// bereits vorhandenen App-/Settings-Rechte. Anpassbar ueber den Rollen-Editor (D-P2) oder durch Aendern
// dieser Definition + Re-Seed. Bulk-entfernbar ueber SHK_ROLE_NAMES (is_demo_data-Konvention, bis das
// Entity-Model TenantRole.is_template_origin angeglichen ist).
export type ShkRoleTier = "admin" | "elevated" | "standard";
export interface ShkRoleSeed {
readonly name: string;
// i18n-Key im Namespace-Format `settings:<key>` (Doppelpunkt!), gespeichert in Role.description;
// der Rollen-Editor löst ihn via t() auf (roleDisplayDescription). i18next adressiert ausgelagerte
// Namespaces mit ":" -- ein Punkt-Präfix landet im defaultNS und erschiene als nackter Key. Kein
// Klartext im Seed -> erfüllt die Hardcoded-String-Disziplin; Text liegt in settings.json.
readonly descriptionKey: string;
readonly tier: ShkRoleTier;
readonly permissionKeys: readonly string[];
}
const DASHBOARD = "app.dashboard.view";
export const SHK_ROLE_SEEDS: readonly ShkRoleSeed[] = [
{
name: "Geschäftsführer",
descriptionKey: "settings:shkRoles.geschaeftsfuehrer.description",
tier: "admin",
permissionKeys: [
DASHBOARD,
"app.settings.members.view",
"app.settings.members.create",
"app.settings.members.update",
"app.settings.members.delete",
"app.settings.roles.view",
"app.settings.roles.set",
"app.settings.groups.full",
"app.settings.account.view",
"app.settings.account.update",
"app.settings.subscription.view",
"app.settings.subscription.update",
"app.settings.subscription.invoices.view",
"app.settings.auditTrails.view",
],
},
{
name: "Projektleiter",
descriptionKey: "settings:shkRoles.projektleiter.description",
tier: "elevated",
permissionKeys: [DASHBOARD, "app.settings.members.view", "app.settings.groups.full", "app.settings.auditTrails.view"],
},
{
name: "Verwaltung",
descriptionKey: "settings:shkRoles.verwaltung.description",
tier: "elevated",
permissionKeys: [DASHBOARD, "app.settings.members.view", "app.settings.account.view", "app.settings.subscription.invoices.view"],
},
{
name: "Vertriebler",
descriptionKey: "settings:shkRoles.vertriebler.description",
tier: "standard",
permissionKeys: [DASHBOARD],
},
{
name: "Kundensupporter",
descriptionKey: "settings:shkRoles.kundensupporter.description",
tier: "standard",
permissionKeys: [DASHBOARD],
},
{
name: "Monteur",
descriptionKey: "settings:shkRoles.monteur.description",
tier: "standard",
permissionKeys: [DASHBOARD],
},
];
export const SHK_ROLE_NAMES: readonly string[] = SHK_ROLE_SEEDS.map((role) => role.name);
// Product decision 2026-07-07 (Akeshan, resolving the R-P2b seed-vs-design conflict): on PRODUCTION a
// fresh tenant starts with the admin system role only (David's validated D-P2 decision); the 6 SHK seed
// roles stay a staging/dev testing convenience. SEED_SHK_ROLES=true|false overrides either way in case
// the partner wants the seeds in production after all. Environment detection: NODE_ENV is "production"
// on staging containers too, so the deploy-scoped SENTRY_ENVIRONMENT (staging|production, estate
// standard §1) decides first and nodeEnv only covers local dev/test.
export function shouldSeedShkRoles(env: Record<string, string | undefined> = process.env): boolean {
if (env.SEED_SHK_ROLES === "true") return true;
if (env.SEED_SHK_ROLES === "false") return false;
const environment = env.SENTRY_ENVIRONMENT ?? loadWebConfig().config.nodeEnv;
return environment !== "production";
}
// Seedt die SHK-Rollen als App-Rollen eines Tenants (idempotent). Setzt fehlende Rollen + ihre
// vorhandenen Permission-Verknuepfungen auf; bestehende bleiben unberuehrt (anpassbar im Editor).
// Auf Produktion no-op (s. shouldSeedShkRoles) — dort startet ein Tenant nur mit der Admin-Systemrolle.
export async function seedShkRolesForTenant(tenantId: string): Promise<{ createdRoles: number }> {
if (!shouldSeedShkRoles()) {
return { createdRoles: 0 };
}
const wantedKeys = [...new Set(SHK_ROLE_SEEDS.flatMap((role) => role.permissionKeys))];
const permissions = await db.permission.findMany({ where: { name: { in: wantedKeys } }, select: { id: true, name: true } });
const permissionIdByName = new Map(permissions.map((permission) => [permission.name, permission.id]));
let createdRoles = 0;
for (const [index, seed] of SHK_ROLE_SEEDS.entries()) {
let role = await db.role.findFirst({ where: { tenantId, name: seed.name, type: "app" }, select: { id: true } });
if (!role) {
role = await db.role.create({
data: { tenantId, name: seed.name, description: seed.descriptionKey, type: "app", assignToNewUsers: false, isDefault: false, order: 100 + index },
select: { id: true },
});
createdRoles++;
}
for (const key of seed.permissionKeys) {
const permissionId = permissionIdByName.get(key);
if (!permissionId) {
continue;
}
const existing = await db.rolePermission.findFirst({ where: { roleId: role.id, permissionId } });
if (!existing) {
await db.rolePermission.create({ data: { roleId: role.id, permissionId } });
}
}
}
return { createdRoles };
}