Buchungskalender: Mails an Gäste, Vermieter und Team

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

test/mailTemplates.test.js

@@ -8,7 +8,7 @@ const DIR = new URL('../server/mail-templates/', import.meta.url)
 // G01–G08 Gästemails des Terminplaners (Task 9, neutrales Layout im Auftrag eines Betriebs), K20 und K21 Hinweise an den Betrieb;
 // K12, K14 und T12 (Wechsel ins Wartungs-Abo) aus Task 9, K13 und T13 (Zusatzspeicher) aus Task 8 (Fix 1); Endfassung der Texte in Task 12; T14 „Löschfristen“ aus Task 21 (F39); T15 Push-Zeitmail; K15, K16, T16 Funktionen (News-Pinnwand, Terminplaner; K15, K16 und T16 gelten je Funktion, Terminplaner TP2 B9a und B9b); T17 Repo zuordnen; K17 Chat-Hinweis an Kunden; K18, K19 Website-Analyse; K22, K23 Terminplaner beendet/läuft wieder (Terminplaner TP2 E3); T18 Bankzugang erneuern (Finanzen); T19 Erstattung fällig und T20 Terminplaner Betriebsmeldung (Terminplaner TP2, Team-Hinweise; T16 gilt je Funktion, T19 aus B9b); T21 Neue Webshop-Anfrage (Webshop B1, Team-Hinweis); K24 Webshop-Anfrage entschieden (Webshop B2, Kunde); G09–G14 Käufermails des Webshops (Bestellbestätigung, versendet, abholbereit, Eingang Widerruf, Erstattung, Zahlung fehlgeschlagen; Webshop E4, eigener Fuß statt Terminplaner-Fuß, Sie-Form) und K25, K26 an den Händler (neue Bestellung, Widerruf; Webshop E4); K27–K30 Öffnungszeiten live (eingeschaltet, Feiertage prüfen, Abo beendet, abgeschaltet; Öffnungszeiten live Task 13); K04 und T09 gelten beim Widerruf einer Funktion je Funktion (produkt, T09 zusätzlich preis; Terminplaner TP2 F9)
 const ids = (prefix, count) => Array.from({ length: count }, (_, i) => `${prefix}${String(i + 1).padStart(2, '0')}`)
-const EXPECTED = [...ids('G', 15), ...ids('K', 30), ...ids('T', 21)]
+const EXPECTED = [...ids('G', 22), ...ids('K', 34), ...ids('T', 22)]
 // GUEST = Gästemails des Terminplaners (gemeinsamer Fuß, Anrede-Blöcke); SHOP_GUEST = Käufermails des Webshops (G09–G14, siehe unten)
 const GUEST = ids('G', 8)
 const SHOP_GUEST = ['G09', 'G10', 'G11', 'G12', 'G13', 'G14', 'G15']
@@ -27,7 +27,7 @@ for (const id of EXPECTED) {
     const title = source.match(/<title>([\s\S]*?)<\/title>/)[1]
     assert.equal(title, tpl.subject, 'Betreff im Kopf und <title> sind gleich')
     // F34: Team-Hinweise tragen [Abo], [Speicher] (Zusatzspeicher-Aufgaben), [Datenschutz] (Loeschfristen), [Zeit] (Push-Zeitmail), [Finanzen] (Bankzugang), [Terminplaner] (Betriebsmeldung) oder [Webshop] (neue Anfrage)
-    assert.equal(id.startsWith('T'), /^\[(Abo|Speicher|Datenschutz|Zeit|Finanzen|Terminplaner|Webshop)\]/.test(tpl.subject) || id === 'T01' || id === 'T16' || id === 'T17', 'Team-Hinweise ab T02 mit [Abo], [Speicher], [Datenschutz], [Zeit], [Finanzen], [Terminplaner] oder [Webshop] (T16 Funktion bestellt und T17 Repo zuordnen ohne Kennung)')
+    assert.equal(id.startsWith('T'), /^\[(Abo|Speicher|Datenschutz|Zeit|Finanzen|Terminplaner|Webshop|Buchungskalender)\]/.test(tpl.subject) || id === 'T01' || id === 'T16' || id === 'T17', 'Team-Hinweise ab T02 mit [Abo], [Speicher], [Datenschutz], [Zeit], [Finanzen], [Terminplaner], [Webshop] oder [Buchungskalender] (T16 Funktion bestellt und T17 Repo zuordnen ohne Kennung)')
 
     const used = new Set([...tpl.body.matchAll(/\{\{(\w+)\}\}/g), ...tpl.subject.matchAll(/\{\{(\w+)\}\}/g)].map((m) => m[1]))
     assert.deepEqual([...used].sort(), [...tpl.placeholders].sort(), 'deklarierte = verwendete Platzhalter')
@@ -1280,3 +1280,75 @@ test('K26: Betreff, Platzhalter, Erklärung nur im Block, Hinweis auf die 14 Tag
   assert.match(mit.text, /innerhalb von 14 Tagen/)
   assert.doesNotMatch(renderMail('K26', K26_WERTE, {}).text, /Ich widerrufe|Erklärung:/)
 })
