feat(auftraege): worker, Phasen und Live-Fortschritt per SSE

Aufträge laufen als pg-boss-Jobs im worker. Der Phasen-Runner der Engine kennt weder Proxmox noch Datenbank; eine Senke schreibt Phasen und Log in die DB und meldet per NOTIFY, die app streamt per SSE an Web und CLI (Last-Event-ID, Herzschlag, Polling-Fallback im Browser). VMIDs vergibt eine Advisory-Sperre je Server zusammen mit einer Reservierungstabelle; zehn parallele Reservierungen im Test bekommen zehn verschiedene IDs. Der Proxmox-Client hat einen Trockenmodus für den Dry-Run: Lesendes echt, Schreibendes nur aufgezeichnet. Live-Ansicht im Aufbau der CLI-Ausgabe. Im echten Betrieb aufgefallen: ssh2 und pg sind CommonJS und brauchen im worker Default-Importe. Closes #006 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 10:54:41 +02:00
parent 01d22aac3a
commit 76bc0e4269
38 changed files with 2274 additions and 22 deletions
@@ -0,0 +1,13 @@
+import { NextResponse } from "next/server";
+import { aufruferAdresse } from "@/lib/adressen";
+import { api } from "@/server/api";
+import { rechtErforderlich } from "@/server/auth/zugang";
+import { auftragAbbrechen } from "@/server/services/auftraege";
+
+type Kontext = { params: Promise<{ id: string }> };
+
+export const POST = api(async (anfrage: Request, { params }: Kontext) => {
+  const aufrufer = await rechtErforderlich(anfrage, "ausrollen");
+  await auftragAbbrechen((await params).id, aufrufer, aufruferAdresse(anfrage.headers));
+  return NextResponse.json({ ok: true });
+});
@@ -0,0 +1,101 @@
+import { api } from "@/server/api";
+import { rechtErforderlich } from "@/server/auth/zugang";
+import { abonnieren } from "@/server/ereignisse/hoeren";
+import { auftragHolen, ENDZUSTAENDE, logAb } from "@/server/services/auftraege";
+
+type Kontext = { params: Promise<{ id: string }> };
+
+export const dynamic = "force-dynamic";
+
+/**
+ * Live-Fortschritt als Server-Sent Events – für Web-GUI und CLI derselbe Strom.
+ *
+ * - `stand`: der vollständige Auftrag mit allen Phasen (klein, deshalb immer ganz)
+ * - `log`: neue Detail-Log-Zeilen; ihre ID ist die Event-ID, damit ein Wiederverbinden mit
+ *   `Last-Event-ID` (oder `?ab=`) genau dort weitermacht
+ * - `ende`: der Auftrag ist fertig, der Strom schließt
+ */
+export const GET = api(async (anfrage: Request, { params }: Kontext) => {
+  await rechtErforderlich(anfrage, "lesen");
+  const anfangsStand = await auftragHolen((await params).id);
+  const auftragId = anfangsStand.id;
+  const letzte = anfrage.headers.get("last-event-id") ?? new URL(anfrage.url).searchParams.get("ab") ?? "0";
+  let logBis = BigInt(/^\d+$/.test(letzte) ? letzte : "0");
+
+  const kodierer = new TextEncoder();
+  let aufraeumen = () => {};
+
+  const strom = new ReadableStream<Uint8Array>({
+    async start(steuerung) {
+      let offen = true;
+      const senden = (text: string) => {
+        if (offen) steuerung.enqueue(kodierer.encode(text));
+      };
+      const ereignis = (art: string, daten: unknown, id?: string) =>
+        senden(`${id ? `id: ${id}\n` : ""}event: ${art}\ndata: ${JSON.stringify(daten)}\n\n`);
+
+      let laeuft = false;
+      let nochmal = false;
+      const aktualisieren = async () => {
+        // Signale können dicht kommen; zusammenfassen statt parallel abzufragen.
+        if (laeuft) {
+          nochmal = true;
+          return;
+        }
+        laeuft = true;
+        try {
+          do {
+            nochmal = false;
+            const stand = await auftragHolen(auftragId);
+            const zeilen = await logAb(auftragId, logBis);
+            if (zeilen.length > 0) {
+              logBis = BigInt(zeilen.at(-1)!.id);
+              ereignis("log", zeilen, zeilen.at(-1)!.id);
+            }
+            ereignis("stand", stand);
+            if (ENDZUSTAENDE.has(stand.status)) {
+              ereignis("ende", { status: stand.status });
+              schliessen();
+              return;
+            }
+          } while (nochmal);
+        } finally {
+          laeuft = false;
+        }
+      };
+
+      const abmelden = await abonnieren(auftragId, () => void aktualisieren());
+      // Herzschlag: hält Proxys davon ab, die Verbindung als tot zu schließen.
+      const herz = setInterval(() => senden(": ping\n\n"), 15_000);
+      const schliessen = () => {
+        if (!offen) return;
+        offen = false;
+        clearInterval(herz);
+        abmelden();
+        try {
+          steuerung.close();
+        } catch {
+          // schon geschlossen
+        }
+      };
+      aufraeumen = schliessen;
+      anfrage.signal.addEventListener("abort", schliessen);
+
+      senden("retry: 3000\n\n");
+      await aktualisieren();
+    },
+    cancel() {
+      aufraeumen();
+    },
+  });
+
+  return new Response(strom, {
+    headers: {
+      "content-type": "text/event-stream; charset=utf-8",
+      "cache-control": "no-cache, no-transform",
+      connection: "keep-alive",
+      // nginx puffert sonst und der Fortschritt käme in Brocken an.
+      "x-accel-buffering": "no",
+    },
+  });
+});
@@ -0,0 +1,14 @@
+import { NextResponse } from "next/server";
+import { api } from "@/server/api";
+import { rechtErforderlich } from "@/server/auth/zugang";
+import { auftragHolen, logAb } from "@/server/services/auftraege";
+
+type Kontext = { params: Promise<{ id: string }> };
+
+/** Detail-Log ab einer Zeilen-ID (`?ab=`), für Polling und `proxdeploy logs`. */
+export const GET = api(async (anfrage: Request, { params }: Kontext) => {
+  await rechtErforderlich(anfrage, "lesen");
+  const auftrag = await auftragHolen((await params).id);
+  const ab = new URL(anfrage.url).searchParams.get("ab");
+  return NextResponse.json(await logAb(auftrag.id, BigInt(/^\d+$/.test(ab ?? "") ? ab! : "0")));
+});
@@ -0,0 +1,11 @@
+import { NextResponse } from "next/server";
+import { api } from "@/server/api";
+import { rechtErforderlich } from "@/server/auth/zugang";
+import { auftragHolen } from "@/server/services/auftraege";
+
+type Kontext = { params: Promise<{ id: string }> };
+
+export const GET = api(async (anfrage: Request, { params }: Kontext) => {
+  await rechtErforderlich(anfrage, "lesen");
+  return NextResponse.json(await auftragHolen((await params).id));
+});
@@ -0,0 +1,10 @@
+import { NextResponse } from "next/server";
+import { api } from "@/server/api";
+import { rechtErforderlich } from "@/server/auth/zugang";
+import { auftraegeListe } from "@/server/services/auftraege";
+
+/** Verlauf. Filter und Seitenblättern folgen mit #014. */
+export const GET = api(async (anfrage: Request) => {
+  await rechtErforderlich(anfrage, "lesen");
+  return NextResponse.json(await auftraegeListe());
+});