Personalakte als Aktenblatt, Status als Etiketten, Verknüpfen von beiden Seiten
Das Formular der Personalabteilung ist übernommen, nicht durch eine Bildschirmansicht ersetzt: schwarzer Rahmen, Kopf mit Kennung und Klassifizierungsbalken, Raster aus fünf Spalten, Unterschriftenzeilen, Fußzeile. Es steht bewusst außerhalb des Design-Systems — es wird gedruckt und muss auf Papier aussehen wie das Blatt daneben. Datengetrieben bleibt es trotzdem. Kein Feld steht im Programm: sheetTitle und sheetSubtitle an der Vorlage, span für die Zellbreite, rows für das Lichtbild, dateKey für das Datum unter einer Unterschrift, slot für den Klassifizierungsbalken. Eine weitere Dokumentart mit layout = DOSSIER braucht keine Zeile Code. Der Balken zeigt die Foundation-Stufe aus der neuen Tabelle FoundationClearance. Sie ist Inhalt, kein Zugriff — was jemand sehen darf, entscheidet weiterhin allein die interne Stufe. Ohne Auswahl bleibt der Balken neutral, statt eine Einstufung zu behaupten. Die Dienstnummer ist entfallen, es gibt sie nicht. Der Status ist zu mehreren Etiketten geworden: "Gekündigt" und "Verhaftet" schließen einander nicht aus. Unbekannte Schlüssel werden verworfen und die Reihenfolge kommt aus der Konfiguration, nicht aus der Eingabe. PersonnelAssignment hängt AfiS-Mitglieder an eine Person — Aktenführung, Ermittler, Ansprechpartner — und ist zugleich der ausnahmsweise Zugang, wie CaseParticipant bei der Fallakte. Betroffen zu sein gibt weiterhin keinen Zugang: das ist eine Eigenschaft der Person, die Zuordnung eine Entscheidung der Abteilung. Fall und Person lassen sich von beiden Seiten verknüpfen und schon beim Anlegen einer Fallakte. Alle drei Wege laufen in addParticipant zusammen. Noch offen: das Lichtbild. Feldtyp und Platz stehen, hochladen kommt mit der Prüfkette in Phase 5 — ein Bild als Data-URL im Abschnittswert verstiesse gegen harte Regel 4. 102 Tests im Web-Paket, davon sechs auf dem gerenderten Blatt selbst. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Harlekin
co-authored by
Claude Opus 5
Claude Opus 5
parent
d65cc95eb2
commit
68ad0debd3
@@ -0,0 +1,134 @@
|
||||
// @vitest-environment node
|
||||
import { describe, expect, it } from 'vitest'
|
||||
import { createElement } from 'react'
|
||||
import { renderToStaticMarkup } from 'react-dom/server'
|
||||
import { Sheet } from '@/components/documents/Sheet'
|
||||
import type { RenderedSection } from '@/lib/sections/render'
|
||||
import type { TemplateField } from '@/lib/templates/fields'
|
||||
|
||||
/**
|
||||
* Das Blatt wirklich rendern, nicht nur seine Vorlage prüfen.
|
||||
*
|
||||
* Es ist ein Formular, das gedruckt weitergereicht wird: dass ein Feld in der
|
||||
* falschen Zelle landet oder der Klassifizierungsbalken grau bleibt, fällt auf
|
||||
* Papier auf und hier vorher.
|
||||
*/
|
||||
|
||||
function abschnitt(
|
||||
field: TemplateField,
|
||||
value: unknown,
|
||||
options: { visible?: boolean; requiredLevel?: number } = {},
|
||||
): RenderedSection {
|
||||
const gemeinsam = {
|
||||
fieldKey: field.key,
|
||||
field,
|
||||
version: 1,
|
||||
updatedAt: null,
|
||||
updatedById: null,
|
||||
}
|
||||
if (options.visible === false) {
|
||||
return {
|
||||
...gemeinsam,
|
||||
visible: false,
|
||||
value: { redacted: true, requiredLevel: options.requiredLevel ?? 4 },
|
||||
}
|
||||
}
|
||||
return { ...gemeinsam, visible: true, value, segments: null }
|
||||
}
|
||||
|
||||
const STUFEN = [
|
||||
{ level: 1, name: 'Vertraulich', colorHex: '#1e3a5f' },
|
||||
{ level: 4, name: 'Streng Geheim', colorHex: '#450a0a' },
|
||||
]
|
||||
|
||||
function blatt(sections: RenderedSection[]): string {
|
||||
return renderToStaticMarkup(
|
||||
createElement(Sheet, {
|
||||
sections,
|
||||
title: 'SCP Foundation',
|
||||
subtitle: 'Personalakte // Personalabteilung',
|
||||
documentNumber: 'PA-2026-0042',
|
||||
issuedAt: new Date('2026-03-14T10:00:00Z'),
|
||||
foundationLevels: STUFEN,
|
||||
footerNote: 'Nur für autorisiertes Personal.',
|
||||
}),
|
||||
)
|
||||
}
|
||||
|
||||
describe('Aktenblatt, gerendert', () => {
|
||||
const felder: TemplateField[] = [
|
||||
{ key: 'foundation_klassifikation', label: 'Klassifikation', type: 'select', slot: 'classbar' },
|
||||
{ key: 'lichtbild', label: 'Lichtbild', type: 'photo', rows: 2 },
|
||||
{ key: 'name', label: 'Name', type: 'shorttext', span: 2 },
|
||||
{ key: 'vorname', label: 'Vorname', type: 'shorttext', span: 2 },
|
||||
{ key: 'alter', label: 'Alter', type: 'shorttext', span: 4 },
|
||||
{ key: 'wissensfreigabe', label: 'Wissensfreigabe', type: 'shorttext', span: 5, emphasis: true },
|
||||
{
|
||||
key: 'standortleiter',
|
||||
label: 'Standortleiter',
|
||||
type: 'signature',
|
||||
span: 5,
|
||||
dateKey: 'standortleiter_datum',
|
||||
},
|
||||
{ key: 'standortleiter_datum', label: 'Datum', type: 'date' },
|
||||
]
|
||||
|
||||
const gefuellt = [
|
||||
abschnitt(felder[0]!, '4'),
|
||||
abschnitt(felder[1]!, null),
|
||||
abschnitt(felder[2]!, 'Vogt'),
|
||||
abschnitt(felder[3]!, 'Marlene'),
|
||||
abschnitt(felder[4]!, '38'),
|
||||
abschnitt(felder[5]!, 'Stufe 3 / Projekt Nachtblende'),
|
||||
abschnitt(felder[6]!, 'M. Rutkowski'),
|
||||
abschnitt(felder[7]!, '14.03.2026'),
|
||||
]
|
||||
|
||||
it('setzt die Werte in das Raster und zeichnet den Balken in der Stufenfarbe', () => {
|
||||
const html = blatt(gefuellt)
|
||||
|
||||
expect(html).toContain('PA-2026-0042')
|
||||
expect(html).toContain('Vogt')
|
||||
expect(html).toContain('Marlene')
|
||||
|
||||
// Der Balken trägt die Farbe und den Namen der gewählten Stufe.
|
||||
expect(html).toContain('#450a0a')
|
||||
expect(html).toContain('Streng Geheim')
|
||||
expect(html).toContain('Level 4')
|
||||
|
||||
// Das Lichtbild spannt über die angegebene Zeilenzahl. React schreibt das
|
||||
// Attribut in gemischter Schreibweise; HTML wertet sie ohnehin nicht.
|
||||
expect(html.toLowerCase()).toContain('rowspan="2"')
|
||||
|
||||
// Die Unterschrift trägt das Datum mit, das Datum hat keine eigene Zelle.
|
||||
expect(html).toContain('M. Rutkowski')
|
||||
// Zweistellig wie auf dem Formular, und nur einmal: das Datum der
|
||||
// Unterschrift hat keine eigene Zelle.
|
||||
expect(html.match(/14\.03\.2026/g)).toHaveLength(2)
|
||||
expect(html).not.toContain('14.3.2026')
|
||||
})
|
||||
|
||||
it('lässt den Balken neutral, wenn keine Klassifikation gesetzt ist', () => {
|
||||
const ohne = [abschnitt(felder[0]!, null), ...gefuellt.slice(1)]
|
||||
const html = blatt(ohne)
|
||||
|
||||
// Kein erfundener Anschein von Einstufung.
|
||||
expect(html).not.toContain('#450a0a')
|
||||
expect(html).toContain('#333333')
|
||||
expect(html).toContain('Ohne Klassifikation')
|
||||
})
|
||||
|
||||
it('zeigt statt eines gesperrten Feldes einen Balken, nie den Wert', () => {
|
||||
const gesperrt = gefuellt.map((section) =>
|
||||
section.fieldKey === 'wissensfreigabe'
|
||||
? abschnitt(felder[5]!, null, { visible: false, requiredLevel: 4 })
|
||||
: section,
|
||||
)
|
||||
const html = blatt(gesperrt)
|
||||
|
||||
expect(html).not.toContain('Nachtblende')
|
||||
expect(html).toContain('redaction')
|
||||
// Die Beschriftung bleibt: dass es das Feld gibt, ist kein Geheimnis.
|
||||
expect(html).toContain('Wissensfreigabe')
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,124 @@
|
||||
// @vitest-environment node
|
||||
import { afterAll, describe, expect, it } from 'vitest'
|
||||
import { db } from '@/lib/db'
|
||||
import { parseTemplateFields } from '@/lib/templates/schema'
|
||||
import { dossierRows, dossierSpan, isInputField } from '@/lib/templates/fields'
|
||||
|
||||
/**
|
||||
* Das Aktenblatt der Personalabteilung.
|
||||
*
|
||||
* Der erste Test ist der wichtigere: `parseTemplateFields` gibt bei einer
|
||||
* ungültigen Vorlage eine **leere Liste** zurück, statt zu werfen. Ein Tippfehler
|
||||
* im Seed würde das Blatt also lautlos leeren, statt aufzufallen.
|
||||
*/
|
||||
const url = process.env.DIRECT_DATABASE_URL ?? process.env.DATABASE_URL
|
||||
const suite = url ? describe : describe.skip
|
||||
|
||||
suite('Vorlage des Aktenblatts', () => {
|
||||
afterAll(async () => {
|
||||
await db.$disconnect()
|
||||
})
|
||||
|
||||
async function felder() {
|
||||
const vorlage = await db.documentTemplate.findFirst({
|
||||
where: { key: 'personalakte', isActive: true },
|
||||
orderBy: { version: 'desc' },
|
||||
select: { fields: true, layout: true, uses: true, sheetTitle: true, sheetSubtitle: true },
|
||||
})
|
||||
expect(vorlage).not.toBeNull()
|
||||
return { vorlage: vorlage!, fields: parseTemplateFields(vorlage!.fields) }
|
||||
}
|
||||
|
||||
it('übersteht die verbindliche Prüfung vollständig', async () => {
|
||||
const { vorlage, fields } = await felder()
|
||||
|
||||
// Kein stilles Leerlaufen: die Zahl muss stimmen, nicht nur "grösser null".
|
||||
expect(fields).toHaveLength(
|
||||
(vorlage.fields as unknown[]).length,
|
||||
)
|
||||
expect(vorlage.layout).toBe('DOSSIER')
|
||||
expect(vorlage.uses).toEqual(['PERSON_DOCUMENT'])
|
||||
expect(vorlage.sheetSubtitle).toBeTruthy()
|
||||
|
||||
// Die Felder, die das Blatt ausmachen.
|
||||
const schluessel = fields.map((f) => f.key)
|
||||
for (const key of [
|
||||
'lichtbild',
|
||||
'name',
|
||||
'vorname',
|
||||
'alter',
|
||||
'geschlecht',
|
||||
'groesse',
|
||||
'abteilung',
|
||||
'dienstgrad',
|
||||
'sicherheitsfreigabe',
|
||||
'wissensfreigabe',
|
||||
'konfession',
|
||||
'adresse',
|
||||
'anmerkungen',
|
||||
'personalarbeiter',
|
||||
'standortleiter',
|
||||
]) {
|
||||
expect(schluessel).toContain(key)
|
||||
}
|
||||
})
|
||||
|
||||
it('ergibt genau das Raster des Formulars', async () => {
|
||||
const { fields } = await felder()
|
||||
const { photo, photoRows, rows } = dossierRows(fields)
|
||||
|
||||
expect(photo?.key).toBe('lichtbild')
|
||||
expect(photoRows).toBe(4)
|
||||
|
||||
// Neben dem Lichtbild vier Zeilen zu je vier Spalten, danach fünf.
|
||||
const struktur = rows.map((row, index) =>
|
||||
row.map((field) => `${field.key}:${dossierSpan(field, index < photoRows)}`),
|
||||
)
|
||||
expect(struktur).toEqual([
|
||||
['name:2', 'vorname:2'],
|
||||
['alter:2', 'geschlecht:2'],
|
||||
['groesse:4'],
|
||||
['abteilung:2', 'dienstgrad:2'],
|
||||
['sicherheitsfreigabe:3', 'wissensfreigabe:2'],
|
||||
['konfession:2', 'adresse:3'],
|
||||
['anmerkungen:5'],
|
||||
['personalarbeiter:3', 'standortleiter:2'],
|
||||
])
|
||||
})
|
||||
|
||||
it('lässt die Datumsfelder der Unterschriften aus dem Raster heraus', async () => {
|
||||
const { fields } = await felder()
|
||||
const { rows } = dossierRows(fields)
|
||||
const imRaster = rows.flat().map((f) => f.key)
|
||||
|
||||
// Sie stehen unter der jeweiligen Unterschrift, nicht in einer eigenen
|
||||
// Zelle — bearbeitbar bleiben sie trotzdem.
|
||||
expect(imRaster).not.toContain('personalarbeiter_datum')
|
||||
expect(imRaster).not.toContain('standortleiter_datum')
|
||||
expect(fields.map((f) => f.key)).toContain('personalarbeiter_datum')
|
||||
})
|
||||
|
||||
it('hält die Klassifikation aus dem Raster heraus, sie gehört in den Balken', async () => {
|
||||
const { fields } = await felder()
|
||||
const { rows } = dossierRows(fields)
|
||||
expect(rows.flat().map((f) => f.key)).not.toContain('foundation_klassifikation')
|
||||
|
||||
const feld = fields.find((f) => f.key === 'foundation_klassifikation')
|
||||
expect(feld && isInputField(feld) && feld.slot).toBe('classbar')
|
||||
})
|
||||
|
||||
it('kennt für jede Klassifikationsstufe eine Farbe', async () => {
|
||||
const { fields } = await felder()
|
||||
const feld = fields.find((f) => f.key === 'foundation_klassifikation')
|
||||
const stufen = await db.foundationClearance.findMany({ orderBy: { level: 'asc' } })
|
||||
|
||||
// Sonst bliebe der Balken bei einer gültigen Auswahl grau.
|
||||
const optionen = feld && isInputField(feld) ? (feld.options ?? []) : []
|
||||
for (const option of optionen) {
|
||||
expect(stufen.map((s) => String(s.level))).toContain(option)
|
||||
}
|
||||
for (const stufe of stufen) {
|
||||
expect(stufe.colorHex).toMatch(/^#[0-9a-f]{6}$/i)
|
||||
}
|
||||
})
|
||||
})
|
||||
@@ -2,7 +2,12 @@
|
||||
import { afterAll, beforeAll, describe, expect, it } from 'vitest'
|
||||
import { createPrismaClient, loadEnvFromRepoRoot, type PrismaClient } from '@afis/db'
|
||||
import { visiblePersonnelWhere } from '@/lib/access/personnelFilter'
|
||||
import { loadBacklinks } from '@/lib/personnel/service'
|
||||
import {
|
||||
addAssignment,
|
||||
createPersonnelFile,
|
||||
loadBacklinks,
|
||||
updatePersonnelFile,
|
||||
} from '@/lib/personnel/service'
|
||||
import type { EffectivePermissions, Permission } from '@/lib/auth/permissions'
|
||||
|
||||
/**
|
||||
@@ -160,6 +165,76 @@ suite('Personalakten und Rückverweise', () => {
|
||||
expect(anzahl).toBe(1)
|
||||
})
|
||||
|
||||
it('nimmt nur Status-Etiketten an, die es wirklich gibt', async () => {
|
||||
const leitung = perms(nutzer.stufe3, 3, { permissions: ['personnel.edit'] })
|
||||
const akte = await createPersonnelFile(leitung, {
|
||||
displayName: `${marke} Etikettentest`,
|
||||
classification: 1,
|
||||
// "erfunden" steht in keiner Konfiguration und darf nicht durchrutschen,
|
||||
// sonst wäre die Liste im Adminbereich nur eine Empfehlung.
|
||||
statusTags: ['tot', 'erfunden', 'verhaftet'],
|
||||
})
|
||||
|
||||
const gespeichert = await db.personnelFile.findUniqueOrThrow({
|
||||
where: { id: akte.id },
|
||||
select: { statusTags: true },
|
||||
})
|
||||
expect(gespeichert.statusTags).toEqual(['verhaftet', 'tot'])
|
||||
|
||||
// Und die Reihenfolge kommt aus der Konfiguration, nicht aus der Eingabe:
|
||||
// auf jeder Akte steht dieselbe Abfolge.
|
||||
await updatePersonnelFile(leitung, akte.id, { statusTags: ['tot', 'verhaftet'] })
|
||||
const danach = await db.personnelFile.findUniqueOrThrow({
|
||||
where: { id: akte.id },
|
||||
select: { statusTags: true },
|
||||
})
|
||||
expect(danach.statusTags).toEqual(['verhaftet', 'tot'])
|
||||
})
|
||||
|
||||
it('lässt ein zugeordnetes Mitglied auch über seiner Stufe lesen', async () => {
|
||||
const p = perms(nutzer.stufe1, 1)
|
||||
|
||||
// Vorher: die Akte der Stufe 4 ist für ihn nicht da.
|
||||
expect(
|
||||
await db.personnelFile.findMany({
|
||||
where: { AND: [visiblePersonnelWhere(p), { id: hoheAkteId }] },
|
||||
select: { id: true },
|
||||
}),
|
||||
).toHaveLength(0)
|
||||
|
||||
await addAssignment(perms(nutzer.stufe3, 3, { isAdmin: true }), {
|
||||
personnelFileId: hoheAkteId,
|
||||
userId: nutzer.stufe1,
|
||||
role: 'INVESTIGATOR',
|
||||
})
|
||||
|
||||
// Danach schon — das ist der ausnahmsweise Zugang, wie bei der Fallakte.
|
||||
expect(
|
||||
await db.personnelFile.findMany({
|
||||
where: { AND: [visiblePersonnelWhere(p), { id: hoheAkteId }] },
|
||||
select: { id: true },
|
||||
}),
|
||||
).toHaveLength(1)
|
||||
})
|
||||
|
||||
it('gibt der betroffenen Person selbst keinen Zugriff auf ihre Akte', async () => {
|
||||
const eigene = await db.personnelFile.create({
|
||||
data: {
|
||||
displayName: `${marke} Eigene`,
|
||||
userId: nutzer.betroffen,
|
||||
classification: 4,
|
||||
},
|
||||
})
|
||||
|
||||
// Eine Beurteilung auf Stufe 4 über einen Mitarbeiter der Stufe 1 wäre
|
||||
// sonst genau für den einen Menschen lesbar, vor dem sie schützt.
|
||||
const treffer = await db.personnelFile.findMany({
|
||||
where: { AND: [visiblePersonnelWhere(perms(nutzer.betroffen, 1)), { id: eigene.id }] },
|
||||
select: { id: true },
|
||||
})
|
||||
expect(treffer).toHaveLength(0)
|
||||
})
|
||||
|
||||
it('gibt dem Admin die verborgene Personalakte', async () => {
|
||||
const treffer = await db.personnelFile.findMany({
|
||||
where: {
|
||||
|
||||
Reference in New Issue
Block a user