Files
AfiS-Aktensystem/web/app/(app)/faelle/actions.ts
T
HarlekinandClaude Opus 5 68ad0debd3 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>
2026-09-02 19:56:28 +02:00

278 lines
8.7 KiB
TypeScript

'use server'
import { revalidatePath, revalidateTag } from 'next/cache'
import { redirect } from 'next/navigation'
import { z } from 'zod'
import { requireUser } from '@/lib/auth/current'
import { AccessError, addEntry, changeStatus, createCase, reclassify } from '@/lib/cases/service'
import { editEntry, restoreEntry, retractEntry } from '@/lib/cases/entryService'
import { addParticipant, removeParticipant } from '@/lib/cases/participants'
import { linkCases, unlinkCases } from '@/lib/cases/links'
import { LINK_KINDS, PARTICIPANT_ROLES } from '@/lib/cases/terms'
import { de } from '@/lib/i18n/de'
export type ActionResult = { ok: true } | { ok: false; error: string }
function toMessage(error: unknown): string {
if (error instanceof AccessError) {
return de.actionErrors[error.code] ?? de.actionErrors.default!
}
console.error('[faelle] unerwartet', error)
return de.actionErrors.default!
}
const createSchema = z.object({
title: z.string().trim().min(3).max(200),
classification: z.coerce.number().int().min(0).max(5),
templateKey: z.string().min(1),
/** Betroffene Person, gleich beim Anlegen verknüpft. Optional. */
personnelFileId: z.string().max(64).optional(),
})
export type CreateState = { error?: string }
/**
* Wird über `useActionState` aufgerufen, damit Fehler an der Stelle stehen, an
* der sie entstanden sind, und der Knopf einen Wartezustand bekommt.
* Bei Erfolg leitet die Aktion auf die neue Akte weiter.
*/
export async function createCaseAction(
_previous: CreateState,
formData: FormData,
): Promise<CreateState> {
const user = await requireUser()
const parsed = createSchema.safeParse({
title: formData.get('title'),
classification: formData.get('classification'),
templateKey: formData.get('templateKey'),
personnelFileId: formData.get('personnelFileId') || undefined,
})
if (!parsed.success) return { error: de.actionErrors.default! }
let caseNumber: string
try {
const created = await createCase(user.permissions, parsed.data)
caseNumber = created.caseNumber
// Die betroffene Person gleich mitverknüpfen, damit sie nicht in einem
// zweiten Schritt vergessen wird. Scheitert das, steht die Akte trotzdem.
if (parsed.data.personnelFileId) {
await addParticipant(user.permissions, {
caseNumber,
role: 'SUBJECT',
personnelFileId: parsed.data.personnelFileId,
})
}
} catch (error) {
return { error: toMessage(error) }
}
revalidatePath('/faelle')
// redirect wirft, deshalb steht danach nichts mehr.
redirect(`/faelle/${caseNumber}`)
}
const entrySchema = z.object({
id: z.uuid(),
caseNumber: z.string().min(1),
body: z.string().trim().min(1).max(20_000),
minClearance: z.coerce.number().int().min(0).max(5).default(0),
})
export async function addEntryAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = entrySchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await addEntry(user.permissions, parsed.data)
} catch (error) {
return { ok: false, error: toMessage(error) }
}
revalidateTag(`case:${parsed.data.caseNumber}`)
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
return { ok: true }
}
const statusSchema = z.object({
caseNumber: z.string().min(1),
to: z.enum(['DRAFT', 'OPEN', 'DORMANT', 'REVIEW', 'CLOSED', 'ARCHIVED', 'SEALED']),
reason: z.string().trim().optional(),
})
export async function changeStatusAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = statusSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await changeStatus(user.permissions, parsed.data)
} catch (error) {
return { ok: false, error: toMessage(error) }
}
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
revalidatePath('/faelle')
return { ok: true }
}
const reclassifySchema = z.object({
caseNumber: z.string().min(1),
to: z.coerce.number().int().min(0).max(5),
reason: z.string().trim().optional(),
})
export async function reclassifyAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = reclassifySchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await reclassify(user.permissions, parsed.data)
} catch (error) {
return { ok: false, error: toMessage(error) }
}
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
revalidatePath('/faelle')
return { ok: true }
}
const editSchema = z.object({
entryId: z.string().min(1),
caseNumber: z.string().min(1),
body: z.string().trim().min(1).max(20_000),
minClearance: z.coerce.number().int().min(0).max(5).optional(),
changeReason: z.string().trim().optional(),
})
export async function editEntryAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = editSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await editEntry(user.permissions, parsed.data)
} catch (error) {
return { ok: false, error: toMessage(error) }
}
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
return { ok: true }
}
const retractSchema = z.object({
entryId: z.string().min(1),
caseNumber: z.string().min(1),
reason: z.string().trim().min(10),
})
export async function retractEntryAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = retractSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.entry.reasonTooShort }
try {
await retractEntry(user.permissions, parsed.data)
} catch (error) {
return { ok: false, error: toMessage(error) }
}
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
return { ok: true }
}
export async function restoreEntryAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = retractSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.entry.reasonTooShort }
try {
await restoreEntry(user.permissions, parsed.data)
} catch (error) {
return { ok: false, error: toMessage(error) }
}
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
return { ok: true }
}
// ---------------------------------------------------------------------------
// Beteiligte und Verknüpfungen
// ---------------------------------------------------------------------------
const participantSchema = z.object({
caseNumber: z.string().min(1),
role: z.enum(PARTICIPANT_ROLES),
userId: z.string().max(64).optional(),
personnelFileId: z.string().max(64).optional(),
})
export async function addParticipantAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = participantSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors['participant-target']! }
try {
await addParticipant(user.permissions, parsed.data)
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
return { ok: true }
} catch (error) {
return { ok: false, error: toMessage(error) }
}
}
const removeParticipantSchema = z.object({
caseNumber: z.string().min(1),
participantId: z.string().min(1),
})
export async function removeParticipantAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = removeParticipantSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await removeParticipant(user.permissions, parsed.data)
revalidatePath(`/faelle/${parsed.data.caseNumber}`)
return { ok: true }
} catch (error) {
return { ok: false, error: toMessage(error) }
}
}
const linkSchema = z.object({
fromCaseNumber: z.string().min(1),
toCaseNumber: z.string().min(1),
kind: z.enum(LINK_KINDS),
})
export async function linkCasesAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = linkSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await linkCases(user.permissions, parsed.data)
revalidatePath(`/faelle/${parsed.data.fromCaseNumber}`)
return { ok: true }
} catch (error) {
return { ok: false, error: toMessage(error) }
}
}
export async function unlinkCasesAction(input: unknown): Promise<ActionResult> {
const user = await requireUser()
const parsed = linkSchema.safeParse(input)
if (!parsed.success) return { ok: false, error: de.actionErrors.default! }
try {
await unlinkCases(user.permissions, parsed.data)
revalidatePath(`/faelle/${parsed.data.fromCaseNumber}`)
return { ok: true }
} catch (error) {
return { ok: false, error: toMessage(error) }
}
}