feat(vorlagen): Abschnitte nur fuer bestimmte Abteilungen (#58)

prisma/migrations/20261004210000_abteilungsabschnitte/migration.sql

@@ -0,0 +1,30 @@
+-- ---------------------------------------------------------------------------
+-- HANDGESCHRIEBEN. Prisma erzeugt hier zusaetzlich Loeschbefehle fuer die
+-- zusammengesetzten Fremdschluessel (Mandantengrenze), die Trigramm-Indizes
+-- (Archivsuche), die partiellen eindeutigen Indizes und die Trigger auf
+-- veroeffentlichten Versionen: es kennt sie nicht, weil sie sich im Schema nicht
+-- ausdruecken lassen. Diese Loeschbefehle sind bewusst gestrichen.
+--
+-- tests/datenbankregeln.test.ts prueft, dass alle diese Objekte vorhanden sind –
+-- ein versehentlich stehengelassener Loeschbefehl faellt dort sofort auf.
+-- ---------------------------------------------------------------------------
+
+-- Abteilungsspezifische Zusatzabschnitte (#031).
+--
+-- Beim Onboarding in der Buchhaltung gehoeren Schritte dazu, die sonst niemand
+-- braucht. Bisher hiess die Wahl: eine Vorlage je Abteilung pflegen, oder
+-- Schritte, die fuer die meisten "nicht zutreffend" sind.
+--
+-- Namen und nicht Kennungen: der Abschnitt gehoert zur Version und muss ein
+-- Umbenennen oder Archivieren einer Abteilung ueberleben.
+ALTER TABLE "VorlagenAbschnitt"
+  ADD COLUMN "nurFuerAbteilungen" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];
+
+-- Welche Abschnitte fuer einen Lauf gelten, beim Start festgeschrieben.
+--
+-- Leer heisst **alle**. Bestehende Laeufe bekommen damit genau ihr bisheriges
+-- Verhalten, ohne Nachfuehrung: sie zeigen weiter jeden Abschnitt ihrer Version.
+-- Festgeschrieben und nicht berechnet, weil ein archivierter Lauf genau die
+-- Schritte zeigen muss, die damals abgearbeitet wurden.
+ALTER TABLE "Lauf"
+  ADD COLUMN "geltendeAbschnitte" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];

prisma/schema.prisma

@@ -464,10 +464,16 @@ model VorlagenVariable {
 }
 
 model VorlagenAbschnitt {
-  id                String  @id @default(cuid())
-  versionId         String
-  titel             String
-  position          Int     @default(0)
+  id                 String   @id @default(cuid())
+  versionId          String
+  titel              String
+  position           Int      @default(0)
+  /// Nur fuer diese Abteilungen (#031). Leer heisst: fuer alle.
+  ///
+  /// **Namen und nicht Kennungen.** Der Abschnitt gehoert zur Version und muss
+  /// ein Umbenennen oder Archivieren einer Abteilung ueberleben, ohne ins Leere
+  /// zu zeigen — dieselbe Entscheidung wie bei `Mitarbeiter.abteilung`.
+  nurFuerAbteilungen String[] @default([])
   /// Verweis auf einen wiederverwendbaren Baustein (#030).
   ///
   /// In einem **Entwurf** heisst das: beim Veroeffentlichen hier die Schritte des
@@ -475,7 +481,7 @@ model VorlagenAbschnitt {
   /// Feld: diese Schritte stammen von dort — es ist dann nur noch Herkunft.
   /// Welche der beiden Lesarten gilt, sagt der Status der Version; ein zweites
   /// Feld dafuer waere eine zweite Wahrheit.
-  bausteinVersionId String?
+  bausteinVersionId  String?
 
   version         VorlagenVersion   @relation(fields: [versionId], references: [id], onDelete: Cascade)
   bausteinVersion BausteinVersion?  @relation(fields: [bausteinVersionId], references: [id], onDelete: Restrict)
@@ -591,6 +597,14 @@ model Lauf {
   ticket             String?
   /// Werte der VorlagenVariablen, beim Start erfasst.
   variablen          Json       @default("{}")
+  /// Welche Abschnitte fuer diesen Lauf gelten, beim Start festgeschrieben (#031).
+  ///
+  /// **Leer heisst: alle.** So bleiben Laeufe von vor dieser Fassung unberuehrt.
+  /// Festgeschrieben und nicht bei jedem Aufruf aus `abteilungId` berechnet: ein
+  /// archivierter Lauf muss genau die Schritte zeigen, die damals abgearbeitet
+  /// wurden, und ein spaeterer Abteilungswechsel darf keinen Schritt entfernen,
+  /// an dem schon eine Notiz haengt.
+  geltendeAbschnitte String[]   @default([])
   status             LaufStatus @default(OFFEN)
   zugewiesenAnId     String?
   faelligAm          DateTime?