feat(laeufe): Vier-Augen-Freigabe (#040)
Prüfung / pruefung (push) Waiting to run
Prüfung / e2e (push) Blocked by required conditions

Verlangt eine Vorlagen-Version eine Freigabe, laesst sich ein Lauf erst
abschliessen, wenn ein Zweiter ihn freigegeben hat. Das braucht zweierlei, und
beides zusammen: das neue Recht `freigeben` (ADMIN und REDAKTEUR, nicht
TECHNIKER) und dass man nicht an dem Lauf gearbeitet hat.

Als gearbeitet zaehlt: angelegt, einen Schritt gesetzt oder abgeschlossen. Eine
Zuweisung allein nicht — waere die Regel hier strenger, blockierte sie kleine
Teams ohne Gewinn.

Auch ein Administrator kann sich nicht selbst freigeben, und das ist der ganze
Sinn. Die Pruefung sitzt in `hatDaranGearbeitet` an einer Stelle, wie
`laufMussVeraenderbarSein`; die wichtigste Haelfte — der Ersteller — haelt
zusaetzlich ein CHECK in der Datenbank.

Zurueckweisen verlangt eine Begruendung, setzt den Lauf auf IN_ARBEIT und nimmt
eine erteilte Freigabe zurueck. Kein fuenfter LaufStatus: ein neuer Enum-Wert
haette jeden Codepfad betroffen, der heute vier Faelle kennt.

Sobald jemand abzuschliessen versucht und die Freigabe fehlt, bekommen die
Freigabeberechtigten eine Mail — ein anderer Empfaengerkreis als bei jeder
anderen Meldung, und ohne die, die gearbeitet haben. Die Aufforderung entsteht
ausserhalb der Transaktion: innerhalb wuerde sie mit dem Fehler zurueckgerollt,
und dann wartet ein Lauf auf etwas, von dem niemand weiss. Ein partieller
Unique-Index haelt sie bei mehreren Versuchen auf einmal.

Die Pflicht haengt an der Version, nicht an der Vorlage: eine veroeffentlichte
Version ist unveraenderlich, ein laufender Lauf behaelt also seine Regel. Beim
Bearbeiten und Duplizieren wandert sie mit — das war die unmittelbare Lehre aus
#039, wo die tiefe Kopie zwei Felder stillschweigend verworfen hatte.

1526 Vitest-Tests (vorher 1496), 115 E2E-Ablaeufe gruen. Klickprobe am gebauten
Stand mit elf Pruefungen; drei rote Punkte darin waren meine eigenen
Testfehler, einer davon lehrreich: ein reload() direkt nach einer Server Action
trifft den Router-Cache von Next und zeigt kurz den alten Stand.

Closes #40

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-10-24 01:14:04 +02:00
co-authored by Claude Opus 5
parent a2330ef682
commit d30bb6d235
27 changed files with 1373 additions and 44 deletions
+34
View File
@@ -423,6 +423,40 @@ dieselbe Stelle. Dass eine Schritt-Bedingung auf **dieselbe Version** zeigt,
haelt ein Trigger: nach dem Veroeffentlichen waere ein fremder Verweis nicht mehr
entscheidbar, und der Abschnitt erschiene stillschweigend immer.
## 5f-3. Die Vier-Augen-Freigabe: eine Stelle, zwei Netze
Verlangt eine Version eine Freigabe, haengt der Abschluss daran — und die Regel
dahinter ist **eine Funktion**: `hatDaranGearbeitet` in
`src/server/services/laeufe.ts`. Sie wird vor jeder Freigabe und vor jeder
Zurueckweisung gerufen, genau wie `laufMussVeraenderbarSein` vor jeder Aenderung
an einem Lauf. Zwei Stellen liefen auseinander, und die erste, die es vergisst,
hebt die Regel auf.
Gezaehlt wird dreierlei: wer den Lauf **angelegt** hat, wer ein
**Schrittergebnis** gesetzt hat, und wer ihn **abgeschlossen** hat. Der
Zustaendige gilt bewusst **nicht** als Bearbeiter — eine Zuweisung ist noch keine
Arbeit, und waere die Regel hier strenger, blockierte sie kleine Teams ohne
Gewinn.
**Zwei Netze, nicht eines.** Die wichtigste Haelfte steht als CHECK in der
Datenbank (`Lauf_freigabe_nicht_selbst`): der Ersteller gibt nicht frei, auch
dann nicht, wenn jemand an der Dienstschicht vorbei schreibt. Der Dienst prueft
strenger, weil er in zwei weitere Tabellen sehen kann; ein CHECK braeuchte dafuer
eine Unterabfrage.
**Das Recht `freigeben` hat nicht `TECHNIKER`**, und das ist eine Entscheidung
gegen Bequemlichkeit: sonst haengt die Vier-Augen-Regel daran, dass zufaellig ein
zweiter Techniker greifbar ist. Wer sie umgehen will, braucht ein Konto mit mehr
Rechten — und das steht im Protokoll.
**Die Aufforderung entsteht ausserhalb der Transaktion.** Der Abschlussversuch
scheitert mit `FreigabeFehlt`; `laufAbschliessen` faengt genau diesen Typ,
reiht die Meldung an die Freigabeberechtigten ein und wirft weiter. Innerhalb
der Transaktion wuerde sie mitsamt dem Fehler zurueckgerollt — und dann wartet
ein Lauf auf etwas, von dem niemand weiss. Ein partieller Unique-Index
(`Zustellung_freigabe_einmal`) sorgt dafuer, dass mehrere Versuche nicht mehrere
Mails ergeben.
## 5g. Der Verzeichnis-Abgleich: vier Schichten und eine Notbremse
Eine Verzeichnisquelle hat seit #028 eine **Art** — `LDAP`, `GRAPH` oder `SCIM` —,