Ankündigungen an Beschenkte erst nach Zahlung, Namen maskiert

Sicherheitsbefund: Geschenk-Abo- und Patenschafts-Ankündigungen gingen
bei order.placed an eine frei wählbare Adresse — auch bei Kauf auf
Rechnung, also ohne zu bezahlen. Die Namen von Beschenkten und
Schenkenden standen ungeschützt im HTML. So ließ sich kostenlos eine
echte place4bees-Mail (SPF/DKIM gültig) mit eingeschleusten Links an
jede Adresse schicken.

- Kundennamen in allen Mail-Vorlagen maskiert und auf 80 Zeichen
  gekürzt (Anrede, Beschenkte, Schenkende, Patenschaftsname).
- Ankündigungen erst, wenn bezahlt ist (Zahlung erfasst oder ganz per
  Gutschein gedeckt). Bei Rechnung holt geschenke-nach-zahlung.ts sie
  beim Buchen im Admin nach. Das Anlegen der Geschenk-Abos bleibt bei
  order.placed.
- Gegen Doppelversand ein idempotency_key je Abo bzw. Posten.

Getestet mit Angriffsbestellung (Patenschaft auf Rechnung, HTML und Link
im Namen): keine Mail vor der Zahlung, genau eine nach dem Buchen, HTML
nur maskiert in der Mail.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-26 12:33:46 +01:00
parent 2a40ca53b2
commit 2dc3e0ffee
5 changed files with 220 additions and 137 deletions
@@ -0,0 +1,135 @@
import { Modules } from "@medusajs/framework/utils";
import { SUBSCRIPTION_MODULE } from "../modules/subscription";
import { geschenkAnkuendigung, patenschaftAnkuendigung } from "./order-emails";
/**
* Ankündigungen an Beschenkte — Geschenk-Abo und Bienenpatenschaft.
*
* Sie gehen an eine Adresse, die der Käufer frei einträgt. Deshalb erst,
* wenn die Bestellung bezahlt ist: Sonst ließe sich über einen Kauf auf
* Rechnung kostenlos eine echte place4bees-Mail an jede beliebige Adresse
* auslösen. Aufgerufen bei order.placed (online bezahlt oder per Gutschein
* gedeckt) und bei payment.captured (Rechnung, sobald im Admin gebucht).
*
* Doppelte Mails verhindert der idempotency_key: Laufen beide Ereignisse
* gleichzeitig, verschickt das Benachrichtigungsmodul trotzdem nur einmal.
*/
const RHYTHMUS: Record<string, string> = {
monthly: "monatlich",
quarterly: "vierteljährlich",
biannual: "halbjährlich",
};
/**
* Bezahlt heißt: eine Zahlung ist erfasst — oder es gibt gar keine
* Zahlungssammlung, weil ein Gutschein den ganzen Betrag gedeckt hat.
*/
export async function istBezahlt(container: any, orderId: string): Promise<boolean> {
const { data: orders } = await container.resolve("query").graph({
entity: "order",
fields: ["id", "payment_collections.id", "payment_collections.payments.captured_at"],
filters: { id: orderId },
});
const sammlungen = orders?.[0]?.payment_collections ?? [];
if (!sammlungen.length) return true;
return sammlungen.some((c: any) => (c.payments ?? []).some((p: any) => p.captured_at));
}
/** Kündigt die verschenkten Abos einer bezahlten Bestellung an. */
export async function geschenkAbosAnkuendigen(container: any, orderId: string, logger: any) {
const { data: orders } = await container.resolve("query").graph({
entity: "order",
fields: ["id", "display_id", "items.id"],
filters: { id: orderId },
});
const order = orders?.[0];
const postenIds = (order?.items ?? []).map((i: any) => i.id);
if (!postenIds.length) return;
const service: any = container.resolve(SUBSCRIPTION_MODULE);
const offen = (await service.listSubscriptions({ source_line_item_id: postenIds })).filter(
(abo: any) => abo.prepaid && abo.gift_recipient_email && !abo.gift_announced_at
);
if (!offen.length) return;
if (!(await istBezahlt(container, orderId))) {
logger.info(`[geschenk] Bestellung ${order.display_id}: Ankündigung wartet auf den Zahlungseingang.`);
return;
}
const notification: any = container.resolve(Modules.NOTIFICATION);
for (const abo of offen) {
// Die erste Lieferung geht mit dieser Bestellung raus, deshalb ist die
// Gesamtzahl eine mehr als die verbleibenden.
const gesamt = (abo.remaining_deliveries ?? 0) + 1;
await notification.createNotifications({
to: abo.gift_recipient_email,
channel: "email",
template: "gift-announcement",
content: geschenkAnkuendigung({
empfaengerName: abo.gift_recipient_name,
schenkerName: abo.gift_sender_name ?? null,
lieferungen: gesamt,
rhythmus: RHYTHMUS[abo.interval] ?? abo.interval,
groesse: abo.size,
}),
idempotency_key: `geschenk-abo-ankuendigung-${abo.id}`,
data: { subscription_id: abo.id, order_id: orderId },
});
await service.updateSubscriptions({ id: abo.id, gift_announced_at: new Date() } as any);
logger.info(
`[geschenk] Abo ${abo.id} aus Bestellung ${order.display_id}: ${gesamt} Lieferungen, ` +
`Ankündigung an ${abo.gift_recipient_email}.`
);
}
}
/** Kündigt verschenkte Patenschaften einer bezahlten Bestellung an. */
export async function patenschaftenAnkuendigen(container: any, orderId: string, logger: any) {
const { data: orders } = await container.resolve("query").graph({
entity: "order",
fields: ["id", "display_id", "items.id", "items.metadata"],
filters: { id: orderId },
});
const order = orders?.[0];
if (!order) return;
// Auf die Felder herunterbrechen, die gebraucht werden — die Metadaten
// sind für den Übersetzer beliebig, hier soll es eindeutig sein.
const geschenke = (order.items ?? [])
.map((item: any) => ({
id: String(item?.id ?? ""),
name: String(item?.metadata?.sponsorship_name ?? ""),
email: String(item?.metadata?.sponsorship_recipient_email ?? ""),
von: item?.metadata?.sponsorship_sender_name ? String(item.metadata.sponsorship_sender_name) : null,
istGeschenk: item?.metadata?.sponsorship_gift === true,
}))
.filter((g: any) => g.istGeschenk && g.name && g.email);
if (!geschenke.length) return;
if (!(await istBezahlt(container, orderId))) {
logger.info(`[patenschaft] Bestellung ${order.display_id}: Ankündigung wartet auf den Zahlungseingang.`);
return;
}
const notification: any = container.resolve(Modules.NOTIFICATION);
for (const item of geschenke) {
const erzeugt = await notification.createNotifications({
to: item.email,
channel: "email",
template: "sponsorship-announcement",
content: patenschaftAnkuendigung({ name: item.name, schenkerName: item.von }),
// Je Bestellposten genau eine Ankündigung.
idempotency_key: `patenschaft-ankuendigung-${item.id}`,
data: { order_id: order.id, line_item_id: item.id },
});
// Das Modul gibt nichts zurück, wenn es unter diesem Schlüssel schon
// verschickt hat. Das Protokoll soll keinen Versand behaupten, der
// gar nicht stattgefunden hat.
const verschickt = Array.isArray(erzeugt) ? erzeugt.length > 0 : Boolean(erzeugt);
logger.info(
verschickt
? `[patenschaft] Ankündigung zu Bestellung ${order.display_id} an ${item.email} (auf ${item.name}).`
: `[patenschaft] Ankündigung zu Bestellung ${order.display_id} war schon verschickt, übersprungen.`
);
}
}
+43 -27
View File
@@ -59,10 +59,15 @@ function runden(zahl: number): number {
/** Anrede ohne Geschlechtsannahme: der Vorname allein reicht und liegt vor. */ /** Anrede ohne Geschlechtsannahme: der Vorname allein reicht und liegt vor. */
function anrede(adresse: Record<string, any> | null): string { function anrede(adresse: Record<string, any> | null): string {
const name = [adresse?.first_name, adresse?.last_name].filter(Boolean).join(" "); const name = kundenname([adresse?.first_name, adresse?.last_name].filter(Boolean).join(" "));
return name ? `Hallo ${name},` : "Hallo,"; return name ? `Hallo ${name},` : "Hallo,";
} }
/** Die Anrede für den HTML-Teil: Der Name stammt aus der Kundeneingabe. */
function anredeHtml(adresse: Record<string, any> | null): string {
return html(anrede(adresse));
}
function summen(bestellung: MailBestellung) { function summen(bestellung: MailBestellung) {
const posten = bestellung.items.map((item) => ({ const posten = bestellung.items.map((item) => ({
...item, ...item,
@@ -86,6 +91,15 @@ function html(text: string): string {
.replace(/"/g, "&quot;"); .replace(/"/g, "&quot;");
} }
/**
* Name, den eine Kundin eingegeben hat — gekürzt, damit niemand ganze Absätze
* in eine Mail schmuggelt, die wir an Dritte schicken. Im HTML-Teil zusätzlich
* mit html() maskieren.
*/
function kundenname(wert: unknown): string {
return String(wert ?? "").trim().slice(0, 80);
}
function adressblock(adresse: Record<string, any> | null): string[] { function adressblock(adresse: Record<string, any> | null): string[] {
if (!adresse) return []; if (!adresse) return [];
return [ return [
@@ -166,7 +180,7 @@ function postenTabelle(bestellung: MailBestellung): string {
(p) => `<tr> (p) => `<tr>
<td style="padding:8px 0;border-bottom:1px solid ${FARBE.linie}">${p.quantity} × ${p.title}${ <td style="padding:8px 0;border-bottom:1px solid ${FARBE.linie}">${p.quantity} × ${p.title}${
p.hinweis p.hinweis
? `<br /><span style="color:${FARBE.text};font-size:13px">${p.hinweis}</span>` ? `<br /><span style="color:${FARBE.text};font-size:13px">${html(kundenname(p.hinweis))}</span>`
: "" : ""
}</td> }</td>
<td style="padding:8px 0;border-bottom:1px solid ${FARBE.linie};text-align:right;white-space:nowrap">${euro(p.gesamt, w)}</td> <td style="padding:8px 0;border-bottom:1px solid ${FARBE.linie};text-align:right;white-space:nowrap">${euro(p.gesamt, w)}</td>
@@ -245,7 +259,7 @@ export function bestellbestaetigung(bestellung: MailBestellung) {
const html = RAHMEN(` const html = RAHMEN(`
<h1 style="${STIL.h1}">${ueberschrift}</h1> <h1 style="${STIL.h1}">${ueberschrift}</h1>
<p style="margin:0;color:${FARBE.text}">Bestellnummer ${bestellung.display_id}</p> <p style="margin:0;color:${FARBE.text}">Bestellnummer ${bestellung.display_id}</p>
<p style="margin:24px 0 0">${anrede(bestellung.shipping_address)}</p> <p style="margin:24px 0 0">${anredeHtml(bestellung.shipping_address)}</p>
<p style="margin:12px 0 0">${einleitung}</p> <p style="margin:12px 0 0">${einleitung}</p>
${postenTabelle(bestellung)} ${postenTabelle(bestellung)}
${ ${
@@ -323,7 +337,7 @@ export function versandnachricht(bestellung: MailBestellung, sendungen: Sendung[
const html = RAHMEN(` const html = RAHMEN(`
<h1 style="${STIL.h1}">Ihre Bestellung ist unterwegs</h1> <h1 style="${STIL.h1}">Ihre Bestellung ist unterwegs</h1>
<p style="margin:0;color:${FARBE.text}">Bestellnummer ${bestellung.display_id}</p> <p style="margin:0;color:${FARBE.text}">Bestellnummer ${bestellung.display_id}</p>
<p style="margin:24px 0 0">${anrede(bestellung.shipping_address)}</p> <p style="margin:24px 0 0">${anredeHtml(bestellung.shipping_address)}</p>
<p style="margin:12px 0 0"> <p style="margin:12px 0 0">
wir haben Ihr Paket verpackt und ${versandart ? `mit ${versandart} ` : ""}auf den Weg gebracht. wir haben Ihr Paket verpackt und ${versandart ? `mit ${versandart} ` : ""}auf den Weg gebracht.
</p> </p>
@@ -374,14 +388,16 @@ export type GeschenkAbo = {
/** Ankündigung an den Beschenkten, sobald das Geschenk gekauft ist. */ /** Ankündigung an den Beschenkten, sobald das Geschenk gekauft ist. */
export function geschenkAnkuendigung(abo: GeschenkAbo) { export function geschenkAnkuendigung(abo: GeschenkAbo) {
const von = abo.schenkerName ? `${abo.schenkerName} schenkt Ihnen` : "Jemand schenkt Ihnen"; const empfaenger = kundenname(abo.empfaengerName);
const schenker = kundenname(abo.schenkerName);
const von = schenker ? `${schenker} schenkt Ihnen` : "Jemand schenkt Ihnen";
const umfang = `${abo.lieferungen} Lieferungen, ${abo.rhythmus}${abo.groesse ? `, je ${abo.groesse}` : ""}`; const umfang = `${abo.lieferungen} Lieferungen, ${abo.rhythmus}${abo.groesse ? `, je ${abo.groesse}` : ""}`;
const html = RAHMEN(` const htmlInhalt = RAHMEN(`
<h1 style="${STIL.h1}">Für Sie: ein Honig-Abo</h1> <h1 style="${STIL.h1}">Für Sie: ein Honig-Abo</h1>
<p style="margin:24px 0 0">Hallo ${abo.empfaengerName},</p> <p style="margin:24px 0 0">Hallo ${html(empfaenger)},</p>
<p style="margin:12px 0 0"> <p style="margin:12px 0 0">
${von} ein Honig-Abo von place4bees — ${umfang}. Der Honig kommt aus ${html(von)} ein Honig-Abo von place4bees — ${umfang}. Der Honig kommt aus
unseren eigenen Völkern, von Hand abgefüllt in Hamburg. unseren eigenen Völkern, von Hand abgefüllt in Hamburg.
</p> </p>
<p style="margin:16px 0 0"> <p style="margin:16px 0 0">
@@ -396,7 +412,7 @@ export function geschenkAnkuendigung(abo: GeschenkAbo) {
const text = [ const text = [
"Für Sie: ein Honig-Abo", "Für Sie: ein Honig-Abo",
"", "",
`Hallo ${abo.empfaengerName},`, `Hallo ${empfaenger},`,
"", "",
`${von} ein Honig-Abo von place4bees — ${umfang}.`, `${von} ein Honig-Abo von place4bees — ${umfang}.`,
"Der Honig kommt aus unseren eigenen Völkern, von Hand abgefüllt in Hamburg.", "Der Honig kommt aus unseren eigenen Völkern, von Hand abgefüllt in Hamburg.",
@@ -407,7 +423,7 @@ export function geschenkAnkuendigung(abo: GeschenkAbo) {
`${SHOP.name} · ${SHOP.web} · ${SHOP.email}`, `${SHOP.name} · ${SHOP.web} · ${SHOP.email}`,
].join("\n"); ].join("\n");
return { subject: "Für Sie: ein Honig-Abo von place4bees", html, text }; return { subject: "Für Sie: ein Honig-Abo von place4bees", html: htmlInhalt, text };
} }
export type Kuendigung = { export type Kuendigung = {
@@ -563,7 +579,7 @@ export function stornoMail(s: {
const htmlInhalt = RAHMEN(` const htmlInhalt = RAHMEN(`
<h1 style="${STIL.h1}">Bestellung storniert</h1> <h1 style="${STIL.h1}">Bestellung storniert</h1>
<p style="margin:0;color:${FARBE.text}">Bestellnummer ${s.display_id}</p> <p style="margin:0;color:${FARBE.text}">Bestellnummer ${s.display_id}</p>
<p style="margin:24px 0 0">${anrede(s.shipping_address)}</p> <p style="margin:24px 0 0">${anredeHtml(s.shipping_address)}</p>
<p style="margin:12px 0 0">wir haben Ihre Bestellung ${s.display_id} storniert. Sie wird nicht verschickt.</p> <p style="margin:12px 0 0">wir haben Ihre Bestellung ${s.display_id} storniert. Sie wird nicht verschickt.</p>
<p style="${STIL.kasten}">${geld}</p> <p style="${STIL.kasten}">${geld}</p>
<p style="margin:24px 0 0;color:${FARBE.text};font-size:13px">${RUECKFRAGE}</p>`); <p style="margin:24px 0 0;color:${FARBE.text};font-size:13px">${RUECKFRAGE}</p>`);
@@ -596,7 +612,7 @@ export function erstattungMail(e: {
const htmlInhalt = RAHMEN(` const htmlInhalt = RAHMEN(`
<h1 style="${STIL.h1}">Geld ist unterwegs</h1> <h1 style="${STIL.h1}">Geld ist unterwegs</h1>
<p style="margin:0;color:${FARBE.text}">Bestellnummer ${e.display_id}</p> <p style="margin:0;color:${FARBE.text}">Bestellnummer ${e.display_id}</p>
<p style="margin:24px 0 0">${anrede(e.shipping_address)}</p> <p style="margin:24px 0 0">${anredeHtml(e.shipping_address)}</p>
<p style="margin:12px 0 0"> <p style="margin:12px 0 0">
wir haben Ihnen zu Ihrer Bestellung ${e.display_id} <strong>${betrag}</strong> erstattet — wir haben Ihnen zu Ihrer Bestellung ${e.display_id} <strong>${betrag}</strong> erstattet —
auf das Zahlungsmittel, mit dem Sie bezahlt haben. auf das Zahlungsmittel, mit dem Sie bezahlt haben.
@@ -641,7 +657,7 @@ export function aboZahlungFehlgeschlagenMail(a: {
const htmlInhalt = RAHMEN(` const htmlInhalt = RAHMEN(`
<h1 style="${STIL.h1}">${titel}</h1> <h1 style="${STIL.h1}">${titel}</h1>
<p style="margin:24px 0 0">${anrede(a.shipping_address)}</p> <p style="margin:24px 0 0">${anredeHtml(a.shipping_address)}</p>
<p style="margin:12px 0 0">${absatz}</p> <p style="margin:12px 0 0">${absatz}</p>
<p style="${STIL.kasten}">${hinweis}</p> <p style="${STIL.kasten}">${hinweis}</p>
<p style="margin:24px 0 0"><a href="${html(a.kontoLink)}" style="${STIL.knopf}">Abo im Kundenkonto ansehen</a></p> <p style="margin:24px 0 0"><a href="${html(a.kontoLink)}" style="${STIL.knopf}">Abo im Kundenkonto ansehen</a></p>
@@ -685,9 +701,9 @@ export function geschenkVersandnachricht(
? `Danach kommen noch ${verbleibend} weitere Lieferungen.` ? `Danach kommen noch ${verbleibend} weitere Lieferungen.`
: "Das war die letzte Lieferung Ihres Abos."; : "Das war die letzte Lieferung Ihres Abos.";
const html = RAHMEN(` const htmlInhalt = RAHMEN(`
<h1 style="${STIL.h1}">Ihr Honig ist unterwegs</h1> <h1 style="${STIL.h1}">Ihr Honig ist unterwegs</h1>
<p style="margin:24px 0 0">Hallo ${empfaengerName},</p> <p style="margin:24px 0 0">Hallo ${html(kundenname(empfaengerName))},</p>
<p style="margin:12px 0 0">die nächste Lieferung Ihres Honig-Abos ist auf dem Weg.</p> <p style="margin:12px 0 0">die nächste Lieferung Ihres Honig-Abos ist auf dem Weg.</p>
<h2 style="${STIL.h2}">Im Paket</h2> <h2 style="${STIL.h2}">Im Paket</h2>
<ul style="margin:0;padding-left:18px"> <ul style="margin:0;padding-left:18px">
@@ -703,7 +719,7 @@ export function geschenkVersandnachricht(
const text = [ const text = [
"Ihr Honig ist unterwegs", "Ihr Honig ist unterwegs",
"", "",
`Hallo ${empfaengerName},`, `Hallo ${kundenname(empfaengerName)},`,
"", "",
"die nächste Lieferung Ihres Honig-Abos ist auf dem Weg.", "die nächste Lieferung Ihres Honig-Abos ist auf dem Weg.",
"", "",
@@ -718,7 +734,7 @@ export function geschenkVersandnachricht(
`${SHOP.name} · ${SHOP.web} · ${SHOP.email}`, `${SHOP.name} · ${SHOP.web} · ${SHOP.email}`,
].join("\n"); ].join("\n");
return { subject: "Ihr Honig ist unterwegs", html, text }; return { subject: "Ihr Honig ist unterwegs", html: htmlInhalt, text };
} }
/* --- Bienenpatenschaft ---------------------------------------------------- /* --- Bienenpatenschaft ----------------------------------------------------
@@ -735,9 +751,9 @@ export type PatenschaftGeschenk = {
}; };
export function patenschaftAnkuendigung(geschenk: PatenschaftGeschenk) { export function patenschaftAnkuendigung(geschenk: PatenschaftGeschenk) {
const von = geschenk.schenkerName const name = kundenname(geschenk.name);
? `${geschenk.schenkerName} schenkt Ihnen` const schenker = kundenname(geschenk.schenkerName);
: "Jemand schenkt Ihnen"; const von = schenker ? `${schenker} schenkt Ihnen` : "Jemand schenkt Ihnen";
// Die Leistungen stehen so in der Produktbeschreibung — hier nichts // Die Leistungen stehen so in der Produktbeschreibung — hier nichts
// dazuerfinden, was der Shop nicht verspricht. // dazuerfinden, was der Shop nicht verspricht.
@@ -748,11 +764,11 @@ export function patenschaftAnkuendigung(geschenk: PatenschaftGeschenk) {
"Bilder und Nachrichten vom Volk, dreimal im Jahr per E-Mail", "Bilder und Nachrichten vom Volk, dreimal im Jahr per E-Mail",
]; ];
const html = RAHMEN(` const htmlInhalt = RAHMEN(`
<h1 style="${STIL.h1}">Für Sie: eine Bienenpatenschaft</h1> <h1 style="${STIL.h1}">Für Sie: eine Bienenpatenschaft</h1>
<p style="margin:24px 0 0">Hallo ${geschenk.name},</p> <p style="margin:24px 0 0">Hallo ${html(name)},</p>
<p style="margin:12px 0 0"> <p style="margin:12px 0 0">
${von} eine Bienenpatenschaft bei place4bees. Ein Volk in Hamburg trägt ${html(von)} eine Bienenpatenschaft bei place4bees. Ein Volk in Hamburg trägt
von jetzt an Ihren Namen — auf der Urkunde und auf dem Etikett der Gläser. von jetzt an Ihren Namen — auf der Urkunde und auf dem Etikett der Gläser.
</p> </p>
<h2 style="${STIL.h2}">Was dazugehört</h2> <h2 style="${STIL.h2}">Was dazugehört</h2>
@@ -770,7 +786,7 @@ export function patenschaftAnkuendigung(geschenk: PatenschaftGeschenk) {
const text = [ const text = [
"Für Sie: eine Bienenpatenschaft", "Für Sie: eine Bienenpatenschaft",
"", "",
`Hallo ${geschenk.name},`, `Hallo ${name},`,
"", "",
`${von} eine Bienenpatenschaft bei place4bees. Ein Volk in Hamburg trägt`, `${von} eine Bienenpatenschaft bei place4bees. Ein Volk in Hamburg trägt`,
"von jetzt an Ihren Namen — auf der Urkunde und auf dem Etikett der Gläser.", "von jetzt an Ihren Namen — auf der Urkunde und auf dem Etikett der Gläser.",
@@ -784,7 +800,7 @@ export function patenschaftAnkuendigung(geschenk: PatenschaftGeschenk) {
`${SHOP.name} · ${SHOP.web} · ${SHOP.email}`, `${SHOP.name} · ${SHOP.web} · ${SHOP.email}`,
].join("\n"); ].join("\n");
return { subject: "Für Sie: eine Bienenpatenschaft bei place4bees", html, text }; return { subject: "Für Sie: eine Bienenpatenschaft bei place4bees", html: htmlInhalt, text };
} }
/* --- Geschenkgutschein ---------------------------------------------------- /* --- Geschenkgutschein ----------------------------------------------------
@@ -808,9 +824,9 @@ export type GutscheinInhalt = {
/** Der Gutschein selbst — an den Beschenkten oder an den Käufer. */ /** Der Gutschein selbst — an den Beschenkten oder an den Käufer. */
export function gutscheinMail(g: GutscheinInhalt) { export function gutscheinMail(g: GutscheinInhalt) {
const betrag = euro(g.betrag, g.waehrung); const betrag = euro(g.betrag, g.waehrung);
const hallo = g.empfaengerName ? `Hallo ${g.empfaengerName},` : "Hallo,"; const hallo = g.empfaengerName ? `Hallo ${kundenname(g.empfaengerName)},` : "Hallo,";
const einleitung = g.geschenk const einleitung = g.geschenk
? `${g.schenkerName ? `${g.schenkerName} schenkt` : "Jemand schenkt"} Ihnen einen Gutschein über ${betrag} für den Honig-Shop von place4bees.` ? `${g.schenkerName ? `${kundenname(g.schenkerName)} schenkt` : "Jemand schenkt"} Ihnen einen Gutschein über ${betrag} für den Honig-Shop von place4bees.`
: `hier ist Ihr Gutschein über ${betrag} für den Honig-Shop von place4bees.`; : `hier ist Ihr Gutschein über ${betrag} für den Honig-Shop von place4bees.`;
const einloesen = [ const einloesen = [
"Wählen Sie im Shop aus, was Ihnen gefällt, und geben Sie den Code an der Kasse unter „Gutschein einlösen“ ein.", "Wählen Sie im Shop aus, was Ihnen gefällt, und geben Sie den Code an der Kasse unter „Gutschein einlösen“ ein.",
@@ -0,0 +1,29 @@
import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework";
import { PaymentEvents } from "@medusajs/framework/utils";
import { bestellungZurZahlung } from "../lib/fulfill-order";
import { geschenkAbosAnkuendigen, patenschaftenAnkuendigen } from "../lib/geschenk-ankuendigung";
/**
* Holt die Ankündigungen an Beschenkte nach, sobald eine Zahlung erfasst
* ist — bei Kauf auf Rechnung, wenn im Admin die Zahlung gebucht wird.
* Bereits Verschicktes überspringen die beiden Funktionen.
*/
export default async function geschenkeNachZahlung({ event, container }: SubscriberArgs<{ id: string }>) {
const logger = container.resolve("logger");
try {
const orderId = await bestellungZurZahlung(container, event.data.id);
if (!orderId) return;
await geschenkAbosAnkuendigen(container, orderId, logger);
await patenschaftenAnkuendigen(container, orderId, logger);
} catch (error) {
logger.error(
`[geschenk] Ankündigung nach Zahlung ${event.data.id} fehlgeschlagen: ${
error instanceof Error ? error.message : String(error)
}`
);
}
}
export const config: SubscriberConfig = {
event: PaymentEvents.CAPTURED,
};
@@ -1,19 +1,10 @@
import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework"; import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework";
import { Modules } from "@medusajs/framework/utils";
import { SUBSCRIPTION_MODULE } from "../modules/subscription";
import { createGiftSubscriptionsFromOrder, SUBSCRIPTION_CART_FIELDS } from "../lib/subscription-from-order"; import { createGiftSubscriptionsFromOrder, SUBSCRIPTION_CART_FIELDS } from "../lib/subscription-from-order";
import { geschenkAnkuendigung } from "../lib/order-emails"; import { geschenkAbosAnkuendigen } from "../lib/geschenk-ankuendigung";
/** Für die Ankündigung lesbar machen, was im Modell technisch heißt. */
const RHYTHMUS: Record<string, string> = {
monthly: "monatlich",
quarterly: "vierteljährlich",
biannual: "halbjährlich",
};
/** /**
* Legt aus einer bezahlten Bestellung die verschenkten Abos an und kündigt * Legt aus einer Bestellung die verschenkten Abos an und kündigt sie beim
* sie beim Beschenkten an. * Beschenkten an — die Ankündigung erst, wenn die Bestellung bezahlt ist.
* *
* Hängt an `order.placed` und nicht am Zahlungseingang: das Geschenk läuft * Hängt an `order.placed` und nicht am Zahlungseingang: das Geschenk läuft
* über die normale Kasse, und dort gilt die Bestellung als Abschluss. * über die normale Kasse, und dort gilt die Bestellung als Abschluss.
@@ -53,35 +44,10 @@ export default async function giftSubscription({
const angelegt = await createGiftSubscriptionsFromOrder({ container, order }); const angelegt = await createGiftSubscriptionsFromOrder({ container, order });
if (!angelegt.length) return; if (!angelegt.length) return;
const notification: any = container.resolve(Modules.NOTIFICATION); logger.info(`[geschenk] Bestellung ${order.display_id}: ${angelegt.length} Geschenk-Abo(s) angelegt.`);
const service: any = container.resolve(SUBSCRIPTION_MODULE); // Angekündigt wird erst, wenn bezahlt ist — sonst wartet die Mail auf
// payment.captured (siehe geschenke-nach-zahlung.ts).
for (const abo of angelegt) { await geschenkAbosAnkuendigen(container, order.id, logger);
// Die erste Lieferung geht mit dieser Bestellung raus, deshalb ist die
// Gesamtzahl eine mehr als die verbleibenden.
const gesamt = (abo.remaining_deliveries ?? 0) + 1;
const inhalt = geschenkAnkuendigung({
empfaengerName: abo.gift_recipient_name,
schenkerName: abo.gift_sender_name ?? null,
lieferungen: gesamt,
rhythmus: RHYTHMUS[abo.interval] ?? abo.interval,
groesse: abo.size,
});
await notification.createNotifications({
to: abo.gift_recipient_email,
channel: "email",
template: "gift-announcement",
content: inhalt,
data: { subscription_id: abo.id, order_id: order.id },
});
await service.updateSubscriptions({ id: abo.id, gift_announced_at: new Date() } as any);
logger.info(
`[geschenk] Abo ${abo.id} aus Bestellung ${order.display_id} angelegt, ` +
`${gesamt} Lieferungen, Ankündigung an ${abo.gift_recipient_email}.`
);
}
} catch (error) { } catch (error) {
logger.error( logger.error(
`[geschenk] Bestellung ${orderId} konnte nicht in ein Abo überführt werden: ${ `[geschenk] Bestellung ${orderId} konnte nicht in ein Abo überführt werden: ${
@@ -1,83 +1,20 @@
import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework"; import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework";
import { Modules } from "@medusajs/framework/utils"; import { patenschaftenAnkuendigen } from "../lib/geschenk-ankuendigung";
import { patenschaftAnkuendigung } from "../lib/order-emails";
/** /**
* Kündigt eine verschenkte Bienenpatenschaft beim Beschenkten an. * Kündigt eine verschenkte Bienenpatenschaft beim Beschenkten an.
* *
* Ohne sie erführe er bis zur Ernte im Herbst nichts von seinem Geschenk. * Ohne sie erführe er bis zur Ernte im Herbst nichts von seinem Geschenk.
* Die Mail nennt keine Beträge — bezahlt hat jemand anderes. * Verschickt wird erst, wenn die Bestellung bezahlt ist; bei Kauf auf
* * Rechnung holt geschenke-nach-zahlung.ts die Ankündigung nach.
* Doppelte Nachrichten verhindert der `idempotency_key`: das
* Benachrichtigungsmodul überspringt, was unter diesem Schlüssel schon
* erfolgreich verschickt wurde, versucht einen Fehlschlag aber erneut.
*/ */
export default async function sponsorshipAnnouncement({ export default async function sponsorshipAnnouncement({ event, container }: SubscriberArgs<{ id: string }>) {
event,
container,
}: SubscriberArgs<{ id: string }>) {
const logger = container.resolve("logger"); const logger = container.resolve("logger");
const query = container.resolve("query");
const orderId = event.data.id;
try { try {
const { data: orders } = await query.graph({ await patenschaftenAnkuendigen(container, event.data.id, logger);
entity: "order",
fields: ["id", "display_id", "items.id", "items.metadata"],
filters: { id: orderId },
});
const order = orders?.[0];
if (!order) return;
// Auf die Felder herunterbrechen, die gebraucht werden — die Metadaten
// sind für den Übersetzer beliebig, hier soll es eindeutig sein.
const geschenke = (order.items ?? [])
.map((item: any) => ({
id: String(item?.id ?? ""),
name: String(item?.metadata?.sponsorship_name ?? ""),
email: String(item?.metadata?.sponsorship_recipient_email ?? ""),
von: item?.metadata?.sponsorship_sender_name
? String(item.metadata.sponsorship_sender_name)
: null,
istGeschenk: item?.metadata?.sponsorship_gift === true,
}))
.filter((g) => g.istGeschenk && g.name && g.email);
if (!geschenke.length) return;
const notification: any = container.resolve(Modules.NOTIFICATION);
for (const item of geschenke) {
const inhalt = patenschaftAnkuendigung({
name: item.name,
schenkerName: item.von,
});
const erzeugt = await notification.createNotifications({
to: item.email,
channel: "email",
template: "sponsorship-announcement",
content: inhalt,
// Je Bestellposten genau eine Ankündigung.
idempotency_key: `patenschaft-ankuendigung-${item.id}`,
data: { order_id: order.id, line_item_id: item.id },
});
// Das Modul gibt nichts zurück, wenn es unter diesem Schlüssel schon
// verschickt hat. Das Protokoll soll keinen Versand behaupten, der
// gar nicht stattgefunden hat.
const verschickt = Array.isArray(erzeugt) ? erzeugt.length > 0 : Boolean(erzeugt);
logger.info(
verschickt
? `[patenschaft] Ankündigung zu Bestellung ${order.display_id} an ` +
`${item.email} (auf ${item.name}).`
: `[patenschaft] Ankündigung zu Bestellung ${order.display_id} war schon ` +
`verschickt, übersprungen.`
);
}
} catch (error) { } catch (error) {
logger.error( logger.error(
`[patenschaft] Ankündigung für ${orderId} fehlgeschlagen: ${ `[patenschaft] Ankündigung für ${event.data.id} fehlgeschlagen: ${
error instanceof Error ? error.message : String(error) error instanceof Error ? error.message : String(error)
}` }`
); );