+
+// ---------------------------------------------------------------------------
+// Buchungskalender (Task 20): G16–G22 an Gäste (Sie-Form, neutral), K31–K34 und T22 (Du-Form, WEBklar)
+// ---------------------------------------------------------------------------
+
+const UK_GAST = ['G16', 'G17', 'G18', 'G19', 'G20', 'G21', 'G22']
+const UK_BASIS = ['gast_name', 'unterkunft', 'zeitraum', 'naechte', 'personen', 'nummer', 'firma', 'farbe', 'anbieter_kontakt']
+const UK_ERWARTET = {
+  G16: { p: [], b: [] },
+  G17: { p: ['posten_text', 'gesamt', 'frist', 'buchungs_link', 'stornobedingungen', 'nachricht_vermieter'], b: ['nachricht'] },
+  G18: { p: ['nachricht_vermieter'], b: ['nachricht'] },
+  G19: { p: ['posten_text', 'gesamt', 'zahlart_text', 'rechnung_nummer', 'stornobedingungen'], b: ['online_unbezahlt'] },
+  G20: { p: ['gesamt', 'rechnung_nummer'], b: [] },
+  G21: { p: ['frist'], b: [] },
+  G22: { p: ['rechnung_nummer', 'erstattung', 'nachricht_vermieter'], b: ['erstattung', 'nachricht'] },
+}
+
+test('G16–G22: Platzhalter und Blöcke, Sie-Form, kein WEBklar-Logo, keine festen Adressen', () => {
+  for (const id of UK_GAST) {
+    const tpl = loadTemplate(id)
+    assert.deepEqual([...tpl.placeholders].sort(), [...UK_BASIS, ...UK_ERWARTET[id].p].sort(), `${id}: Platzhalter`)
+    assert.deepEqual([...tpl.blocks].sort(), [...UK_ERWARTET[id].b].sort(), `${id}: Blöcke`)
+    assert.doesNotMatch(sourceOf(id), /<img|webklar-logo|project\.webklar\.com/i, `${id}: neutral`)
+    for (const on of [true, false]) {
+      const mail = renderMail(id, sampleValues(tpl), allBlocks(tpl, on))
+      assert.deepEqual(mail.problems, [], id)
+      assert.doesNotMatch(mail.text, DU_FORM, `${id}: Sie-Form\n${mail.text}`)
+      assert.match(mail.html, /background:Wert-farbe/, id)
+    }
+  }
+})
+
+test('G17: Preis, Frist, Stornobedingungen, Knopf und der Satz zur verbindlichen Buchung', () => {
+  const mail = renderMail('G17', sampleValues(loadTemplate('G17')), { nachricht: true })
+  for (const w of ['Wert-posten_text', 'Wert-gesamt', 'Wert-frist', 'Wert-stornobedingungen']) assert.ok(mail.text.includes(w), w)
+  assert.match(mail.html, /href="Wert-buchungs_link"[^>]*>Jetzt verbindlich buchen/)
+  assert.ok(mail.text.includes('Erst mit dem Klick auf „Zahlungspflichtig buchen“ auf der Buchungsseite ist Ihre Buchung verbindlich.'))
+})
+
+test('G19: dauerhafter Datenträger mit allen Angaben, Hinweis kein Widerrufsrecht, Bezahl-Hinweis nur im Block', () => {
+  const tpl = loadTemplate('G19')
+  const aus = renderMail('G19', sampleValues(tpl), { online_unbezahlt: false })
+  const an = renderMail('G19', sampleValues(tpl), { online_unbezahlt: true })
+  for (const w of ['Wert-posten_text', 'Wert-gesamt', 'Wert-zahlart_text', 'Wert-stornobedingungen', 'Wert-anbieter_kontakt', 'Wert-rechnung_nummer']) assert.ok(aus.text.includes(w), w)
+  assert.match(aus.text, /kein gesetzliches Widerrufsrecht/)
+  assert.ok(!aus.text.includes('Bezahl-Link'))
+  assert.ok(an.text.includes('Den Bezahl-Link finden Sie auf der Buchungsseite aus unserer vorigen E-Mail.'))
+})
+
+test('G22: Erstattung „wird veranlasst“ nur im Block', () => {
+  const tpl = loadTemplate('G22')
+  assert.ok(renderMail('G22', { ...sampleValues(tpl), erstattung: '50,00 €' }, { erstattung: true }).text.includes('Eine Erstattung von 50,00 € wird veranlasst.'))
+  assert.ok(!renderMail('G22', sampleValues(tpl), { erstattung: false }).text.includes('Erstattung von'))
+})
+
+test('K31–K34, T22: Dateien, Platzhalter, Du-Form', () => {
+  const erwartet = {
+    K31: ['kunde_name', 'gast_name', 'gast_email', 'unterkunft', 'zeitraum', 'naechte', 'personen', 'nummer', 'nachricht_gast', 'portal_url'],
+    K32: ['kunde_name', 'gast_name', 'unterkunft', 'zeitraum', 'naechte', 'personen', 'nummer', 'gesamt', 'zahlart_text', 'portal_url'],
+    K33: ['kunde_name', 'unterkunft', 'portal_url'],
+    K34: ['kunde_name', 'projekt', 'preis', 'ust_hinweis', 'begruendung', 'portal_url'],
+    T22: ['kunde_name', 'email', 'projekt', 'nachricht', 'woms_url'],
+  }
+  for (const [id, p] of Object.entries(erwartet)) {
+    const tpl = loadTemplate(id)
+    assert.deepEqual([...tpl.placeholders].sort(), [...p].sort(), id)
+    const mail = renderMail(id, sampleValues(tpl), allBlocks(tpl, true))
+    assert.deepEqual(mail.problems, [], id)
+  }
+  assert.equal(loadTemplate('K32').file, 'K32 Neue Buchung.html')
+  assert.equal(loadTemplate('T22').subject, '[Buchungskalender] Neue Anfrage: {{kunde_name}}')
+})

