Statuswechsel als Karte statt als wandernde Auswahlliste
Prüfung / Lint, Typen, Tests (push) Canceled after 0s
Prüfung / Images bauen (pdf) (push) Canceled after 0s
Prüfung / Images bauen (web) (push) Canceled after 0s
Prüfung / Images bauen (worker) (push) Canceled after 0s
Images / bauen (pdf, docker/pdf.Dockerfile) (push) Canceled after 0s
Images / bauen (web, docker/web.Dockerfile) (push) Canceled after 0s
Images / bauen (worker, docker/worker.Dockerfile) (push) Canceled after 0s

Das Auswahlfeld enthielt nur die gerade erreichbaren Zustaende. Damit sah
man weder, wo die Akte steht, noch welche Zustaende es ueberhaupt gibt - und
nach jedem Wechsel standen andere Eintraege darin. Eine Auswahl, die ihre
Eintraege tauscht, ist keine Orientierung.

Jetzt stehen immer alle sieben da, in der Reihenfolge des Lebenszyklus:
Entwurf, Offen, In Pruefung, Abgeschlossen, Archiviert als eine Linie,
darunter Ruhend und Versiegelt als Nebenwege. Der jetzige Zustand ist
markiert, erreichbare sind Knoepfe, gesperrte bleiben blass stehen statt zu
verschwinden - mit dem Grund als Titel daran.

Der Grund ist dabei nicht dasselbe wie die Sperre: "von hier fuehrt kein
Weg dorthin" laesst sich durch kein Recht beheben, "dir fehlt case.close"
schon. Wer das verwechselt, sucht an der falschen Stelle.

Was ein Wechsel verlangt, steht jetzt vorher da statt als Absage danach:
die Pflichtbegruendung beim Wiedereroeffnen und beim Versiegeln, und dass
vor dem Abschluss die noetigen Abschnitte gefuellt sein muessen. Bei
Pflichtbegruendung bleibt der Knopf gesperrt, bis sie dasteht.

