Protokoll im Adminbereich, ein Knopf für das ganze Blatt

Die restlichen zwei Änderungswünsche.

**Protokoll.** „Wer was wo macht" stand seit dem ersten Tag in AuditLog —
harte Regel 3 sorgt dafür. Was fehlte, war die Ansicht darauf. /admin/protokoll
ist genau das und keine zweite Aufzeichnung: filterbar nach Person, Aktion,
Art und Zeitraum, rückwärts blätternd.

Nur für die Leitung. Eine Zeile nennt Aktenzeichen und Namen, und schon die
Existenz einer Zeile verrät, dass es einen Vorgang gibt; ein gefiltertes
Protokoll für alle wäre ein Weg, die Sichtbarkeitsregeln von hinten
aufzurollen. Aus demselben Grund werden Kennungen ohne Sichtbarkeitsfilter zu
Aktenzeichen aufgelöst — ein Protokoll aus UUIDs liest niemand, und eines, das
niemand liest, ist keine Kontrolle.

**Speichern.** Jedes Feld trug seinen eigenen Knopf: ein Arbeitsvertrag mit
zwölf Feldern hiess zwölfmal speichern. Der Knopf steht jetzt am Blatt.

Geschrieben wird trotzdem je Feld und nicht als Transaktion, und das folgt aus
dem Datenmodell: Abschnitte sind einzeln versioniert, weil mehrere Leute
gleichzeitig an einer Akte arbeiten. Als Transaktion blockierte ein einziges
zwischenzeitlich geändertes Feld das ganze Blatt — elf gute Änderungen verloren,
weil jemand das zwölfte angefasst hat. So geht durch, was durchgeht, und die
Rückmeldung sagt, was offen blieb und wo. Lichtbilder bleiben ausgenommen: ein
Upload mit Prüfkette ist keine Feldänderung.

lib/audit.ts liegt jetzt als lib/audit/write.ts neben lib/audit/query.ts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Harlekin
2026-09-03 15:16:10 +02:00
co-authored by Claude Opus 5
parent ef377f0123
commit 5f9f5d99fb
40 changed files with 1005 additions and 42 deletions
+63 -8
View File
@@ -2,6 +2,7 @@
import { useEffect, useRef, useState, useTransition } from 'react'
import { sectionText } from '@/lib/i18n/cases'
import { useSectionsForm } from './SectionsForm'
import type { SaveSection } from './types'
type Props = {
@@ -31,6 +32,10 @@ const AUTOSAVE_MS = 2000
* Knopfdruck: ein Abschnitt ist der Sachstand der Akte, nicht ein Chatbeitrag.
* Siehe docs/09-performance-und-ux.md.
*
* Der Knopf steht **am Blatt, nicht am Feld**: dieses Feld meldet sich beim
* umgebenden Formular an und wird mit allen anderen zusammen gespeichert. Nur
* wenn kein Formular da ist, trägt es seinen eigenen Knopf.
*
* Beim Speichern geht die geladene Version mit. Weicht sie ab, gibt es kein
* stilles Überschreiben, sondern beide Fassungen nebeneinander.
*/
@@ -44,6 +49,49 @@ export function SectionEditor(props: Props) {
const [draftKept, setDraftKept] = useState(false)
const [pending, startTransition] = useTransition()
const timer = useRef<ReturnType<typeof setTimeout> | null>(null)
const formular = useSectionsForm()
// Was zuletzt gespeichert wurde. Daran hängt, ob dieses Feld beim nächsten
// Speichern überhaupt mitgeschickt wird.
const gespeichert = useRef(normalise(props.initialValue, props.type))
const aktuell = useRef(value)
aktuell.current = value
const stand = useRef(version)
stand.current = version
useEffect(() => {
if (!formular) return
return formular.register({
fieldKey: props.fieldKey,
collect: () =>
aktuell.current === gespeichert.current
? null
: {
fieldKey: props.fieldKey,
value: parse(aktuell.current, props.type),
baseVersion: stand.current,
},
apply: (ergebnis) => {
if (ergebnis.ok) {
gespeichert.current = aktuell.current
setVersion(ergebnis.version)
setConflict(null)
setError(null)
setSaved(true)
setDraftKept(false)
formular.changed(props.fieldKey, false)
try {
localStorage.removeItem(speicherSchluessel)
} catch {
// egal
}
return
}
if (ergebnis.conflict) setConflict(ergebnis.current)
else setError(ergebnis.error)
},
})
}, [formular, props.fieldKey, props.type, speicherSchluessel])
// Entwurf aus dem letzten Besuch übernehmen, falls er neuer ist.
useEffect(() => {
@@ -61,6 +109,7 @@ export function SectionEditor(props: Props) {
function change(next: string) {
setValue(next)
setSaved(false)
formular?.changed(props.fieldKey, next !== gespeichert.current)
if (timer.current) clearTimeout(timer.current)
timer.current = setTimeout(() => {
try {
@@ -82,10 +131,12 @@ export function SectionEditor(props: Props) {
})
if (result.ok) {
gespeichert.current = override === undefined ? value : normalise(override, props.type)
setVersion(result.version)
setConflict(null)
setSaved(true)
setDraftKept(false)
formular?.changed(props.fieldKey, false)
try {
localStorage.removeItem(speicherSchluessel)
} catch {
@@ -139,14 +190,18 @@ export function SectionEditor(props: Props) {
)}
<div className="mt-2 flex flex-wrap items-center gap-3 text-2xs">
<button
type="button"
onClick={() => submit()}
disabled={pending}
className="btn btn-primary"
>
{pending ? sectionText.saving : sectionText.save}
</button>
{/* Ohne umgebendes Formular trägt das Feld seinen eigenen Knopf. */}
{formular ? null : (
<button
type="button"
onClick={() => submit()}
disabled={pending}
aria-busy={pending}
className="btn btn-primary"
>
{pending ? sectionText.saving : sectionText.save}
</button>
)}
{version > 0 ? (
<span className="font-mono text-text-dim">{sectionText.version(version)}</span>
) : null}