Worker- und PDF-Dienst

Der Worker hängt am Discord-Gateway und schreibt alle 30 Sekunden sein
Lebenszeichen in die Datenbank, damit /api/health im Web-Container den
Gateway-Zustand kennt, ohne selbst mit Discord zu sprechen. healthcheck.js
prüft genau dieses Lebenszeichen. Der eigentliche Rollen-Abgleich kommt in
Phase 1.

Der PDF-Dienst rendert die Druckansicht über Playwright. Kein PDF-Layout von
Hand, die Gestaltung kommt aus @media print der Seite selbst. Er kennt keine
Rechte: wer darf, entscheidet die Web-App, bevor sie hier anfragt, und schickt
das Sitzungs-Cookie des Abrufers mit, damit die gerenderte Seite dessen
Freigabestufe sieht.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

pdf/eslint.config.mjs

@@ -0,0 +1,8 @@
+import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  { ignores: ['dist/**', 'node_modules/**'] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+)

pdf/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@afis/pdf",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint src --max-warnings 0",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "playwright": "1.62.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.0",
+    "@types/node": "^22.10.0",
+    "eslint": "9.39.5",
+    "tsx": "4.20.6",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.20.0",
+    "vitest": "4.1.11"
+  }
+}

pdf/src/index.ts

@@ -0,0 +1,109 @@
+import { createServer, type IncomingMessage } from 'node:http'
+import { chromium, type Browser } from 'playwright'
+
+/**
+ * Rendert die Druckansicht einer Akte zu PDF. Kein PDF-Layout von Hand, die
+ * Gestaltung kommt aus `@media print` der Seite selbst. Siehe docs/08-suche-und-export.md.
+ *
+ * Der Dienst ist nur im Stack-Netz erreichbar und kennt keine Rechte. Wer darf,
+ * entscheidet die Web-App, bevor sie hier anfragt; sie schickt das Sitzungs-Cookie
+ * des Abrufers mit, damit die gerenderte Seite dessen Freigabestufe sieht.
+ */
+const PORT = Number(process.env.PORT ?? 3000)
+const RENDER_TIMEOUT_MS = Number(process.env.RENDER_TIMEOUT_MS ?? 30_000)
+
+let browser: Browser | null = null
+
+async function getBrowser(): Promise<Browser> {
+  if (browser?.isConnected()) return browser
+  browser = await chromium.launch({ args: ['--no-sandbox', '--disable-dev-shm-usage'] })
+  return browser
+}
+
+type RenderRequest = {
+  url: string
+  cookies?: { name: string; value: string; domain: string; path: string }[]
+  /** Wasserzeichen: Name des Abrufers, Zeitstempel, Freigabestufe. */
+  headerHtml?: string
+  footerHtml?: string
+}
+
+function readBody(request: IncomingMessage): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = []
+    let size = 0
+    request.on('data', (chunk: Buffer) => {
+      size += chunk.length
+      if (size > 1_000_000) {
+        reject(new Error('Anfrage zu groß'))
+        request.destroy()
+        return
+      }
+      chunks.push(chunk)
+    })
+    request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    request.on('error', reject)
+  })
+}
+
+async function render(spec: RenderRequest): Promise<Buffer> {
+  const context = await (await getBrowser()).newContext({ locale: 'de-DE', timezoneId: 'Europe/Berlin' })
+  try {
+    if (spec.cookies?.length) await context.addCookies(spec.cookies)
+    const page = await context.newPage()
+    await page.goto(spec.url, { waitUntil: 'networkidle', timeout: RENDER_TIMEOUT_MS })
+    await page.emulateMedia({ media: 'print' })
+    return await page.pdf({
+      format: 'A4',
+      printBackground: true,
+      displayHeaderFooter: Boolean(spec.headerHtml || spec.footerHtml),
+      headerTemplate: spec.headerHtml ?? '<span></span>',
+      footerTemplate: spec.footerHtml ?? '<span></span>',
+      margin: { top: '18mm', bottom: '18mm', left: '16mm', right: '16mm' },
+    })
+  } finally {
+    await context.close()
+  }
+}
+
+const server = createServer((request, response) => {
+  void (async () => {
+    if (request.url === '/health') {
+      const healthy = browser === null || browser.isConnected()
+      response.writeHead(healthy ? 200 : 503, { 'content-type': 'application/json' })
+      response.end(JSON.stringify({ status: healthy ? 'up' : 'down' }))
+      return
+    }
+
+    if (request.method === 'POST' && request.url === '/render') {
+      try {
+        const spec = JSON.parse(await readBody(request)) as RenderRequest
+        if (typeof spec.url !== 'string') throw new Error('url fehlt')
+        const pdf = await render(spec)
+        response.writeHead(200, {
+          'content-type': 'application/pdf',
+          'content-length': String(pdf.byteLength),
+        })
+        response.end(pdf)
+      } catch (error) {
+        console.error('[pdf] Rendern fehlgeschlagen', error)
+        response.writeHead(500, { 'content-type': 'application/json' })
+        response.end(JSON.stringify({ error: error instanceof Error ? error.message : 'unbekannt' }))
+      }
+      return
+    }
+
+    response.writeHead(404)
+    response.end()
+  })()
+})
+
+server.listen(PORT, () => console.log(`[pdf] hört auf Port ${PORT}`))
+
+async function shutdown(): Promise<void> {
+  server.close()
+  await browser?.close().catch(() => undefined)
+  process.exit(0)
+}
+process.on('SIGTERM', () => void shutdown())
+process.on('SIGINT', () => void shutdown())

pdf/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": { "noEmit": false, "sourceMap": true }
+}

pdf/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*.ts"]
+}