Personalakten und Abteilungen als vollstaendiges Dossier speichern
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

Bisher liess sich eine einzelne Fallakte und ein einzelnes Dokument als PDF
sichern. Wer den Stand zu einer Person brauchte, rief beides einzeln ab,
legte es von Hand zusammen und wusste danach nicht, ob er alles hatte.

Ein Dossier ist die Personalakte, dahinter alle ihre Dokumente, dahinter
alle Fallakten, in denen die Person vorkommt - jeweils in derselben
Druckdarstellung wie einzeln. Fuer eine Abteilung dasselbe, je Mitglied
getrennt: eine Abteilung hat keine eigenen Fallakten, sie hat Mitglieder,
die in Fallakten vorkommen. Alles in einen Topf geschuettet staende dieselbe
Akte mehrfach da, ohne dass man saehe, ueber wen sie dort steht.

Der Abrufer waehlt die hoechste Stufe, die aufgenommen wird. Das ist keine
Zugriffspruefung, sondern eine Entscheidung ueber den Umfang - und beides
darf nie durcheinandergeraten:

  - Was ueber der Freigabestufe des Abrufers liegt, existiert fuer ihn
    nicht. Es steht nicht im Abzug, wird nicht gezaehlt und nicht erwaehnt.
  - Was er selbst ausgeschlossen hat, steht als Vermerk im PDF, nach Stufe
    aufgeschluesselt. Eine gekuerzte Mappe darf nicht wie eine
    vollstaendige aussehen, und der Deckel steht zusaetzlich auf jeder
    Seite im Wasserzeichen.

Beide Grenzen laufen in der Datenbankabfrage, nicht danach in JavaScript.

Alles wird als eine Druckseite gerendert statt als mehrere
zusammengeheftete PDFs. So laufen Seitenzahlen, Kopfzeile und Wasserzeichen
durch, und es gibt keinen zweiten Weg, der irgendwann anders aussieht als
der erste. Dafuer sind die vorhandenen Druckansichten zu Bausteinen
geworden - CaseSheet und DocumentSheet stehen jetzt in components/print und
werden von den alten Seiten wie vom Dossier benutzt.

Der Zwischenspeicherschluessel traegt den Deckel, sonst bekaeme ein Abruf
bis Stufe 1 die Datei eines Abrufs bis Stufe 4. Und der Stand ist der
spaeteste ueber alle enthaltenen Akten, nicht der der Kopfdaten allein -
sonst gaebe der Zwischenspeicher einen Abzug heraus, in dem ein
inzwischen geaendertes Dokument im alten Wortlaut steht.