test/termineOutbox.test.js

@@ -10,7 +10,7 @@ import { TERMINE_DATETIMES } from '../server/services/termine/schema.js'
 // Produktion. Der Mailtransport ist ein Fake, der Sendeversuche zaehlt und gezielt Fehler wirft (nodemailer-Fehler
 // tragen `code` und SMTP-`responseCode`). Alle Zeiten sind feste Parameter.
 const aw = await startAppwriteMock({
-  schema: { termineOutbox: schemaKeys('termineOutbox') },
+  schema: { termineOutbox: schemaKeys('termineOutbox'), ukRechnungen: schemaKeys('ukRechnungen') },
   datetimes: TERMINE_DATETIMES,
   defaultLimit: 25,
 })
@@ -1290,3 +1290,39 @@ test('einreihen: optionaler Anhang-Verweis wird gespeichert (Senden unverändert
   const attribut = (await import('../server/services/termine/schema.js')).TERMINE_COLLECTIONS.termineOutbox.attributes.find((a) => a.key === 'anhang')
   assert.deepEqual(attribut, { key: 'anhang', type: 'string', size: 500, required: false })
 })
+
+// Buchungskalender (Task 20): anhang {art:'ukRechnung', rechnungId} -> Rechnungs-PDF als Anhang
+const RE_INHALT = { aussteller: { firma: 'Haus' }, empfaenger: { name: 'Eva' }, unterkunft: { name: 'Wohnung' }, von: '2026-11-12', bis: '2026-11-14', naechte: 2, personen: 2, posten: [{ text: 'Übernachtung', menge: 2, einzelCent: 10000, ustProzent: 0 }], summen: { bruttoCent: 20000, nettoCent: 20000, ust: [] }, steuerart: 'kleinunternehmer' }
+const seedRechnung = (extra = {}) => aw.seed('ukRechnungen', { $id: 'r1', featureId: 'f_feature01', anfrageId: 'a1', art: 'rechnung', nummer: 'RE-2026-0001', datum: '2026-11-01', bruttoCent: 20000, inhalt: JSON.stringify(RE_INHALT), ...extra })
+
+test('Anhang ukRechnung: gesendete Mail hat Rechnung-<nr>.pdf (beginnt mit %PDF); Stornorechnung heißt Stornorechnung-<nr>.pdf', async () => {
+  seedRechnung()
+  seedRechnung({ $id: 'r2', art: 'storno', nummer: 'RE-2026-0002' })
+  await einreihen(eintrag({ bookingId: 'b_re', anhang: JSON.stringify({ art: 'ukRechnung', rechnungId: 'r1' }) }), JETZT)
+  await einreihen(eintrag({ bookingId: 'b_st', anhang: JSON.stringify({ art: 'ukRechnung', rechnungId: 'r2' }) }), JETZT)
+  await einreihen(eintrag({ bookingId: 'b_ohne' }), JETZT)
+  await warteAufVersand()
+  const namen = tr.senke.sent.map((m) => (m.attachments ?? []).map((a) => a.filename))
+  assert.deepEqual(namen.map((n) => n.join()).sort(), ['', 'Rechnung-RE-2026-0001.pdf', 'Stornorechnung-RE-2026-0002.pdf'])
+  const mit = tr.senke.sent.find((m) => m.attachments?.length)
+  assert.equal(Buffer.from(mit.attachments[0].content, 'base64').subarray(0, 4).toString(), '%PDF')
+  assert.equal(mit.attachments[0].contentType, 'application/pdf')
+})
+
+test('Anhang nicht erzeugbar: Eintrag bleibt wartet (Wiederholung), nach 3 Fehlversuchen geht die Mail ohne Anhang raus', async () => {
+  const doc = await einreihen(eintrag({ bookingId: 'b_fehlt', art: 'uk-G19', anhang: JSON.stringify({ art: 'ukRechnung', rechnungId: 'gibtsnicht' }) }), JETZT)
+  await warteAufVersand()
+  let d = await lies(doc.$id)
+  assert.equal(d.status, 'wartet')
+  assert.equal(d.versuche, 1)
+  assert.equal(tr.aufrufe, 0)
+  let jetzt = JETZT
+  for (const warte of [2 * MIN, 6 * MIN, 31 * MIN]) {
+    jetzt = plus(warte, jetzt)
+    await sendeEintrag(doc.$id, jetzt)
+  }
+  d = await lies(doc.$id)
+  assert.equal(d.status, 'gesendet')
+  assert.equal(tr.senke.sent.length, 1)
+  assert.equal(tr.senke.sent[0].attachments?.length ?? 0, 0)
+})

