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.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

packages/db/prisma/seed.ts

@@ -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.