Patenschafts-Urkunde im Admin erzeugen und drucken

Neue Urkunde zur Bienenpatenschaft im place4bees-/Stadtimkerei-Design
(pdfkit, Bebas Neue). Der Name wird aus der Bestellung übernommen
(metadata.sponsorship_name), Nummer und Standort lassen sich im Admin
vor dem Drucken eintragen oder leer als Linie zum Ausfüllen von Hand.

Kachel "Urkunde Patenschaft" im Bestelldetail, nur bei Bestellungen mit
einer Patenschaft; Buttons zum Drucken und als PDF herunterladen.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-27 08:33:27 +01:00
parent c31c474ed8
commit f4b13e6018
5 changed files with 324 additions and 0 deletions
@@ -0,0 +1,110 @@
import { defineWidgetConfig } from "@medusajs/admin-sdk";
import { Button, Container, Heading, Input, Label, Text, toast } from "@medusajs/ui";
import type { DetailWidgetProps, AdminOrder } from "@medusajs/framework/types";
import { useState } from "react";
// Urkunde zur Bienenpatenschaft: Name kommt aus der Bestellung, Nummer und
// Standort kann der Imker vor dem Drucken eintragen. Das Widget erscheint nur
// bei Bestellungen, die eine Patenschaft enthalten.
const OrderUrkundeWidget = ({ data: order }: DetailWidgetProps<AdminOrder>) => {
const paten = (order.items ?? [])
.map((i: any) => String(i?.metadata?.sponsorship_name ?? "").trim())
.filter(Boolean);
const [nummer, setNummer] = useState("");
const [standort, setStandort] = useState("");
const [loading, setLoading] = useState(false);
if (!paten.length) return null;
const url = () => {
const p = new URLSearchParams();
if (nummer.trim()) p.set("nummer", nummer.trim());
if (standort.trim()) p.set("standort", standort.trim());
const qs = p.toString();
return `/admin/orders/${order.id}/urkunde${qs ? `?${qs}` : ""}`;
};
const ladePdf = async () => {
const res = await fetch(url(), { credentials: "include" });
if (!res.ok) throw new Error(`Urkunde konnte nicht erzeugt werden (${res.status}).`);
return res.blob();
};
const handleDownload = async () => {
setLoading(true);
try {
const blob = await ladePdf();
const href = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = href;
link.download = `urkunde-${paten[0].replace(/[^a-zA-Z0-9]+/g, "-").toLowerCase()}.pdf`;
document.body.appendChild(link);
link.click();
link.remove();
URL.revokeObjectURL(href);
} catch (err) {
toast.error("Fehler", { description: err instanceof Error ? err.message : "Unbekannter Fehler." });
} finally {
setLoading(false);
}
};
const handlePrint = async () => {
setLoading(true);
try {
const blob = await ladePdf();
const href = URL.createObjectURL(blob);
const fenster = window.open(href, "_blank");
if (fenster) {
fenster.addEventListener("load", () => fenster.print());
}
// URL bleibt bis zum Schließen des Tabs gültig; nicht sofort widerrufen.
} catch (err) {
toast.error("Fehler", { description: err instanceof Error ? err.message : "Unbekannter Fehler." });
} finally {
setLoading(false);
}
};
return (
<Container className="divide-y p-0">
<div className="flex items-center justify-between px-6 py-4">
<Heading level="h2">Urkunde Patenschaft</Heading>
</div>
<div className="flex flex-col gap-4 px-6 py-4">
<div>
<Text size="small" className="text-ui-fg-subtle">
Name auf der Urkunde: <span className="text-ui-fg-base font-medium">{paten.join(", ")}</span>
</Text>
</div>
<div className="grid grid-cols-2 gap-3">
<div className="flex flex-col gap-1">
<Label size="xsmall">Patenschaftsnummer (optional)</Label>
<Input size="small" value={nummer} onChange={(e) => setNummer(e.target.value)} placeholder="z. B. P-2026-077" />
</div>
<div className="flex flex-col gap-1">
<Label size="xsmall">Standort des Volkes (optional)</Label>
<Input size="small" value={standort} onChange={(e) => setStandort(e.target.value)} placeholder="z. B. Hamburg, Isestraße" />
</div>
</div>
<div className="flex items-center gap-2">
<Button variant="primary" size="small" isLoading={loading} onClick={handlePrint}>
Drucken
</Button>
<Button variant="secondary" size="small" isLoading={loading} onClick={handleDownload}>
Als PDF herunterladen
</Button>
</div>
<Text size="xsmall" className="text-ui-fg-muted">
Nummer und Standort leer lassen → auf der Urkunde steht eine Linie zum Eintragen von Hand.
</Text>
</div>
</Container>
);
};
export const config = defineWidgetConfig({
zone: "order.details.side.after",
});
export default OrderUrkundeWidget;
@@ -0,0 +1,8 @@
import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http";
import { handleUrkundeRequest } from "../../../../../lib/urkunde-handler";
// GET /admin/orders/:id/urkunde — Patenschafts-Urkunde als PDF zum Ausdrucken
// aus dem Admin heraus (Admin-Auth wie jede andere /admin-Route).
export async function GET(req: MedusaRequest, res: MedusaResponse) {
await handleUrkundeRequest(req, res);
}
@@ -0,0 +1,54 @@
import { MedusaRequest, MedusaResponse } from "@medusajs/framework/http";
import { renderUrkundePdf } from "./urkunde";
/**
* Liest aus einer Bestellung die Paten-Namen der Patenschafts-Posten.
* Jeder Posten einer Bienenpatenschaft trägt in den Metadaten
* `sponsorship_name` — den Namen, der auf die Urkunde soll (ob für einen
* selbst oder verschenkt, das Feld ist an der Kasse immer Pflicht).
*/
export async function findeSponsorPosten(
container: any,
orderId: string
): Promise<{ id: string; name: string }[]> {
const { data: orders } = await container.resolve("query").graph({
entity: "order",
fields: ["id", "items.id", "items.metadata"],
filters: { id: orderId },
});
const order = orders?.[0];
if (!order) return [];
return (order.items ?? [])
.map((item: any) => ({
id: String(item?.id ?? ""),
name: String(item?.metadata?.sponsorship_name ?? "").trim(),
}))
.filter((p: any) => p.name);
}
// GET /admin/orders/:id/urkunde — liefert die Patenschafts-Urkunde als PDF
// zum Ausdrucken. Der Name kommt aus der Bestellung; Nummer und Standort
// können über ?nummer= und ?standort= mitgegeben werden (sonst steht eine
// Linie zum Eintragen von Hand da). Mit ?name= lässt sich der Name überschreiben.
export async function handleUrkundeRequest(req: MedusaRequest, res: MedusaResponse) {
const posten = await findeSponsorPosten(req.scope, req.params.id);
const q = req.query as Record<string, string | undefined>;
const name = (q.name && q.name.trim()) || posten[0]?.name;
if (!name) {
res.status(404).json({ message: "Keine Patenschaft in dieser Bestellung gefunden." });
return;
}
const pdf = await renderUrkundePdf({
name,
nummer: q.nummer?.trim() || null,
standort: q.standort?.trim() || null,
});
const dateiName = `urkunde-${name.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "").toLowerCase() || "patenschaft"}.pdf`;
res.setHeader("Content-Type", "application/pdf");
res.setHeader("Content-Disposition", `inline; filename="${dateiName}"`);
res.send(pdf);
}
+152
View File
@@ -0,0 +1,152 @@
import PDFDocument from "pdfkit";
import path from "node:path";
import fs from "node:fs";
/**
* Urkunde zur Bienenpatenschaft als PDF — im place4bees-Design (Hamburger
* Stadtimkerei), modern und zum Ausdrucken. Der Name des Paten wird aus der
* Bestellung übernommen; Nummer und Standort können mitgegeben oder leer
* gelassen werden (dann steht eine Linie zum Eintragen von Hand da).
*
* Gestaltung wie Website und Mails: Bebas Neue als Display-Schrift,
* Honiggelb #f8ac11, dunkle Tinte. Erzeugt mit pdfkit wie die Rechnung.
*/
const LOGO_PATH = path.join(__dirname, "../assets/place4bees-logo.png");
const BEBAS_PATH = path.join(__dirname, "../assets/BebasNeue-Regular.ttf");
const C = {
honey: "#f8ac11",
honeyInk: "#8a5e05",
honeyTint: "#fdf3dc",
ink: "#212326",
text: "#5b6068",
muted: "#8b9099",
line: "#e3e5e9",
};
const COMPANY = {
name: "PLACE4BEES GmbH",
brand: "Hamburger Stadtimkerei",
addressLine: "Isestraße 109",
cityLine: "20149 Hamburg",
web: "www.place4bees.com",
email: "kontakt@place4bees.com",
};
export type UrkundeDaten = {
name: string;
nummer?: string | null;
standort?: string | null;
datum?: Date;
};
const PAGE_W = 595.28; // A4
const MARGIN = 56;
const INNER = PAGE_W - MARGIN * 2;
export function renderUrkundePdf(daten: UrkundeDaten): Promise<Buffer> {
// Unterer Rand klein, damit Fußzeile und Honigbalken nicht auf eine zweite
// Seite rutschen (pdfkit bricht sonst um, sobald Text unter den Rand geht).
const doc = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: 24, left: MARGIN, right: MARGIN } });
const hatBebas = fs.existsSync(BEBAS_PATH);
if (hatBebas) doc.registerFont("Bebas", BEBAS_PATH);
const DISPLAY = hatBebas ? "Bebas" : "Helvetica-Bold";
const teile: Buffer[] = [];
const fertig = new Promise<Buffer>((resolve) => {
doc.on("data", (d: Buffer) => teile.push(d));
doc.on("end", () => resolve(Buffer.concat(teile)));
});
// Rahmen: dünne Linie innen, oben und unten ein Honigbalken.
doc.save();
doc.rect(0, 0, PAGE_W, 10).fill(C.honey);
doc.rect(0, 831.89, PAGE_W, 10).fill(C.honey);
doc.lineWidth(0.8).strokeColor(C.line).rect(MARGIN - 18, MARGIN - 18, PAGE_W - (MARGIN - 18) * 2, 841.89 - (MARGIN - 18) * 2).stroke();
doc.restore();
// Logo zentriert.
const logoW = 150;
if (fs.existsSync(LOGO_PATH)) {
doc.image(LOGO_PATH, (PAGE_W - logoW) / 2, 64, { width: logoW });
}
let y = 212;
// Haupttitel.
doc.font(DISPLAY).fontSize(44).fillColor(C.ink);
doc.text("BIENENPATENSCHAFT", MARGIN, y, { width: INNER, align: "center", characterSpacing: 1 });
y += 54;
// Honig-Trennlinie mittig.
doc.save().lineWidth(2).strokeColor(C.honey)
.moveTo(PAGE_W / 2 - 40, y).lineTo(PAGE_W / 2 + 40, y).stroke().restore();
y += 24;
doc.font("Helvetica").fontSize(11).fillColor(C.honeyInk);
doc.text("URKUNDE ZUR BESTÄTIGUNG EINER PATENSCHAFT FÜR EIN BIENENVOLK", MARGIN, y, {
width: INNER, align: "center", characterSpacing: 0.5,
});
y += 46;
// "Für" + Name.
doc.font("Helvetica").fontSize(12).fillColor(C.text);
doc.text("Diese Urkunde wird ausgestellt für", MARGIN, y, { width: INNER, align: "center" });
y += 26;
doc.font(DISPLAY).fontSize(34).fillColor(C.honeyInk);
doc.text((daten.name || "—").toUpperCase(), MARGIN, y, { width: INNER, align: "center", characterSpacing: 1 });
y += 54;
// Bestätigungstext.
doc.font("Helvetica").fontSize(12).fillColor(C.text);
doc.text(
"Mit Ihrer Patenschaft übernehmen Sie Verantwortung für ein Bienenvolk unserer " +
"Hamburger Stadtimkerei und leisten einen wertvollen Beitrag zum Erhalt der Honigbiene " +
"und zur Bestäubung von Wild- und Nutzpflanzen. Ihr Engagement stärkt die Artenvielfalt " +
"mitten in der Stadt.",
MARGIN + 40, y,
{ width: INNER - 80, align: "center", lineGap: 3 }
);
y += 86;
// Angaben: Nummer & Standort in einem dezenten Kasten.
const boxH = 64;
doc.save().roundedRect(MARGIN + 40, y, INNER - 80, boxH, 8).fill(C.honeyTint).restore();
const feld = (label: string, wert: string | null | undefined, zeileY: number) => {
doc.font("Helvetica").fontSize(10).fillColor(C.honeyInk).text(label, MARGIN + 60, zeileY, { continued: false });
const wertX = MARGIN + 180;
const wertW = INNER - 80 - (180 - 40) - 20;
if (wert && wert.trim()) {
doc.font("Helvetica-Bold").fontSize(12).fillColor(C.ink).text(wert.trim(), wertX, zeileY - 1, { width: wertW });
} else {
doc.save().lineWidth(0.8).strokeColor(C.honey)
.moveTo(wertX, zeileY + 11).lineTo(wertX + wertW, zeileY + 11).stroke().restore();
}
};
feld("Patenschaftsnummer", daten.nummer, y + 16);
feld("Standort des Volkes", daten.standort, y + 40);
y += boxH + 48;
// Unterschrift / Aussteller.
const sigW = 220;
const sigX = (PAGE_W - sigW) / 2;
doc.save().lineWidth(0.8).strokeColor(C.ink).moveTo(sigX, y).lineTo(sigX + sigW, y).stroke().restore();
y += 8;
doc.font(DISPLAY).fontSize(16).fillColor(C.ink)
.text("IHRE HAMBURGER STADTIMKEREI", MARGIN, y, { width: INNER, align: "center", characterSpacing: 0.5 });
y += 20;
const datum = (daten.datum ?? new Date()).toLocaleDateString("de-DE", { day: "2-digit", month: "long", year: "numeric" });
doc.font("Helvetica").fontSize(10).fillColor(C.muted)
.text(`${COMPANY.name} · Hamburg · ${datum}`, MARGIN, y, { width: INNER, align: "center" });
// Fußzeile.
doc.font("Helvetica").fontSize(9).fillColor(C.muted)
.text(`${COMPANY.name} · ${COMPANY.addressLine} · ${COMPANY.cityLine} · ${COMPANY.web} · ${COMPANY.email}`,
MARGIN, 795, { width: INNER, align: "center" });
doc.end();
return fertig;
}