Jeder Abruf steht mit seinem Deckel im Protokoll. Ohne den sagt der
Eintrag, dass jemand etwas ausser Haus gegeben hat, aber nicht wie viel.
This commit is contained in:
Harlekin
2026-09-04 15:34:32 +02:00
parent 4652dd08ec
commit 6b2b4c4c8c
26 changed files with 2150 additions and 385 deletions
+277
View File
@@ -0,0 +1,277 @@
import { db } from '@/lib/db'
import { visibleEntryWhere } from '@/lib/access/caseFilter'
import { visibleAttachmentWhere } from '@/lib/access/attachmentFilter'
import { loadSections } from '@/lib/cases/sectionService'
import { isInputField, fillPlaceholders } from '@/lib/templates/fields'
import { de } from '@/lib/i18n/de'
import type { RenderedSection } from '@/lib/sections/render'
import type { EffectivePermissions } from '@/lib/auth/permissions'
/**
* Der Druckbogen einer Fallakte, ohne die Seite drumherum.
*
* Ausgelagert, weil er an drei Stellen gebraucht wird: in der Druckansicht der
* Akte selbst, im Dossier einer Person und im Bogen einer Abteilung. Stünde
* das Layout dort jeweils noch einmal, liefe es auseinander - und ein Export,
* der je nach Weg anders aussieht, ist keiner.
*
* **Ein Export darf nie sauberer aussehen als die Akte ist.** Deshalb:
* gesperrte Felder erscheinen als Balken mit Vermerk statt zu fehlen,
* geänderte Einträge sind als geändert gekennzeichnet, zurückgezogene stehen
* als Grabstein mit Begründung. Siehe docs/08-suche-und-export.md.
*/
export type CaseForPrint = {
id: string
caseNumber: string
title: string
status: string
templateId: string
templateKey: string
classification: number
createdById: string
dueAt: Date | null
}
export async function CaseSheet({
permissions,
displayName,
akte,
/** Im Dossier steht der Deckel schon vorn; dann nur der Inhalt. */
withCover = true,
authors,
}: {
permissions: EffectivePermissions
displayName: string
akte: CaseForPrint
withCover?: boolean
/** Einmal geladen und durchgereicht, statt je Akte erneut. */
authors?: Map<string, string>
}) {
const [sections, entries, anhaenge, levels, autoren] = await Promise.all([
loadSections(permissions, akte.id, akte.templateId),
db.caseEntry.findMany({
where: { AND: [visibleEntryWhere(permissions), { caseId: akte.id }] },
orderBy: [{ createdAt: 'asc' }, { id: 'asc' }],
select: {
id: true,
type: true,
body: true,
authorId: true,
createdAt: true,
version: true,
editedAt: true,
editVisible: true,
retractedAt: true,
retractionReason: true,
},
}),
db.attachment.findMany({
where: { AND: [visibleAttachmentWhere(permissions), { caseId: akte.id }] },
orderBy: { createdAt: 'asc' },
select: { id: true, originalName: true, sha256: true, sizeBytes: true, scanStatus: true },
}),
db.clearanceLevelConfig.findMany({ orderBy: { level: 'asc' } }),
authors ? [] : db.user.findMany({ select: { id: true, displayName: true } }),
])
const levelName = new Map(levels.map((l) => [l.level, l.name]))
const nameVon = authors ?? new Map(autoren.map((a) => [a.id, a.displayName]))
const stand = new Date()
return (
<>
{withCover ? (
<section className="print-cover">
<span className="print-stamp">
{akte.classification} · {levelName.get(akte.classification) ?? de.common.unknown}
</span>
<h1 style={{ marginTop: '4mm' }}>{akte.title}</h1>
<p style={{ fontFamily: 'var(--font-mono, monospace)', margin: 0 }}>{akte.caseNumber}</p>
<table className="print-meta">
<tbody>
<Zeile label={de.case.status} value={de.case.statusNames[akte.status] ?? akte.status} />
<Zeile label={de.case.type} value={akte.templateKey} />
<Zeile
label={de.case.createdBy}
value={nameVon.get(akte.createdById) ?? akte.createdById}
/>
<Zeile
label={de.case.dueAt}
value={akte.dueAt ? akte.dueAt.toLocaleDateString('de-DE') : '-'}
/>
<Zeile label={de.export.retrievedBy} value={displayName} />
<Zeile
label={de.export.asOf}
value={`${stand.toLocaleString('de-DE')} · ${de.clearance.label} ${permissions.clearanceLevel}`}
/>
</tbody>
</table>
<p className="print-note" style={{ marginTop: '4mm' }}>
{de.export.coverNote}
</p>
</section>
) : (
<header className="print-runin">
<span className="print-stamp">
{akte.classification} · {levelName.get(akte.classification) ?? de.common.unknown}
</span>
<h2 style={{ margin: '2mm 0 0' }}>{akte.title}</h2>
<p className="print-note" style={{ margin: 0 }}>
{akte.caseNumber} · {de.case.statusNames[akte.status] ?? akte.status}
</p>
</header>
)}
<h2>{de.section.heading}</h2>
<PrintSections sections={sections} levelName={levelName} />
<h2>{de.case.timeline}</h2>
{entries.length === 0 ? (
<p className="print-note">{de.entry.empty}</p>
) : (
entries.map((eintrag) => (
<div key={eintrag.id} className="print-entry">
<p className="print-label">
{de.entry.types[eintrag.type] ?? eintrag.type} ·{' '}
{nameVon.get(eintrag.authorId) ?? eintrag.authorId} ·{' '}
{eintrag.createdAt.toLocaleString('de-DE')}
{eintrag.editVisible && eintrag.editedAt
? ` · ${de.export.editedAt(eintrag.version, eintrag.editedAt.toLocaleDateString('de-DE'))}`
: ''}
</p>
{eintrag.retractedAt ? (
<p style={{ margin: '1mm 0', fontStyle: 'italic' }}>
{de.entry.retracted(
eintrag.retractedAt.toLocaleDateString('de-DE'),
nameVon.get(eintrag.authorId) ?? eintrag.authorId,
eintrag.retractionReason ?? '',
)}
</p>
) : (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>{eintrag.body}</p>
)}
</div>
))
)}
<h2>{de.attachment.heading}</h2>
{anhaenge.length === 0 ? (
<p className="print-note">{de.attachment.empty}</p>
) : (
<table className="print-meta">
<thead>
<tr>
<th>{de.export.fileName}</th>
<th>{de.export.fileSize}</th>
<th>{de.export.fileHash}</th>
</tr>
</thead>
<tbody>
{anhaenge.map((anhang) => (
<tr key={anhang.id}>
<td>{anhang.originalName}</td>
<td>{anhang.sizeBytes}</td>
{/* Der Hash macht nachprüfbar, dass die Datei zum Ausdruck
gehört - deshalb steht er im Verzeichnis. */}
<td style={{ fontFamily: 'monospace', fontSize: '7pt', wordBreak: 'break-all' }}>
{anhang.sha256}
</td>
</tr>
))}
</tbody>
</table>
)}
</>
)
}
function Zeile({ label, value }: { label: string; value: string }) {
return (
<tr>
<th>{label}</th>
<td>{value}</td>
</tr>
)
}
/**
* Die Abschnitte im Druck. Ein gesperrtes Feld wird als Balken ausgegeben, mit
* dem Vermerk, ab welcher Stufe es lesbar wäre - sonst merkt der Empfänger
* nicht, dass er eine gekürzte Fassung in der Hand hält.
*/
function PrintSections({
sections,
levelName,
}: {
sections: RenderedSection[]
levelName: Map<number, string>
}) {
const werte = Object.fromEntries(
sections.filter((s) => s.visible).map((s) => [s.fieldKey, s.value]),
)
return (
<div>
{sections.map((section) => {
const field = section.field
if (!isInputField(field)) {
if (field.type === 'pagebreak') {
return <div key={field.key} style={{ breakAfter: 'page' }} />
}
const text = fillPlaceholders(field.text ?? '', werte)
return field.type === 'heading' ? (
<h3 key={field.key}>{text || field.label}</h3>
) : (
<p key={field.key} style={{ whiteSpace: 'pre-wrap' }}>
{text}
</p>
)
}
return (
<div key={field.key} style={{ marginBottom: '3mm', breakInside: 'avoid' }}>
<p className="print-label">{field.label}</p>
{!section.visible ? (
<p style={{ margin: '1mm 0' }}>
<span className="print-redacted">&nbsp;</span>{' '}
<span className="print-note">
{de.export.redactedAt(
section.value.requiredLevel,
levelName.get(section.value.requiredLevel) ?? '',
)}
</span>
</p>
) : section.segments ? (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>
{section.segments.map((segment, index) =>
segment.kind === 'text' ? (
<span key={index}>{segment.text}</span>
) : (
// Balken statt Auslassung, mit der Stufe daneben: der
// Empfaenger soll sehen, dass hier etwas fehlt.
<span key={index}>
<span
className="print-redacted"
style={{ width: `${segment.blockLength}ch` }}
>
&nbsp;
</span>
<span className="print-note"> [{segment.requiredLevel}]</span>
</span>
),
)}
</p>
) : (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>
{String(section.value ?? '-')}
</p>
)}
</div>
)
})}
</div>
)
}