Die Rechtepruefung rechnet der Server, mit derselben Funktion, die der
Dienst beim Wechsel anwendet - vorher zeigte die Liste auch Ziele, die
danach abgelehnt wurden. Zwei Pruefungen halten das fest, und zwar in beide
Richtungen: nichts angeboten, was scheitern wuerde, und nichts verschwiegen,
was ginge. Die zweite ist die wichtigere, weil ihr Fehlen nicht auffaellt.
This commit is contained in:
Harlekin
2026-09-04 16:26:29 +02:00
parent 42dbf0f6b1
commit bd750f26d0
6 changed files with 496 additions and 57 deletions
+96 -1
View File
@@ -1,4 +1,5 @@
import type { Permission } from '@/lib/auth/permissions'
import type { EffectivePermissions, Permission } from '@/lib/auth/permissions'
import { canEditCase } from '@/lib/access/caseWrite'
/**
* Lebenszyklus einer Akte, siehe docs/05-akten-und-vorlagen.md.
@@ -59,3 +60,97 @@ export function allowedTargets(from: CaseStatusName): CaseStatusName[] {
if (from !== 'SEALED') targets.push('SEALED')
return targets
}
/**
* Der Hauptweg einer Akte, in der Reihenfolge, in der sie ihn geht.
*
* Steht hier und nicht in der Oberflaeche, damit die Darstellung dieselbe
* Ordnung benutzt wie der Lebenszyklus - und nicht irgendeine.
*/
export const LIFECYCLE_MAIN: readonly CaseStatusName[] = [
'DRAFT',
'OPEN',
'REVIEW',
'CLOSED',
'ARCHIVED',
]
/** Was neben dem Hauptweg liegt: eine Pause und die Versiegelung. */
export const LIFECYCLE_SIDE: readonly CaseStatusName[] = ['DORMANT', 'SEALED']
/** Warum ein Zustand gerade nicht angesteuert werden kann. */
export type StatusBlock =
| { kind: 'current' }
/** Vom jetzigen Zustand fuehrt kein Weg dorthin. */
| { kind: 'unreachable' }
/** Der Weg gaebe es, aber das Recht fehlt. */
| { kind: 'no-permission'; permission: Permission }
/** Die Akte ist schreibgeschuetzt oder abgeschlossen. */
| { kind: 'locked'; reason: string }
export type StatusOption = {
status: CaseStatusName
/** Anklickbar? Nur dann fuehrt der Server den Wechsel auch aus. */
available: boolean
block: StatusBlock | null
requiresReason: boolean
requiresCompleteSections: boolean
}
/**
* Zu **jedem** Zustand die Auskunft, ob er von hier aus erreichbar ist.
*
* Bewusst ueber alle sieben und nicht nur ueber die erreichbaren: eine Auswahl,
* die je nach Zustand andere Eintraege hat, laesst sich nicht lesen - man sieht
* nie, wo man steht und was es sonst noch gibt. Die Oberflaeche zeigt deshalb
* immer dieselbe Karte und schaltet nur, was gerade geht.
*
* Die Rechtepruefung steht hier und nicht im Browser. Sie ist dieselbe, die der
* Dienst beim Wechsel anwendet - ein Knopf, der zu einer Absage fuehrt, ist
* schlimmer als keiner.
*/
export function statusOptions(
p: EffectivePermissions,
target: { status: string; classification: number },
): StatusOption[] {
const von = target.status as CaseStatusName
const alle = [...LIFECYCLE_MAIN, ...LIFECYCLE_SIDE]
return alle.map((status) => {
if (status === von) {
return {
status,
available: false,
block: { kind: 'current' } as StatusBlock,
requiresReason: false,
requiresCompleteSections: false,
}
}
const uebergang = findTransition(von, status)
if (!uebergang) {
return {
status,
available: false,
block: { kind: 'unreachable' } as StatusBlock,
requiresReason: false,
requiresCompleteSections: false,
}
}
const erlaubt = canEditCase(p, target, uebergang.permission)
const block: StatusBlock | null = erlaubt.ok
? null
: erlaubt.reason === 'no-permission'
? { kind: 'no-permission', permission: erlaubt.permission }
: { kind: 'locked', reason: erlaubt.reason }
return {
status,
available: erlaubt.ok,
block,
requiresReason: uebergang.requiresReason ?? false,
requiresCompleteSections: uebergang.requiresCompleteSections ?? false,
}
})
}
+18
View File
@@ -23,6 +23,24 @@ export const caseText = {
dueAtConfirm: (datum: string) => `Wiedervorlage auf ${datum} setzen?`,
dueAtClearConfirm: 'Wiedervorlage entfernen?',
statusChangeHint: 'Welcher Zustand von hier aus erreichbar ist, gibt der Lebenszyklus vor.',
statusMap: 'Lebenszyklus',
statusNow: 'jetzt',
statusSide: 'Nebenwege',
statusPick: 'Ziel wählen',
statusTo: (name: string) => `Wechsel nach ${name}`,
statusGo: 'Wechseln',
statusBlocked: {
current: 'Hier steht die Akte gerade.',
unreachable: 'Von hier aus nicht erreichbar.',
locked: 'Die Akte ist in diesem Zustand schreibgeschützt.',
closed: 'Abgeschlossene Akten zu ändern braucht ein eigenes Recht.',
} as Record<string, string>,
statusNoPermission: (recht: string) => `Dafür fehlt dir das Recht ${recht}.`,
statusReasonRequired: 'Begründung ist hier Pflicht, mindestens 10 Zeichen.',
statusNeedsComplete:
'Erst wenn alle für den Abschluss nötigen Abschnitte gefüllt sind.',
statusNothingPossible:
'Von hier aus ist gerade kein Wechsel möglich - weder durch den Lebenszyklus noch mit deinen Rechten.',
outcome: 'Ergebnis',
createdBy: 'Angelegt von',
createdAt: 'Angelegt am',