test/unterkunftMails.test.js

@@ -0,0 +1,113 @@
+import { test, after, beforeEach } from 'node:test'
+import assert from 'node:assert/strict'
+import { startAppwriteMock } from './support/appwriteMock.js'
+import { mailSink } from './support/mailSink.js'
+import { useTestEnv } from './support/testEnv.js'
+import { schemaKeys } from './support/schema.js'
+import { TERMINE_DATETIMES } from '../server/services/termine/schema.js'
+
+// Buchungskalender Task 20: Mails an Gaeste (ueber die Warteschlange), Vermieter und Team
+const NAMEN = ['ukUnterkuenfte', 'ukPreise', 'ukAnfragen', 'ukRechnungen', 'ukEinstellungen', 'termineOutbox']
+const aw = await startAppwriteMock({
+  schema: Object.fromEntries(NAMEN.map((n) => [n, schemaKeys(n)])),
+  datetimes: { ...TERMINE_DATETIMES, ukAnfragen: ['fristAt', 'freigegebenAt', 'gebuchtAt', 'abgelehntAt', 'abgelaufenAt', 'storniertAt', 'bezahltAt'] },
+  defaultLimit: 25,
+})
+after(() => aw.close())
+useTestEnv({ appwriteUrl: aw.url, stripeUrl: 'http://127.0.0.1:1/v1' })
+const { config } = await import('../server/config.js')
+const { deleteDocument } = await import('../server/services/appwriteAdmin.js')
+const { setMailTransportForTests } = await import('../server/services/mailer.js')
+const { warteAufVersand, resetOutboxForTests } = await import('../server/services/termine/outbox.js')
+const mails = await import('../server/services/unterkunft/mails.js')
+const sp = await import('../server/services/unterkunft/speicher.js')
+after(() => setMailTransportForTests(null))
+
+const EIN = { firma: 'Haus am See', strasse: 'Weg 1', plz: '10115', ort: 'Berlin', email: 'vermieter@example.com', telefon: '0123', akzentfarbe: '#336699' }
+const ctx = { featureId: 'f1', customerId: 'c1', projectId: 'p1', siteKey: 'abcdefghijklmnop', besitzerEmail: 'besitzer@example.com', einstellungen: EIN }
+const POSTEN = [{ text: 'Übernachtung, 2 Nächte', menge: 2, einzelCent: 10000, ustProzent: 7 }, { text: 'Endreinigung', menge: 1, einzelCent: 5000, ustProzent: 19 }]
+const anfrage = (extra = {}) => ({
+  $id: 'a1', featureId: 'f1', unterkunftId: 'u1', nummer: 'A-K7QM', von: '2026-11-12', bis: '2026-11-14', personen: 2, status: 'freigegeben',
+  gast: { name: 'Eva Gast', email: 'eva@example.com', nachricht: 'Hallo' }, posten: POSTEN, summen: { bruttoCent: 25000 },
+  fristAt: '2026-11-05T16:00:00.000Z', stornobedingungenText: 'Kostenlos bis 7 Tage vorher.', nachrichtVermieter: '', ...extra,
+})
+let sink
+beforeEach(async () => {
+  for (const c of ['termineOutbox', 'ukRechnungen', 'ukUnterkuenfte', 'ukEinstellungen']) for (const id of aw.docs(c).keys()) await deleteDocument(c, id)
+  config.smtp.from = 'noreply@webklar.com'
+  resetOutboxForTests()
+  mails._aufrufe.length = 0
+  sink = mailSink()
+  setMailTransportForTests(sink)
+  aw.seed('ukUnterkuenfte', { $id: 'u1', featureId: 'f1', name: 'Wohnung See', maxPersonen: 4, mindestNaechte: 1, aktiv: true })
+})
+const gesendet = async () => {
+  await warteAufVersand()
+  return sink.sent
+}
+
+test('G17: Absender = Firma, Antworten an den Vermieter, Buchungslink mit Token, Preis und Frist', async () => {
+  await mails.anGast('G17', ctx, anfrage(), { token: 'tok123' })
+  const [m] = await gesendet()
+  assert.equal(m.from.name, 'Haus am See')
+  assert.equal(m.replyTo[0].address, 'vermieter@example.com')
+  assert.equal(m.to[0].address, 'eva@example.com')
+  assert.ok(m.text.includes(`${config.publicBaseUrl}/unterkunft/abcdefghijklmnop/buchung/a1?t=tok123`))
+  assert.ok(m.text.includes('250,00 €'))
+  assert.ok(m.text.includes('12.11.2026 – 14.11.2026'))
+  assert.ok(m.text.includes('Kostenlos bis 7 Tage vorher.'))
+  assert.ok(m.text.includes('05.11.2026, 17:00 Uhr'))
+  assert.ok(m.text.includes('Erst mit dem Klick auf „Zahlungspflichtig buchen“'))
+  assert.equal(mails._aufrufe[0].art, 'G17')
+})
+
+test('Minimaler ctx: Einstellungen und Unterkunft werden selbst geladen', async () => {
+  aw.seed('ukEinstellungen', { $id: 'f1', featureId: 'f1', ...EIN, firma: 'Geladene Firma' })
+  await mails.anGast('G21', { featureId: 'f1' }, anfrage())
+  const [m] = await gesendet()
+  assert.equal(m.from.name, 'Geladene Firma')
+  assert.ok(m.text.includes('Wohnung See'))
+  assert.doesNotMatch(m.text, /buchung\/a1/)
+})
+
+test('G17 ohne Token wirft, G16 hat keinen Link', async () => {
+  await assert.rejects(() => mails.anGast('G17', ctx, anfrage(), {}), TypeError)
+  await mails.anGast('G16', ctx, anfrage({ status: 'neu', posten: null, summen: null }))
+  const [m] = await gesendet()
+  assert.doesNotMatch(m.text, /\?t=/)
+})
+
+test('G19 hängt die Rechnung als PDF an (online, unbezahlt: Bezahl-Hinweis), G22 die Stornorechnung mit Erstattung', async () => {
+  const inhalt = { aussteller: { firma: 'Haus am See' }, empfaenger: { name: 'Eva Gast' }, unterkunft: { name: 'Wohnung See' }, von: '2026-11-12', bis: '2026-11-14', naechte: 2, personen: 2, posten: POSTEN, summen: { bruttoCent: 25000, nettoCent: 23000, ust: [] }, steuerart: 'kleinunternehmer', zahlart: 'online' }
+  const re = await sp.legeRechnungAn({ featureId: 'f1', anfrageId: 'a1', art: 'rechnung', nummer: 'RE-2026-0001', datum: '2026-11-01', bruttoCent: 25000, inhalt })
+  const st = await sp.legeRechnungAn({ featureId: 'f1', anfrageId: 'a1', art: 'storno', nummer: 'RE-2026-0002', datum: '2026-11-02', bruttoCent: -25000, inhalt: { ...inhalt, bezugNummer: 'RE-2026-0001' } })
+  await mails.anGast('G19', ctx, anfrage({ status: 'gebucht', zahlart: 'online' }), { rechnung: re })
+  await mails.anGast('G22', ctx, anfrage({ status: 'storniert' }), { stornoRechnung: st, erstattetCent: 25000, grund: 'Wasserschaden' })
+  const sent = await gesendet()
+  const g19 = sent.find((m) => m.subject.includes('bestätigt'))
+  const g22 = sent.find((m) => m.subject.includes('storniert'))
+  assert.equal(g19.attachments.length, 1)
+  assert.equal(g19.attachments[0].filename, 'Rechnung-RE-2026-0001.pdf')
+  assert.ok(Buffer.from(g19.attachments[0].content, 'base64').subarray(0, 4).toString() === '%PDF')
+  assert.ok(g19.text.includes('Den Bezahl-Link finden Sie auf der Buchungsseite'))
+  assert.equal(g22.attachments[0].filename, 'Stornorechnung-RE-2026-0002.pdf')
+  assert.ok(g22.text.includes('Eine Erstattung von 250,00 € wird veranlasst.'))
+  assert.ok(g22.text.includes('Wasserschaden'))
+})
+
+test('G22 ohne Erstattung: kein Erstattungssatz; G19 vor Ort bezahlt: kein Bezahl-Hinweis', async () => {
+  await mails.anGast('G22', ctx, anfrage({ status: 'storniert' }), { erstattetCent: 0 })
+  await mails.anGast('G19', ctx, anfrage({ status: 'gebucht', zahlart: 'vorort' }), {})
+  const sent = await gesendet()
+  assert.ok(sent.every((m) => !m.text.includes('Erstattung von') && !m.text.includes('Bezahl-Link')))
+})
+
+test('Vermieter: K31 geht an den Besitzer ohne BCC, mit Portal-Link; T22 ans Team; unbekannte Gastart wirft', async () => {
+  await mails.anVermieter('K31', ctx, { anfrage: anfrage({ status: 'neu' }) })
+  const [k] = await gesendet()
+  assert.equal(k.to[0].address, 'besitzer@example.com')
+  assert.ok(!k.bcc || k.bcc.length === 0)
+  assert.ok(k.text.includes(`${config.publicBaseUrl}/dashboard.html#buchungen?projekt=p1`))
+  assert.ok(k.text.includes('Eva Gast'))
+  await assert.rejects(() => mails.anGast('K31', ctx, anfrage()), TypeError)
+})