Export ohne Vier-Augen, Wiedervorlage setzbar, Druckansicht mit Weg zurück

**Export.** Das Vier-Augen-Verfahren ab Stufe 3 ist weg. Wer exportiert,
entscheidet jetzt allein die Freigabestufe: mindestens die des Ziels. Das ist
strenger als das Lesen - wer als Beteiligter ausnahmsweise in eine höher
eingestufte Akte darf, darf sie deshalb noch nicht ausser Haus geben.

Dabei fiel eine Lücke auf: hängte man sich an einen laufenden Auftrag,
entstand kein Protokolleintrag. „Jeder Export wird protokolliert" heisst jeder
Abruf, nicht jeder Rendervorgang - wer dieselbe Datei bekommt, muss genauso
darin stehen.

**Fristen.** dueAt wurde überall gelesen - Übersicht, Suchfilter, Ausdruck -
und nirgends gesetzt. Es gab keine Stelle, an der man ein Datum einträgt,
deshalb stand unter „Fristen" immer „Nichts steht an". Jetzt im Kopf der Akte,
mit Protokolleintrag und ohne Verlaufseintrag: eine Wiedervorlage ist eine
Merkhilfe, keine Aussage über den Fall.

**Statuswechsel.** Aus einem Entwurf führt laut Lebenszyklus nur „Offen"
heraus, deshalb standen dort nie mehr als zwei Ziele. Das sah aus wie ein
Fehler und war keiner - jetzt steht die Erklärung daneben und an jeder Option.

**Druckansicht.** Sie hatte kein eigenes Layout: das weisse Blatt lag auf dem
dunklen Thema und es gab keinen Weg zurück. Jetzt heller Grund, eine Leiste
mit Zurück und Drucken, beides beim Drucken ausgeblendet. Das Ziel wird aus
dem Pfad abgeleitet, damit es auch beim direkten Aufruf stimmt.

**Abteilungsstatistik.** Eine Abteilung ohne Freigabe wird als „Ohne Freigabe"
geführt statt weggelassen - sonst summierten sich die Anteile nicht auf die
Zahl daneben. Mehrere ergeben ein Stück, sonst stünde dort, wie viele es sind.

