Files
AfiS-Aktensystem/web/app/(app)/faelle/actions.ts
T
HarlekinandClaude Opus 5 0a7fd15ab6 Phase 2 abgeschlossen: nachträgliche Änderungen, Grabstein, Richtlinie
Der Kern von harter Regel 2. Jede Änderung an einem Verlaufseintrag schreibt
den vorherigen Stand nach CaseEntryVersion und erhöht die Versionsnummer.
Autor und Entstehungszeit bleiben unangetastet, geprüft gegen die Datenbank.

Die Karenzzeit wird serverseitig aus AppSetting gelesen, nie aus dem Request.
Eine Änderung darin wird versioniert und protokolliert, aber nicht sichtbar
markiert — ein Tippfehler, zwei Minuten später korrigiert, soll die Akte nicht
mit "bearbeitet"-Marken zupflastern. Alles danach ist markiert und verlangt
eine Begründung, ebenso jede Änderung an einem fremden Eintrag.

Die Stelle, an der eine naive Umsetzung leckt, hat einen eigenen Test: wird
minClearance eines Eintrags angehoben, erben alle bestehenden Versionen den
neuen Wert. Sonst liest jemand mit niedrigerer Stufe den ursprünglichen Text
einfach in der Historie.

Zurückziehen setzt einen Grabstein mit Pflichtbegründung, der Text bleibt in
der Datenbank. Rückgängig machen geht und wird wiederum protokolliert.
Systemeinträge sind von jeder Änderung ausgenommen.

Dazu die Änderungsübersicht als Reiter an der Akte — sichtbar für alle, die
die Akte lesen dürfen, nicht nur für die Leitung — und die Adminseite für die
Änderungsrichtlinie.

Zwei Testprobleme dabei behoben: AppSetting ist eine einzige Zeile für die
ganze Anwendung, deshalb laufen die Web-Tests jetzt nacheinander, und die
Testdatenbank startet bei jedem Lauf im Auslieferungszustand. Vorher hing das
Ergebnis davon ab, was der vorige Lauf hinterlassen hatte.

63 Tests, zweimal hintereinander grün. Bündel bei 110,5 kB von 120.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-01 23:11:42 +02:00

184 lines
5.5 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 { 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.case.errors[error.code] ?? de.case.errors.default!
}
console.error('[faelle] unerwartet', error)
return de.case.errors.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),
})
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'),
})
if (!parsed.success) return { error: de.case.errors.default! }
let caseNumber: string
try {
const created = await createCase(user.permissions, parsed.data)
caseNumber = created.caseNumber
} 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.case.errors.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.case.errors.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.case.errors.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.case.errors.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 }
}