Files
AfiS-Aktensystem/web/lib/realtime/publish.ts
T
Harlekin 48fd0f39eb Phase 8 abgeschlossen: Export als PDF, Wasserzeichen, Vier-Augen-Freigabe
Die Druckansicht ist die einzige Vorlage für den Export: kein zweites Layout
von Hand in einer PDF-Bibliothek. Der Playwright-Dienst ruft genau diese Seite
auf und bekommt dafür ein signiertes, kurzlebiges Zeichen statt eines
Sitzungscookies. Es gilt nur, solange der Auftrag läuft, ist an den Anfragenden
gebunden, und die Stufe wird beim Einlösen frisch aufgelöst und auf die im
Zeichen vermerkte gedeckelt.

Der Export darf nie sauberer aussehen als die Akte: gesperrte Felder erscheinen
als Balken mit Vermerk statt zu fehlen, geänderte Einträge tragen ihre Version,
zurückgezogene stehen als Grabstein. Wasserzeichen mit Name, Zeitstempel und
Stufe auf jeder Seite.

Die Stufe steckt im Zwischenspeicherschlüssel. Ohne sie bekäme ein Leser der
Stufe 1 das PDF, das für Stufe 4 gerendert wurde.

Ab Stufe 3 wartet der Auftrag auf Freigabe durch ein zweites Augenpaar — und
der Anfragende darf sich nicht selbst freigeben, auch nicht mit dem Recht
dazu. Offene Freigaben stehen auf der Übersicht.

Dazu Einzeldokumente als PDF (Aktenblatt bleibt Aktenblatt), ZIP-Sammelexport
mit eigenem achtzigzeiligem Schreiber statt einer Abhängigkeit, und der
JSON-Vollabzug ohne Stufenfilterung — die einzige Stelle, an der die
Klassifizierung nicht greift, deshalb hinter einem eigenen Admin-Endpunkt.

Zwei Funde unterwegs, beide in docs/13 festgehalten:

Die Druckansicht warf notFound(), und das Skelett aus dem Wurzel-loading.tsx
blieb im Browser stehen — der PDF-Dienst hätte leere Blätter gedruckt.
Gefunden nur, weil der e2e-Test auf den Inhalt prüft und nicht auf den
Statuscode. Sie rendert die Auskunft jetzt selbst.

Und die Entdopplung der Anhänge verwies auf Dateien, ohne nachzusehen, ob sie
noch daliegen. Nach einem geleerten /tmp zeigte jeder weitere Upload desselben
Inhalts stumm ins Leere.

178 Tests im Web-Paket, 17 in der Datenbank, 7 im Worker, 44 e2e.
Fallakte bei 119,8 von 120 kB — das Budget ist aufgebraucht.
2026-09-03 10:01:57 +02:00

70 lines
2.1 KiB
TypeScript

import { db } from '@/lib/db'
import type { Prisma } from '@afis/db'
/**
* Ereignisse an alle offenen Ansichten schicken.
*
* Über `pg_notify`, nicht über einen prozessinternen Verteiler: dann stimmt es
* auch, wenn später ein zweiter Web-Prozess dazukommt, und es braucht keinen
* zusätzlichen Dienst. Siehe docs/06-chat-und-realtime.md.
*
* **In der Nutzlast steht nie ein Inhalt**, nur ein Thema, eine Art und eine
* Kennung. Wer das Ereignis bekommt, entscheidet der Strom-Endpunkt, und was
* er daraus zu sehen bekommt, entscheidet die Sichtbarkeitsprüfung. Ein Text
* in der Nutzlast wäre an jedem Filter vorbei.
*/
export const STREAM_CHANNEL = 'afis_stream'
export type EventKind =
| 'chat.new'
| 'chat.edit'
| 'chat.withdrawn'
| 'chat.reaction'
| 'chat.adopted'
| 'entry.new'
| 'entry.updated'
| 'case.update'
| 'attachment.scanned'
| 'export.ready'
/** Wer das Ereignis angeht. */
export type Topic = `case:${string}` | `channel:${string}` | `user:${string}`
export function caseTopic(caseId: string): Topic {
return `case:${caseId}`
}
export function channelTopic(channelId: string): Topic {
return `channel:${channelId}`
}
export function userTopic(userId: string): Topic {
return `user:${userId}`
}
export type StreamEvent = { t: Topic; k: EventKind; i: string }
export async function publish(
topic: Topic,
kind: EventKind,
id: string,
tx?: Prisma.TransactionClient,
): Promise<void> {
const payload = JSON.stringify({ t: topic, k: kind, i: id } satisfies StreamEvent)
try {
const client = tx ?? db
await client.$executeRaw`SELECT pg_notify(${STREAM_CHANNEL}, ${payload})`
} catch (error) {
// Ein verlorenes Ereignis kostet eine Aktualisierung von Hand, mehr nicht.
// Es ist kein Grund, die Änderung scheitern zu lassen, die es meldet.
console.error('[realtime] Ereignis nicht zugestellt', error)
}
}
/** Kurzform für die Prüfkette der Dateien, die nur ein Thema kennt. */
export async function notifyAttachmentScanned(
attachmentId: string,
topic: Topic,
): Promise<void> {
await publish(topic, 'attachment.scanned', attachmentId)
}