Dazu: Dienstgrad in eckigen Klammern vor dem Namen und in dessen Grösse, in
einer eigenen Spalte; Knopfform für „Personalakte anlegen"; die abgeschnittene
Anzahl im Kopf der Personalaktenliste; „Zuletzt geöffnet" ohne die zwei
Hinweistexte, leer als Zeichen statt als Satz.
This commit is contained in:
Harlekin
2026-09-04 00:14:07 +02:00
parent e21e478fd1
commit 18c9a71fda
25 changed files with 396 additions and 376 deletions
+32 -94
View File
@@ -1,7 +1,7 @@
import { writeFile } from 'node:fs/promises'
import { db } from '@/lib/db'
import { getEnv } from '@/lib/env'
import { writeAudit, READ_AUDIT_FROM_LEVEL } from '@/lib/audit/write'
import { writeAudit } from '@/lib/audit/write'
import { AccessError } from '@/lib/errors'
import { loadVisibleCase } from '@/lib/cases/service'
import { loadVisibleDocument } from '@/lib/documents/service'
@@ -21,13 +21,18 @@ import type { EffectivePermissions } from '@/lib/auth/permissions'
* mit Vermerk — nicht weggelassen, sonst merkt der Empfänger nicht, dass
* er eine gekürzte Fassung hat.
* 2. **Wasserzeichen** auf jeder Seite: Name, Zeitstempel, Stufe.
* 3. **Jeder Export wird protokolliert**, und ab Stufe 3 braucht er die
* Freigabe durch ein zweites Augenpaar.
* 3. **Jeder Export wird protokolliert**, ausnahmslos und mit Stufe,
* Zeitpunkt und Anlass.
*
* Wer exportieren darf, entscheidet allein die Freigabestufe: **mindestens die
* des Ziels.** Das ist strenger als das Lesen — wer als Beteiligter
* ausnahmsweise in eine höher eingestufte Akte darf, darf sie deshalb noch
* nicht ausser Haus geben. Und es ist einfacher als das frühere
* Vier-Augen-Verfahren, das ab Stufe 3 eine zweite Unterschrift verlangte:
* das hielt die Arbeit auf und ersetzte keine Kontrolle, die das Protokoll
* nicht ohnehin leistet. Siehe docs/13-entscheidungen.md.
*/
/** Ab dieser Klassifizierung braucht ein Export eine zweite Unterschrift. */
export const APPROVAL_FROM_LEVEL = READ_AUDIT_FROM_LEVEL
export type ExportTarget =
| { kind: 'CASE'; caseNumber: string }
| { kind: 'DOCUMENT'; documentNumber: string }
@@ -42,6 +47,12 @@ export async function requestExport(
): Promise<{ jobId: string; status: string }> {
const ziel = await aufloesen(p, target)
// Lesen darf man eine Akte auch als Beteiligter unterhalb ihrer Stufe.
// Ausser Haus geben nicht.
if (!p.isAdmin && p.clearanceLevel < ziel.classification) {
throw new AccessError('clearance-too-low')
}
const cacheKey = exportCacheKey({
kind: target.kind,
targetId: ziel.id,
@@ -60,14 +71,23 @@ export async function requestExport(
return { jobId: fertig.id, status: 'READY' }
}
// Läuft schon einer für denselben Stand? Dann daran hängen.
// Läuft schon einer für denselben Stand? Dann daran hängen — aber der
// Protokolleintrag entsteht trotzdem. „Jeder Export wird protokolliert"
// heisst jeder Abruf, nicht jeder Rendervorgang: wer sich an einen fremden
// Auftrag hängt, bekommt dieselbe Datei und muss genauso darin stehen.
const laufend = await db.exportJob.findFirst({
where: { cacheKey, status: { in: ['QUEUED', 'RUNNING', 'PENDING_APPROVAL'] } },
where: { cacheKey, status: { in: ['QUEUED', 'RUNNING'] } },
select: { id: true, status: true },
})
if (laufend) return { jobId: laufend.id, status: laufend.status }
const brauchtFreigabe = ziel.classification >= APPROVAL_FROM_LEVEL
if (laufend) {
await protokolliere(p, 'export.pdf', ziel.id, {
joined: true,
kind: target.kind,
label: ziel.label,
classification: ziel.classification,
})
return { jobId: laufend.id, status: laufend.status }
}
const auftrag = await db.$transaction(async (tx) => {
const angelegt = await tx.exportJob.create({
@@ -77,7 +97,7 @@ export async function requestExport(
requestedById: p.userId,
clearanceAtTime: p.clearanceLevel,
cacheKey,
status: brauchtFreigabe ? 'PENDING_APPROVAL' : 'QUEUED',
status: 'QUEUED',
},
select: { id: true, status: true },
})
@@ -92,7 +112,6 @@ export async function requestExport(
jobId: angelegt.id,
label: ziel.label,
classification: ziel.classification,
needsApproval: brauchtFreigabe,
},
})
@@ -132,70 +151,7 @@ async function aufloesen(p: EffectivePermissions, target: ExportTarget) {
}
}
/**
* Freigabe durch ein zweites Augenpaar.
*
* **Nicht durch den Anfragenden selbst** — sonst wäre es keins. Das ist der
* einzige Grund, warum es die Prüfung überhaupt gibt.
*/
export async function approveExport(
p: EffectivePermissions,
jobId: string,
): Promise<void> {
if (!p.isAdmin && !p.permissions.has('export.approve')) {
throw new AccessError('no-permission')
}
const auftrag = await db.exportJob.findUnique({
where: { id: jobId },
select: { id: true, status: true, requestedById: true, targetId: true, kind: true },
})
if (!auftrag) throw new AccessError('not-found')
if (auftrag.status !== 'PENDING_APPROVAL') throw new AccessError('export-not-pending')
if (auftrag.requestedById === p.userId) throw new AccessError('export-self-approval')
await db.$transaction(async (tx) => {
await tx.exportJob.update({
where: { id: jobId },
data: { status: 'QUEUED', approvedById: p.userId, approvedAt: new Date() },
})
await writeAudit(tx, {
actorId: p.userId,
action: 'export.approve',
targetType: 'ExportJob',
targetId: jobId,
clearanceAtTime: p.clearanceLevel,
meta: { requestedBy: auftrag.requestedById, kind: auftrag.kind },
})
})
}
export async function rejectExport(
p: EffectivePermissions,
jobId: string,
reason: string,
): Promise<void> {
if (!p.isAdmin && !p.permissions.has('export.approve')) {
throw new AccessError('no-permission')
}
const begruendung = reason.trim()
if (begruendung.length < 10) throw new AccessError('reason-required')
await db.$transaction(async (tx) => {
await tx.exportJob.updateMany({
where: { id: jobId, status: 'PENDING_APPROVAL' },
data: { status: 'REJECTED', rejectedById: p.userId, rejectReason: begruendung },
})
await writeAudit(tx, {
actorId: p.userId,
action: 'export.reject',
targetType: 'ExportJob',
targetId: jobId,
clearanceAtTime: p.clearanceLevel,
meta: { reason: begruendung },
})
})
}
/**
* Führt einen freigegebenen Auftrag aus: Druckansicht rendern lassen, ablegen,
@@ -344,21 +300,3 @@ export async function loadJob(p: EffectivePermissions, jobId: string) {
})
}
/** Offene Freigaben für das Dashboard des Leiters. */
export async function pendingApprovals(p: EffectivePermissions) {
if (!p.isAdmin && !p.permissions.has('export.approve')) return []
return db.exportJob.findMany({
where: { status: 'PENDING_APPROVAL', requestedById: { not: p.userId } },
orderBy: { createdAt: 'asc' },
take: 20,
select: {
id: true,
kind: true,
targetId: true,
requestedById: true,
clearanceAtTime: true,
createdAt: true,
},
})
}