Phase 4 abgeschlossen: Personalakten, Dokumente, Beteiligte, Verknüpfungen

Die Dokumentebene aus docs/13 ist gebaut, additiv: Document, DocumentSection und DocumentSectionVersion neben Case, CaseSection und CaseEntry. Ein Dokument hängt an einer Fallakte, an einer Personalakte oder an nichts, höchstens an einem — gesichert durch eine CHECK-Bedingung. Es gibt kein DELETE; eine Zurücknahme lässt einen Grabstein stehen, der auch für den Admin zu ist. Eine neue Dokumentart ist damit ein Datensatz, kein Deployment. Im Seed stehen vier: vermerk, vorfallsbericht, sonderarbeitsvertrag (mehrseitiger Vertragstext mit Platzhaltern und Unterschriftenzeilen) und bussgeld. Zwei Umbenennungen, beide von Hand migriert, damit die vorhandenen Zeilen und Zählerstände stehen bleiben: - CaseTemplate -> DocumentTemplate, plus uses[] und layout - CaseCounter -> NumberSeries, ein Nummernkreis je Präfix für Aktenzeichen und Dokumentnummern Die Regeln für Abschnitte stehen jetzt einmal in lib/sections/render.ts und gelten für Fallakten und Dokumente gleichermaßen. Die Frage aus docs/13, ob CaseSection langfristig in die Dokumentebene wandert, ist damit verneint und begründet. Rückverweise auf der Personalakte laufen durch visibleCaseWhere, die Zahl daneben entsteht aus dem gefilterten Ergebnis. Auch die Rollengruppe verschwindet mit, sonst verriete "Betroffener" ohne Eintrag die Ermittlung. Die eigene Personalakte ist keine Ausnahme von der Freigabestufe. Vier neue Rechte: document.create, .edit, .finalize, .retract. Das letzte steht bei den zurückgehaltenen, es greift in Geschriebenes ein. 91 Tests im Web-Paket, 15 in der Datenbank, 28 e2e. Größte Route 118 kB gegen das Budget von 120 kB — die Luft wird knapp.
2026-09-02 14:15:16 +02:00
parent 399988596f
commit db438ac57e
58 changed files with 5121 additions and 210 deletions
@@ -0,0 +1,243 @@
+-- Phase 4: Personalakten, Dokumente, Beteiligte, Verknüpfungen.
+--
+-- Von Hand geschrieben, weil zwei Tabellen **umbenannt** werden. Prisma würde
+-- daraus DROP und CREATE machen und dabei die Vorlagen und die laufenden
+-- Nummernkreise verlieren. Siehe docs/13-entscheidungen.md.
+
+-- ===========================================================================
+-- 1. CaseTemplate -> DocumentTemplate
+--    Eine Vorlage beschreibt jetzt auch Dokumente, nicht nur Fallarten.
+-- ===========================================================================
+
+ALTER TABLE "CaseTemplate" RENAME TO "DocumentTemplate";
+ALTER TABLE "DocumentTemplate" RENAME CONSTRAINT "CaseTemplate_pkey" TO "DocumentTemplate_pkey";
+ALTER INDEX "CaseTemplate_key_version_key"  RENAME TO "DocumentTemplate_key_version_key";
+ALTER INDEX "CaseTemplate_key_isActive_idx" RENAME TO "DocumentTemplate_key_isActive_idx";
+
+CREATE TYPE "TemplateUse"    AS ENUM ('CASE', 'CASE_DOCUMENT', 'PERSON_DOCUMENT', 'STANDALONE');
+CREATE TYPE "DocumentLayout" AS ENUM ('FORM', 'PROSE', 'NOTE');
+CREATE TYPE "DocumentStatus" AS ENUM ('DRAFT', 'FINAL', 'RETRACTED');
+
+ALTER TABLE "DocumentTemplate"
+  ADD COLUMN "uses"   "TemplateUse"[]  NOT NULL DEFAULT ARRAY['CASE']::"TemplateUse"[],
+  ADD COLUMN "layout" "DocumentLayout" NOT NULL DEFAULT 'FORM';
+
+-- ===========================================================================
+-- 2. CaseCounter -> NumberSeries
+--    Aktenzeichen und Dokumentnummern laufen über denselben Zähler, getrennt
+--    durch das Präfix aus der Vorlage. Die bestehenden Stände bleiben stehen.
+-- ===========================================================================
+
+ALTER TABLE "CaseCounter" RENAME TO "NumberSeries";
+ALTER TABLE "NumberSeries" RENAME CONSTRAINT "CaseCounter_pkey" TO "NumberSeries_pkey";
+
+-- ===========================================================================
+-- 3. Personalakte: Herkunft und Freitext im Kopf
+-- ===========================================================================
+
+ALTER TABLE "PersonnelFile"
+  ADD COLUMN "note"        TEXT,
+  ADD COLUMN "createdById" TEXT;
+
+-- ===========================================================================
+-- 4. Verknüpfungen: wer sie gezogen hat
+-- ===========================================================================
+
+ALTER TABLE "CaseLink" ADD COLUMN "createdById" TEXT;
+
+-- ===========================================================================
+-- 5. Dokumente
+-- ===========================================================================
+
+CREATE TABLE "Document" (
+    "id"               TEXT             NOT NULL,
+    "documentNumber"   TEXT             NOT NULL,
+    "title"            TEXT             NOT NULL,
+    "templateId"       TEXT             NOT NULL,
+    "templateKey"      TEXT             NOT NULL,
+    "templateVersion"  INTEGER          NOT NULL,
+    "layout"           "DocumentLayout" NOT NULL DEFAULT 'FORM',
+    "status"           "DocumentStatus" NOT NULL DEFAULT 'DRAFT',
+    "classification"   INTEGER          NOT NULL DEFAULT 1,
+    "caseId"           TEXT,
+    "personnelFileId"  TEXT,
+    "createdById"      TEXT             NOT NULL,
+    "createdAt"        TIMESTAMP(3)     NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt"        TIMESTAMP(3)     NOT NULL,
+    "finalizedAt"      TIMESTAMP(3),
+    "finalizedById"    TEXT,
+    "retractedAt"      TIMESTAMP(3),
+    "retractedById"    TEXT,
+    "retractionReason" TEXT,
+    "searchVector"     tsvector,
+
+    CONSTRAINT "Document_pkey" PRIMARY KEY ("id")
+);
+
+-- Ein Dokument gehört zu höchstens einem Besitzer. Ein Bußgeld steht für sich,
+-- ein Sonderarbeitsvertrag an einer Person, ein Vorfallsbericht an einer Akte.
+-- Beides zugleich wäre eine Aussage über die Sichtbarkeit, die niemand prüfen
+-- könnte: die Prüfung müsste sich für einen der beiden Besitzer entscheiden.
+ALTER TABLE "Document" ADD CONSTRAINT "Document_one_owner"
+  CHECK (("caseId" IS NULL) OR ("personnelFileId" IS NULL));
+
+CREATE UNIQUE INDEX "Document_documentNumber_key"      ON "Document"("documentNumber");
+CREATE INDEX "Document_caseId_createdAt_idx"           ON "Document"("caseId", "createdAt" DESC);
+CREATE INDEX "Document_personnelFileId_createdAt_idx"  ON "Document"("personnelFileId", "createdAt" DESC);
+CREATE INDEX "Document_classification_idx"             ON "Document"("classification");
+CREATE INDEX "Document_templateKey_idx"                ON "Document"("templateKey");
+CREATE INDEX "Document_createdById_idx"                ON "Document"("createdById");
+
+ALTER TABLE "Document" ADD CONSTRAINT "Document_templateId_fkey"
+  FOREIGN KEY ("templateId") REFERENCES "DocumentTemplate"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+ALTER TABLE "Document" ADD CONSTRAINT "Document_caseId_fkey"
+  FOREIGN KEY ("caseId") REFERENCES "Case"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+ALTER TABLE "Document" ADD CONSTRAINT "Document_personnelFileId_fkey"
+  FOREIGN KEY ("personnelFileId") REFERENCES "PersonnelFile"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+CREATE TABLE "DocumentSection" (
+    "id"             TEXT         NOT NULL,
+    "documentId"     TEXT         NOT NULL,
+    "fieldKey"       TEXT         NOT NULL,
+    "minClearance"   INTEGER      NOT NULL DEFAULT 0,
+    "currentVersion" INTEGER      NOT NULL DEFAULT 1,
+    "value"          JSONB        NOT NULL,
+    "updatedAt"      TIMESTAMP(3) NOT NULL,
+    "updatedById"    TEXT         NOT NULL,
+
+    CONSTRAINT "DocumentSection_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "DocumentSection_documentId_fieldKey_key"
+  ON "DocumentSection"("documentId", "fieldKey");
+
+ALTER TABLE "DocumentSection" ADD CONSTRAINT "DocumentSection_documentId_fkey"
+  FOREIGN KEY ("documentId") REFERENCES "Document"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+CREATE TABLE "DocumentSectionVersion" (
+    "id"           TEXT         NOT NULL,
+    "sectionId"    TEXT         NOT NULL,
+    "version"      INTEGER      NOT NULL,
+    "value"        JSONB        NOT NULL,
+    "changeReason" TEXT,
+    "authorId"     TEXT         NOT NULL,
+    "createdAt"    TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "DocumentSectionVersion_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "DocumentSectionVersion_sectionId_version_key"
+  ON "DocumentSectionVersion"("sectionId", "version");
+CREATE INDEX "DocumentSectionVersion_sectionId_version_idx"
+  ON "DocumentSectionVersion"("sectionId", "version" DESC);
+
+ALTER TABLE "DocumentSectionVersion" ADD CONSTRAINT "DocumentSectionVersion_sectionId_fkey"
+  FOREIGN KEY ("sectionId") REFERENCES "DocumentSection"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- ===========================================================================
+-- 6. Dokumente sind anhängend
+--
+--    Dieselbe Zusicherung wie beim Verlaufseintrag: kein DELETE, weder über
+--    die Anwendung noch über rohes SQL. Wer ein Dokument loswerden will, zieht
+--    es zurück; der Grabstein bleibt sichtbar. Siehe CLAUDE.md, harte Regel 2.
+-- ===========================================================================
+
+CREATE RULE document_no_delete         AS ON DELETE TO "Document"               DO INSTEAD NOTHING;
+CREATE RULE document_version_no_delete AS ON DELETE TO "DocumentSectionVersion" DO INSTEAD NOTHING;
+
+-- Die Versionstabelle wird nicht umgeschrieben. Einzige Ausnahme wie beim
+-- Verlaufseintrag: minClearance darf angehoben werden, damit eine
+-- Höherstufung rückwirkend gilt und der alte Text nicht über die Historie
+-- leckt.
+CREATE OR REPLACE FUNCTION document_version_guard() RETURNS trigger AS $$
+BEGIN
+  IF NEW."id"           IS DISTINCT FROM OLD."id"
+  OR NEW."sectionId"    IS DISTINCT FROM OLD."sectionId"
+  OR NEW."version"      IS DISTINCT FROM OLD."version"
+  OR NEW."value"        IS DISTINCT FROM OLD."value"
+  OR NEW."changeReason" IS DISTINCT FROM OLD."changeReason"
+  OR NEW."authorId"     IS DISTINCT FROM OLD."authorId"
+  OR NEW."createdAt"    IS DISTINCT FROM OLD."createdAt" THEN
+    RAISE EXCEPTION 'DocumentSectionVersion ist anhängend';
+  END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER document_version_guard_trg
+  BEFORE UPDATE ON "DocumentSectionVersion"
+  FOR EACH ROW EXECUTE FUNCTION document_version_guard();
+
+-- Herkunft, Vorlage und Besitzer eines Dokuments sind unveränderlich. Ein
+-- Vertrag, der nachträglich an einer anderen Person hängt, wäre eine Fälschung.
+CREATE OR REPLACE FUNCTION document_immutable_guard() RETURNS trigger AS $$
+BEGIN
+  IF NEW."createdById"     IS DISTINCT FROM OLD."createdById"
+  OR NEW."createdAt"       IS DISTINCT FROM OLD."createdAt"
+  OR NEW."caseId"          IS DISTINCT FROM OLD."caseId"
+  OR NEW."personnelFileId" IS DISTINCT FROM OLD."personnelFileId"
+  OR NEW."documentNumber"  IS DISTINCT FROM OLD."documentNumber"
+  OR NEW."templateId"      IS DISTINCT FROM OLD."templateId" THEN
+    RAISE EXCEPTION 'Herkunft, Besitzer und Vorlage eines Document sind unveränderlich';
+  END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER document_immutable_guard_trg
+  BEFORE UPDATE ON "Document"
+  FOR EACH ROW EXECUTE FUNCTION document_immutable_guard();
+
+-- ===========================================================================
+-- 7. Volltextsuche für Dokumente
+--
+--    Wie beim Fall: aufgenommen wird nur, was jeder lesen darf, der das
+--    Dokument überhaupt sehen darf. Felder mit minClearance > 0 bleiben
+--    draußen, sonst verrät die Trefferliste sie an niedrigere Stufen.
+-- ===========================================================================
+
+CREATE OR REPLACE FUNCTION document_search_vector(target_id text) RETURNS tsvector AS $$
+  SELECT
+    setweight(to_tsvector('german',
+      coalesce((SELECT d."documentNumber" || ' ' || d."title" FROM "Document" d WHERE d."id" = target_id), '')
+    ), 'A')
+    ||
+    setweight(coalesce((
+      SELECT jsonb_to_tsvector('german', jsonb_agg(to_jsonb(strip_redactions(s."value" #>> '{}'))), '["string"]')
+      FROM "DocumentSection" s
+      WHERE s."documentId" = target_id AND s."minClearance" = 0
+    ), ''::tsvector), 'B');
+$$ LANGUAGE sql STABLE;
+
+-- Wie bei case_refresh_search_vector: mit IF verzweigt, nicht mit einem
+-- CASE-Ausdruck. Der würde auch im nicht genommenen Zweig verlangen, dass
+-- NEW."documentId" existiert — auf "Document" gibt es das Feld nicht.
+CREATE OR REPLACE FUNCTION document_refresh_search_vector() RETURNS trigger AS $$
+DECLARE
+  target text;
+BEGIN
+  IF TG_TABLE_NAME = 'Document' THEN
+    target := NEW."id";
+  ELSIF TG_OP = 'DELETE' THEN
+    target := OLD."documentId";
+  ELSE
+    target := NEW."documentId";
+  END IF;
+
+  IF target IS NOT NULL THEN
+    UPDATE "Document" SET "searchVector" = document_search_vector(target) WHERE "id" = target;
+  END IF;
+  RETURN NULL;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER document_search_on_document
+  AFTER INSERT OR UPDATE OF "title", "documentNumber" ON "Document"
+  FOR EACH ROW EXECUTE FUNCTION document_refresh_search_vector();
+
+CREATE TRIGGER document_search_on_section
+  AFTER INSERT OR UPDATE OR DELETE ON "DocumentSection"
+  FOR EACH ROW EXECUTE FUNCTION document_refresh_search_vector();
+
+CREATE INDEX document_search_idx       ON "Document" USING GIN ("searchVector");
+CREATE INDEX document_number_trgm_idx  ON "Document" USING GIN ("documentNumber" gin_trgm_ops);
@@ -137,7 +137,11 @@ model Session {
 // Vorlagen
 // ---------------------------------------------------------------------------

-model CaseTemplate {
+/// Eine Vorlage beschreibt einen Bausteinsatz. Sie kann eine **Fallart** sein
+/// (bestimmt die Abschnitte einer Fallakte) oder eine **Dokumentart** (bestimmt
+/// den Aufbau eines Dokuments) oder beides. Was davon gilt, steht in `uses`.
+/// Eine neue Dokumentart ist damit ein Datensatz, kein Deployment.
+model DocumentTemplate {
  id          String   @id @default(uuid(7))
  key         String // "korruptionsverdacht"
  version     Int
@@ -146,6 +150,13 @@ model CaseTemplate {
  isActive    Boolean  @default(true)
  fields      Json // TemplateField[]

+  /// Wofuer die Vorlage verwendet werden darf. Liste statt Einzelwert, weil
+  /// dieselbe Vorlage an mehreren Stellen sinnvoll sein kann.
+  uses TemplateUse[] @default([CASE])
+
+  /// Bestimmt allein das Aussehen, nicht den Zugriff. Siehe docs/08.
+  layout DocumentLayout @default(FORM)
+
  /// Muster des Aktenzeichens, siehe docs/13-entscheidungen.md. Die Abteilung
  /// fuehrt gewachsene Praefixe wie "AKT-PA"; der Nummernkreis laeuft je
  /// Praefix und Jahr, damit zwei Fallarten sich nicht in die Quere kommen.
@@ -154,12 +165,35 @@ model CaseTemplate {
  createdAt   DateTime @default(now())
  createdById String?

-  cases Case[]
+  cases     Case[]
+  documents Document[]

  @@unique([key, version])
  @@index([key, isActive])
 }

+/// Wofuer eine Vorlage taugt.
+enum TemplateUse {
+  /// Fallart: bestimmt die Abschnitte einer Fallakte
+  CASE
+  /// Dokument in einer Fallakte
+  CASE_DOCUMENT
+  /// Dokument an einer Personalakte, etwa ein Sonderarbeitsvertrag
+  PERSON_DOCUMENT
+  /// Dokument ohne Besitzer, etwa ein Bussgeld
+  STANDALONE
+}
+
+/// Bauform des Dokuments, siehe docs/13-entscheidungen.md.
+enum DocumentLayout {
+  /// beschriftete Felder, ausgefuellt — der Vorfallsbericht
+  FORM
+  /// fester Wortlaut mit Platzhaltern, mehrseitig — der Sonderarbeitsvertrag
+  PROSE
+  /// ein einzelnes Freitextfeld, dargestellt wie ein Vermerk
+  NOTE
+}
+
 // ---------------------------------------------------------------------------
 // Fallakten
 // ---------------------------------------------------------------------------
@@ -183,7 +217,7 @@ model Case {
  /// B=Abschnitte, C=Verlaufseintraege.
  searchVector Unsupported("tsvector")?

-  template     CaseTemplate      @relation(fields: [templateId], references: [id])
+  template     DocumentTemplate  @relation(fields: [templateId], references: [id])
  sections     CaseSection[]
  entries      CaseEntry[]
  participants CaseParticipant[]
@@ -193,6 +227,7 @@ model Case {
  watches      Watch[]
  linksFrom    CaseLink[]        @relation("from")
  linksTo      CaseLink[]        @relation("to")
+  documents    Document[]

  @@index([status, updatedAt(sort: Desc)])
  @@index([classification])
@@ -215,9 +250,10 @@ enum CaseStatus {
  SEALED
 }

-/// Kollisionsfreie Vergabe des Aktenzeichens, ein Nummernkreis je Praefix und
-/// Jahr. Hochgezaehlt in derselben Transaktion wie das Anlegen des Falls.
-model CaseCounter {
+/// Kollisionsfreie Vergabe der Geschaeftsnummern, ein Nummernkreis je Praefix
+/// und Jahr. Hochgezaehlt in derselben Transaktion wie das Anlegen. Traegt
+/// Aktenzeichen und Dokumentnummern, das Praefix kommt aus der Vorlage.
+model NumberSeries {
  prefix     String
  year       Int
  lastNumber Int    @default(0)
@@ -378,11 +414,14 @@ model CaseExclusion {
  @@index([userId])
 }

+/// Verknuepfung zweier Akten. Umkehrbar loeschbar, siehe docs/09: kein
+/// Bestaetigungsdialog, sondern ein Rueckgaengig-Hinweis.
 model CaseLink {
-  fromId    String
-  toId      String
-  kind      LinkKind
-  createdAt DateTime @default(now())
+  fromId      String
+  toId        String
+  kind        LinkKind
+  createdById String?
+  createdAt   DateTime @default(now())
  from      Case     @relation("from", fields: [fromId], references: [id], onDelete: Cascade)
  to        Case     @relation("to", fields: [toId], references: [id], onDelete: Cascade)

@@ -410,14 +449,18 @@ model PersonnelFile {
  status         String?
  classification Int     @default(1)
  fields         Json    @default("{}")
+  /// Freitext im Kopf der Akte, etwa "kein Discord-Konto, Aktenlage aus 2025".
+  note           String?

-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
+  createdById String?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt

  searchVector Unsupported("tsvector")?

  user         User?             @relation(fields: [userId], references: [id])
  participants CaseParticipant[]
+  documents    Document[]

  @@index([displayName])
  @@index([userId])
@@ -426,6 +469,102 @@ model PersonnelFile {
  @@index([displayName(ops: raw("gin_trgm_ops"))], map: "personnel_name_trgm_idx", type: Gin)
 }

+// ---------------------------------------------------------------------------
+// Dokumente
+// ---------------------------------------------------------------------------
+
+/// Eine Ausfertigung aus einer Vorlage: Vorfallsbericht, Sonderarbeitsvertrag,
+/// spaeter Bussgeld. Besitzer ist eine Fallakte, eine Personalakte oder nichts.
+/// Hoechstens einer der beiden Fremdschluessel ist gesetzt, gesichert durch
+/// eine CHECK-Bedingung in der Migration.
+///
+/// Anhaengend wie ein Verlaufseintrag: es gibt kein DELETE, eine Zuruecknahme
+/// laesst einen Grabstein stehen. Siehe CLAUDE.md, harte Regel 2.
+model Document {
+  id              String         @id @default(uuid(7))
+  documentNumber  String         @unique // SAV-2026-0007
+  title           String
+  templateId      String
+  templateKey     String
+  templateVersion Int
+  /// Kopie aus der Vorlage: das Aussehen darf sich nicht aendern, wenn jemand
+  /// spaeter die Vorlage umbaut.
+  layout          DocumentLayout @default(FORM)
+  status          DocumentStatus @default(DRAFT)
+  classification  Int            @default(1)
+
+  caseId          String?
+  personnelFileId String?
+
+  createdById   String
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  finalizedAt   DateTime?
+  finalizedById String?
+
+  retractedAt      DateTime?
+  retractedById    String?
+  retractionReason String?
+
+  /// Von einem Trigger gepflegt. Gewichtung A=Nummer/Titel, B=Abschnitte.
+  searchVector Unsupported("tsvector")?
+
+  template      DocumentTemplate  @relation(fields: [templateId], references: [id])
+  case          Case?             @relation(fields: [caseId], references: [id], onDelete: Restrict)
+  personnelFile PersonnelFile?    @relation(fields: [personnelFileId], references: [id], onDelete: Restrict)
+  sections      DocumentSection[]
+
+  @@index([caseId, createdAt(sort: Desc)])
+  @@index([personnelFileId, createdAt(sort: Desc)])
+  @@index([classification])
+  @@index([templateKey])
+  @@index([createdById])
+  // Von Hand in der Migration erzeugt, Prisma muss sie kennen. Siehe Case.
+  @@index([searchVector], map: "document_search_idx", type: Gin)
+  @@index([documentNumber(ops: raw("gin_trgm_ops"))], map: "document_number_trgm_idx", type: Gin)
+}
+
+enum DocumentStatus {
+  /// in Arbeit, aenderbar
+  DRAFT
+  /// ausgefertigt, Aenderungen brauchen ein eigenes Recht
+  FINAL
+  /// zurueckgezogen, bleibt als Grabstein stehen
+  RETRACTED
+}
+
+/// Ein ausgefuelltes Feld eines Dokuments. Dieselben Zusicherungen wie bei
+/// `CaseSection`: versioniert, `minClearance` je Feld, Diff, Protokoll.
+model DocumentSection {
+  id             String   @id @default(uuid(7))
+  documentId     String
+  fieldKey       String
+  minClearance   Int      @default(0)
+  currentVersion Int      @default(1)
+  value          Json
+  updatedAt      DateTime @updatedAt
+  updatedById    String
+
+  document Document                 @relation(fields: [documentId], references: [id], onDelete: Cascade)
+  versions DocumentSectionVersion[]
+
+  @@unique([documentId, fieldKey])
+}
+
+model DocumentSectionVersion {
+  id           String          @id @default(uuid(7))
+  sectionId    String
+  version      Int
+  value        Json
+  changeReason String?
+  authorId     String
+  createdAt    DateTime        @default(now())
+  section      DocumentSection @relation(fields: [sectionId], references: [id], onDelete: Cascade)
+
+  @@unique([sectionId, version])
+  @@index([sectionId, version(sort: Desc)])
+}
+
 // ---------------------------------------------------------------------------
 // Dateien
 // ---------------------------------------------------------------------------
@@ -4,8 +4,8 @@ import { createPrismaClient } from '../src/index.js'
 * Grundzustand der Anwendung. Alles hier ist Konfiguration, ohne die die App
 * nicht sinnvoll läuft, kein Testinhalt.
 *
- * Die vier Startvorlagen stehen hier, weil ohne Vorlage keine Akte angelegt
- * werden kann. Den Vorlagen-Editor und die übrigen Feldtypen baut Phase 3.
+ * Die Startvorlagen stehen hier, weil ohne Vorlage weder eine Akte noch ein
+ * Dokument angelegt werden kann. Geändert werden sie im Vorlagen-Editor.
 */
 const db = createPrismaClient()

@@ -36,13 +36,19 @@ const CLEARANCE_LEVELS = [
 * mit allen Feldtypen baut Phase 3, hier steht nur, was eine Akte zum Laufen
 * braucht.
 */
-const TEMPLATES: {
+type Vorlage = {
  key: string
  name: string
  description: string
+  uses?: ('CASE' | 'CASE_DOCUMENT' | 'PERSON_DOCUMENT' | 'STANDALONE')[]
+  layout?: 'FORM' | 'PROSE' | 'NOTE'
  numberPrefix?: string
  numberPadding?: number
-}[] = [
+  fields?: unknown[]
+}
+
+/** Fallarten: sie bestimmen die Abschnitte einer Fallakte. */
+const TEMPLATES: Vorlage[] = [
  {
    key: 'korruptionsverdacht',
    name: 'Korruptionsverdacht',
@@ -108,6 +114,104 @@ const TEMPLATE_FIELDS = [
  },
 ]

+/**
+ * Dokumentarten. Sie hängen an einer Fallakte, an einer Personalakte oder an
+ * nichts — was davon, steht in `uses`. Eine weitere Art anzulegen ist ein
+ * Datensatz, kein Deployment: der Vorlagen-Editor reicht.
+ * Siehe docs/13-entscheidungen.md.
+ */
+const DOCUMENT_TEMPLATES: Vorlage[] = [
+  {
+    key: 'vermerk',
+    name: 'Vermerk',
+    description: 'Kurze Notiz mit Datum und Verfasser, an einer Akte oder an einer Person',
+    uses: ['CASE_DOCUMENT', 'PERSON_DOCUMENT'],
+    layout: 'NOTE',
+    numberPrefix: 'VM',
+    fields: [{ key: 'text', label: 'Vermerk', type: 'longtext', required: true }],
+  },
+  {
+    key: 'vorfallsbericht',
+    name: 'Vorfallsbericht',
+    description: 'Bericht über einen Vorfall, mit Gefahreneinschätzung und Maßnahmen',
+    uses: ['CASE_DOCUMENT', 'PERSON_DOCUMENT', 'STANDALONE'],
+    layout: 'FORM',
+    numberPrefix: 'VB',
+    fields: TEMPLATE_FIELDS.filter((field) => field.key !== 'bewertung'),
+  },
+  {
+    key: 'sonderarbeitsvertrag',
+    name: 'Sonderarbeitsvertrag',
+    description: 'Vertrag über eine befristete Sondertätigkeit, mehrseitig mit Unterschriften',
+    uses: ['PERSON_DOCUMENT'],
+    layout: 'PROSE',
+    numberPrefix: 'SAV',
+    // Aufbau eines Vertragstexts: feste Bausteine, die Platzhalter ziehen die
+    // Werte der Eingabefelder darüber. Der Wortlaut gehört der Abteilung und
+    // wird im Vorlagen-Editor gepflegt, nicht hier festgeschrieben.
+    fields: [
+      { key: 'vertragspartner', label: 'Vertragspartner', type: 'shorttext', required: true },
+      { key: 'dienstgrad', label: 'Dienstgrad', type: 'shorttext' },
+      { key: 'taetigkeit', label: 'Tätigkeit', type: 'shorttext', required: true },
+      { key: 'beginn', label: 'Beginn', type: 'date', required: true },
+      { key: 'ende', label: 'Ende', type: 'date' },
+      { key: 'verguetung', label: 'Vergütung', type: 'shorttext' },
+      { key: 'ueberschrift', label: 'Überschrift', type: 'heading', text: 'Sonderarbeitsvertrag' },
+      {
+        key: 'praeambel',
+        label: 'Präambel',
+        type: 'paragraph',
+        text:
+          'Zwischen der Abteilung für innere Sicherheit, vertreten durch die Abteilungsleitung, ' +
+          'und {{vertragspartner}} ({{dienstgrad}}) wird der folgende Sonderarbeitsvertrag geschlossen.',
+      },
+      {
+        key: 'paragraph_1',
+        label: '§ 1 Gegenstand',
+        type: 'paragraph',
+        text:
+          '§ 1 Gegenstand\n\nGegenstand dieses Vertrages ist die Tätigkeit als {{taetigkeit}}. ' +
+          'Die Tätigkeit wird ab dem {{beginn}} ausgeübt und endet am {{ende}}.',
+      },
+      {
+        key: 'paragraph_2',
+        label: '§ 2 Vergütung',
+        type: 'paragraph',
+        text: '§ 2 Vergütung\n\nDie Vergütung beträgt {{verguetung}} und wird monatlich abgerechnet.',
+      },
+      {
+        key: 'paragraph_3',
+        label: '§ 3 Verschwiegenheit',
+        type: 'paragraph',
+        text:
+          '§ 3 Verschwiegenheit\n\nDer Vertragspartner verpflichtet sich, über alle im Rahmen ' +
+          'der Tätigkeit bekannt gewordenen Vorgänge Stillschweigen zu bewahren. Die Pflicht ' +
+          'besteht über das Ende des Vertrages hinaus fort.',
+      },
+      { key: 'unterschrift_partner', label: '{{vertragspartner}}', type: 'signature' },
+      { key: 'unterschrift_leitung', label: 'Abteilungsleitung', type: 'signature' },
+    ],
+  },
+  {
+    key: 'bussgeld',
+    name: 'Bußgeldbescheid',
+    description: 'Geldbuße wegen eines Dienstvergehens, an einer Person oder für sich stehend',
+    uses: ['PERSON_DOCUMENT', 'STANDALONE'],
+    layout: 'FORM',
+    numberPrefix: 'BG',
+    fields: [
+      { key: 'betroffener', label: 'Betroffene Person', type: 'shorttext', required: true },
+      { key: 'tatzeitpunkt', label: 'Tatzeitpunkt', type: 'date', required: true },
+      { key: 'tatvorwurf', label: 'Tatvorwurf', type: 'longtext', required: true },
+      { key: 'rechtsgrundlage', label: 'Rechtsgrundlage', type: 'shorttext' },
+      { key: 'betrag', label: 'Betrag', type: 'number', required: true },
+      { key: 'zahlungsfrist', label: 'Zahlungsfrist', type: 'date' },
+      { key: 'rechtsmittel', label: 'Rechtsmittelbelehrung', type: 'longtext' },
+      { key: 'unterschrift', label: 'Abteilungsleitung', type: 'signature' },
+    ],
+  },
+]
+
 async function main(): Promise<void> {
  for (const config of CLEARANCE_LEVELS) {
    await db.clearanceLevelConfig.upsert({
@@ -129,15 +233,22 @@ async function main(): Promise<void> {
  })
  console.log('[seed] Änderungsrichtlinie GRACE_WINDOW, 15 Minuten')

-  for (const template of TEMPLATES) {
-    await db.caseTemplate.upsert({
+  const alle = [...TEMPLATES, ...DOCUMENT_TEMPLATES]
+  for (const template of alle) {
+    const fields = (template.fields ?? TEMPLATE_FIELDS) as object[]
+    const uses = template.uses ?? ['CASE']
+    await db.documentTemplate.upsert({
      where: { key_version: { key: template.key, version: 1 } },
      create: {
-        ...template,
+        key: template.key,
+        name: template.name,
+        description: template.description,
+        uses,
+        layout: template.layout ?? 'FORM',
        numberPrefix: template.numberPrefix ?? 'AfiS',
        numberPadding: template.numberPadding ?? 4,
        version: 1,
-        fields: TEMPLATE_FIELDS,
+        fields,
        isActive: true,
      },
      // Version 1 gehört dem Seed und wird von ihm aktuell gehalten. Ändert
@@ -146,24 +257,26 @@ async function main(): Promise<void> {
      update: {
        name: template.name,
        description: template.description,
-        fields: TEMPLATE_FIELDS,
+        uses,
+        layout: template.layout ?? 'FORM',
+        fields,
      },
    })
  }
-  console.log(`[seed] ${TEMPLATES.length} Startvorlagen`)
+  console.log(`[seed] ${TEMPLATES.length} Fallarten, ${DOCUMENT_TEMPLATES.length} Dokumentarten`)

  // Ein Nummernkreis je Präfix und Jahr. Angelegt wird er beim ersten Fall
  // von selbst; hier steht er nur, damit ein frischer Bestand nachvollziehbar
  // bei null beginnt.
  const year = new Date().getFullYear()
-  for (const prefix of [...new Set(TEMPLATES.map((t) => t.numberPrefix ?? 'AfiS'))]) {
-    await db.caseCounter.upsert({
+  for (const prefix of [...new Set(alle.map((t) => t.numberPrefix ?? 'AfiS'))]) {
+    await db.numberSeries.upsert({
      where: { prefix_year: { prefix, year } },
      create: { prefix, year, lastNumber: 0 },
      update: {},
    })
  }
-  console.log(`[seed] Aktenzeichen-Zähler für ${year}`)
+  console.log(`[seed] Nummernkreise für ${year}`)

  // entry.edit_own, entry.edit_any und entry.retract sind bewusst keiner Rolle
  // zugeordnet. Der Leiter schaltet sie frei, wenn er sie will.