Files
AfiS-Aktensystem/docs/01-produkt.md
T
HarlekinandClaude Opus 5 1d637bc85e Abteilungen als Ebene über der Personalakte
Punkt 3 der Wünsche.

Die Abteilung stand als Freitext in der Personalakte. Damit liess sich nichts
fragen: „SHD", „Shd" und „Sicherheitsdienst" waren drei Abteilungen. Sie ist
jetzt ein eigenes Modell, im Adminbereich verwaltbar, und die drei vorhandenen
Freitexte sind in der Migration zu Abteilungen geworden.

**Eine Fallakte trägt keine Abteilung.** Sie gehört zu einer, wenn eine
beteiligte Person ihr angehört — abgeleitet über CaseParticipant und die
Personalakte. Eine eingetragene Zuordnung wäre nach zwei Wochen falsch: Leute
wechseln, Beteiligte kommen dazu, und niemand pflegt das nach. Dasselbe gilt
für die Dokumente: ein Dokument unmittelbar an der Abteilung wäre halb
verdrahtet, weil die Vorlagen über TemplateUse nur Fall- und Personalakte
kennen.

Die Abteilungsseite zeigt Mitglieder, abgeleitete Fälle und Dokumente,
Vermerke, Chat und ein Kreisdiagramm der Fallarten; die Übersicht eines über
alle Abteilungen. Das Diagramm ist serverseitig gerendertes SVG — eine
Bibliothek wäre das Teuerste auf der Seite gewesen. Die Segmente sind
Abstufungen von --steel und nicht die Stufenfarben: ein Tortenstück in Oxidrot
würde als „streng geheim" gelesen.

Die Zusammenfassung ist die gefährliche Stelle. Eine Abteilungsseite fasst
zusammen, was einzeln längst geschützt ist, und eine Zusammenfassung, die nicht
filtert, verrät mehr als jede Einzelansicht. Deshalb läuft hier jede Liste und
jede Zahl durch dieselben Fragmente wie überall; ein Test prüft, dass die Summe
der Diagrammanteile mit der Länge der Liste übereinstimmt. Wo jemand
Personalakten gar nicht sehen darf, steht null und keine Null.

Vermerke erben Regel 2 unverändert: kein DELETE, Version bei jeder Änderung,
Grabstein bei jeder Zurücknahme, als Regel und Trigger in der Datenbank. Ohne
Korrekturkette, Anhänge und Karenzzeit — was Beweiswert hat, gehört in eine
Fallakte.

Nebenbei: das Zugriffsprotokoll hängt jetzt am dafür vorgesehenen Recht
audit.read statt an admin.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-03 19:57:28 +02:00

3.5 KiB

Produkt und Domäne

Kontext

Die AfiS ist im Rollenspiel die interne Ermittlungsbehörde einer SCP-Foundation-Einrichtung. Sie untersucht Korruption, Dienstvergehen und Sicherheitsvorfälle bei eigenem Personal. Bisher organisiert sie sich über ein Discord-Forum, was für verknüpfte Akten und abgestufte Sichtbarkeit nicht taugt.

Das System ersetzt das Forum, nicht Discord selbst. Discord bleibt der Ort für Identität, Rollen und Benachrichtigungen.

Nutzergruppen

Gruppe Typisches Verhalten Wichtigste Ansicht
Ermittler Legt Fälle an, schreibt Vermerke, lädt Belege hoch Fallakte, eigene Fälle
Abteilungsleiter Prüft, schließt Fälle ab, vergibt Rechte, exportiert Dashboard, Rollenverwaltung
Beobachter mit niedriger Stufe Liest mit, kommentiert im Chat Fallliste, Chat
Administrator (du) Betrieb, Vorlagen, Notfallzugriff Adminbereich

Der Abteilungsleiter ist ausdrücklich nicht technisch. Alles, was er regelmäßig braucht, muss über die Oberfläche gehen. Keine Konfigurationsdateien, keine Datenbankeingriffe.

Glossar

Verbindliche Zuordnung zwischen Fachbegriff und Code-Bezeichner.

Deutsch (UI) Code Bedeutung
Fallakte Case Eine Ermittlung
Aktenzeichen caseNumber AfiS-<Jahr>-<4-stellig>, z. B. AfiS-2026-0042
Abschnitt CaseSection Aus der Vorlage erzeugtes, versioniertes Feld
Vermerk / Verlaufseintrag CaseEntry Chronologischer Eintrag, nur anhängend
Verlauf timeline Die Folge aller CaseEntry
Vorlage CaseTemplate Definiert Abschnitte einer Fallart
Fallart caseType Korruptionsverdacht, Dienstvergehen, Sicherheitsvorfall, Routineprüfung
Freigabestufe clearanceLevel 0 bis 5
Klassifizierung classification Die Stufe eines Objekts
Schwärzung Redaction Für niedrigere Stufen unkenntlicher Bereich
Personalakte PersonnelFile Akte zu einer Person
Beteiligter CaseParticipant Ermittler, Zeuge, Betroffener, Täter oder Mittäter eines Falls
Abteilung Department Organisationseinheit, der Personen angehören; ihre Fälle ergeben sich aus den Mitgliedern
Aktenchat CaseChat Informelle Nachrichten zu einer Akte
Wiedervorlage dueAt Termin, zu dem der Fall wieder anzufassen ist
Zugriffsprotokoll AuditLog Wer hat wann was gelesen oder geändert

Freigabestufen

Die Bezeichnungen entsprechen den Zugangsrollen auf dem Discord-Server und bleiben deshalb englisch. Stufe 0 hat keine eigene Zugangsrolle, sie gilt für jedes AfiS-Mitglied ohne eine solche Rolle.

Stufe Bezeichnung Zugangsrolle Existenz für niedrigere Stufen
0 Unclassified — sichtbar
1 Restricted Access Restricted Access sichtbar
2 Confidential Access Confidential Access sichtbar, Inhalt gesperrt
3 Sensitive Access Sensitive Access unsichtbar
4 Critical Operations Critical Operations unsichtbar
5 Executive Oversight Executive Oversight unsichtbar

Die Spalte ganz rechts ist konfigurierbar (ClearanceLevelConfig.hiddenBelow), ebenso die Bezeichnung. Die Werte oben sind der Auslieferungszustand, den pnpm db:seed herstellt.

Nicht im Umfang

  • Keine öffentliche Registrierung, kein Passwort-Login, keine E-Mail-Zustellung
  • Kein mobiles Nativ-App-Ziel, aber die Weboberfläche muss auf dem Handy gut lesbar sein
  • Keine Echtzeit-Zusammenarbeit im selben Textfeld (nur Konflikterkennung)
  • Keine Volltextsuche in Anhängen (OCR) in Version 1