Ranggefuege: Rollen, die aufeinander aufbauen

Bisher trug jede Rolle ihre Rechte vollstaendig selbst. Bei achtzehn Rollen
und zweiundzwanzig Rechten heisst das, dass eine hoehere Rangrolle die ganze
Liste der darunterliegenden noch einmal abhaken muss - beim Anlegen
fehleranfaellig und bei jeder spaeteren Aenderung doppelt zu pflegen.

Ein Gefuege ist eine benannte, geordnete Folge von Rollen. Jede Sprosse
erbt alles von jeder Sprosse unter ihr, verwaltet wird nur noch das, was
oben dazukommt. Geerbt wird nicht nur die Rechteliste, sondern auch
Freigabestufe und Anmeldung: sonst waere eine Befoerderung unter Umstaenden
eine Herabstufung, naemlich immer dann, wenn Discord beim Befoerdern die
alte Rangrolle abnimmt.

Die Ordnung ist bewusst eine Reihenfolge und kein Zeiger je Rolle - ueber
ganzen Zahlen gibt es keinen Zyklus, den man abfangen muesste. Aufloesen
eines Gefueges laesst die Rollen stehen und nimmt nur das Geerbte weg.

Die Rechnung steht als reine Funktion in lib/auth/ladders.ts und wird an
drei Stellen benutzt: bei der Rechteaufloesung, in der Verwaltung und in
der Vorschau des Editors, die im Browser mitrechnet. Eine Vorschau, die den
Stand vor dem Verschieben zeigt, waere schlimmer als keine.

Die Rollenseite zeigt Geerbtes kursiv und gesperrt an, damit dort niemand
blind Kaestchen setzt, die laengst gesetzt sind.

Nebenbei: Aenderungen an der Rollenzuordnung landen jetzt im Protokoll, mit
Vorher und Nachher. Wer Rollen aendert, aendert die Rechte anderer - genau
dafuer ist es da.

web/app/(app)/admin/ranggefuege/actions.ts

@@ -0,0 +1,102 @@
+'use server'
+
+import { revalidatePath } from 'next/cache'
+import { z } from 'zod'
+import { requireUser } from '@/lib/auth/current'
+import { AccessError } from '@/lib/errors'
+import { createLadder, deleteLadder, setLadderRoles, updateLadder } from '@/lib/roles/ladders'
+import { de } from '@/lib/i18n/de'
+
+export type ActionResult = { ok: true } | { ok: false; error: string }
+
+function toMessage(error: unknown): string {
+  if (error instanceof AccessError) {
+    return de.actionErrors[error.code] ?? de.actionErrors.default!
+  }
+  console.error('[ranggefuege] unerwartet', error)
+  return de.actionErrors.default!
+}
+
+/**
+ * Die Prüfung steht im Dienst, nicht hier und nicht in der Oberfläche: eine
+ * Server Action ist ein Endpunkt und direkt aufrufbar, egal was das UI zeigt.
+ */
+function aktualisieren(): void {
+  revalidatePath('/admin/ranggefuege')
+  revalidatePath('/admin/rollen')
+}
+
+const createSchema = z.object({
+  name: z.string().min(1).max(80),
+  note: z.string().max(300).optional(),
+})
+
+export async function createLadderAction(
+  _prev: ActionResult | null,
+  formData: FormData,
+): Promise<ActionResult> {
+  const user = await requireUser()
+  const parsed = createSchema.safeParse(Object.fromEntries(formData))
+  if (!parsed.success) return { ok: false, error: de.ladderAdmin.nameInvalid }
+
+  try {
+    await createLadder(user.permissions, parsed.data)
+    aktualisieren()
+    return { ok: true }
+  } catch (error) {
+    return { ok: false, error: toMessage(error) }
+  }
+}
+
+const updateSchema = z.object({
+  id: z.string().min(1),
+  name: z.string().min(1).max(80),
+  note: z.string().max(300).optional(),
+})
+
+export async function updateLadderAction(
+  _prev: ActionResult | null,
+  formData: FormData,
+): Promise<ActionResult> {
+  const user = await requireUser()
+  const parsed = updateSchema.safeParse(Object.fromEntries(formData))
+  if (!parsed.success) return { ok: false, error: de.ladderAdmin.nameInvalid }
+
+  try {
+    await updateLadder(user.permissions, parsed.data)
+    aktualisieren()
+    return { ok: true }
+  } catch (error) {
+    return { ok: false, error: toMessage(error) }
+  }
+}
+
+export async function deleteLadderAction(id: string): Promise<ActionResult> {
+  const user = await requireUser()
+  try {
+    await deleteLadder(user.permissions, id)
+    aktualisieren()
+    return { ok: true }
+  } catch (error) {
+    return { ok: false, error: toMessage(error) }
+  }
+}
+
+const orderSchema = z.object({
+  id: z.string().min(1),
+  roleIds: z.array(z.string().min(1)).max(30),
+})
+
+export async function setLadderRolesAction(input: unknown): Promise<ActionResult> {
+  const user = await requireUser()
+  const parsed = orderSchema.safeParse(input)
+  if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
+
+  try {
+    await setLadderRoles(user.permissions, parsed.data)
+    aktualisieren()
+    return { ok: true }
+  } catch (error) {
+    return { ok: false, error: toMessage(error) }
+  }
+}