From 0fddad8370f6d76274661f5d6ffa058974f37e97 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 19 Nov 2026 02:29:30 +0000 Subject: [PATCH] Wiederbuchungs-Hinweis: Abmelden mit einem Klick im Mailprogramm MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Die Kopfzeile List-Unsubscribe zeigt auf eine Adresse der API, die ein POST ohne Rückfrage annimmt (RFC 8058), dazu List-Unsubscribe-Post. Ein GET ändert nichts und führt auf die Seite im Kundenbereich. ADR 0040, Nachtrag. Im Stand zwei schon gebaute Punkte bereinigt. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01B5RL9a5NPAggRs8rgvzbVC --- ...illigung-erinnerung-naechste-behandlung.md | 2 + docs/stand-und-offene-punkte.md | 4 +- docs/umsetzung/handtests.md | 9 +++ docs/umsetzung/pr-protokoll.md | 18 +++++ src/AispaStudio.Api/Mail/Mail.cs | 10 ++- src/AispaStudio.Api/Online/OnlinePortal.cs | 3 + .../Retention/MarketingConsents.cs | 13 +++- src/AispaStudio.Api/Retention/Rebooking.cs | 8 +-- .../Retention/RetentionEndpoints.cs | 13 ++++ .../MailboxAdapterTests.cs | 7 ++ tests/AispaStudio.Api.Tests/RetentionTests.cs | 22 +++++-- web/openapi/aispa-api.json | 49 ++++++++++++++ web/src/api/schema.d.ts | 65 +++++++++++++++++++ .../help/content/kalender-termin-verlauf.md | 2 +- 14 files changed, 209 insertions(+), 16 deletions(-) diff --git a/docs/entscheidungen/0040-einwilligung-erinnerung-naechste-behandlung.md b/docs/entscheidungen/0040-einwilligung-erinnerung-naechste-behandlung.md index 027bb28d..7b5de9dc 100644 --- a/docs/entscheidungen/0040-einwilligung-erinnerung-naechste-behandlung.md +++ b/docs/entscheidungen/0040-einwilligung-erinnerung-naechste-behandlung.md @@ -66,6 +66,8 @@ die KI keine Zahlen erfindet, und verhindert Zusagen, die das Spa nicht gemacht gegenlesen lassen. - Gebaut (17.11.2026, Masken-Überarbeitung P8): Der Abstand gilt nicht mehr nur je Behandlung. Es gibt einen **Standardabstand** (`RebookSettings.DefaultDays`) und **Ausnahmen** je Kategorie (`CategoryRebookInterval`) oder Behandlung (`TreatmentRebookInterval`, `Days` jetzt nullbar); leer heißt für diese Ausnahme kein Hinweis. Es gilt die Ausnahme der Behandlung, dann die der Kategorie, dann der Standard (`RebookRules.DaysFor`); ohne Standard und ohne Ausnahme geht wie bisher nichts hinaus. Bestehende Einstellungen bleiben gleich, weil der Standard leer ist. Die Wege der API bleiben, die neuen Felder sind optional (ADR 0085 §3). Das Versandprotokoll führt Terminerinnerungen und Wiederbuchungs-Hinweise in einer Liste zusammen (`GET /api/dispatch-log`, Filter, Zusammenfassung, Export). +- Nachtrag (19.11.2026): Abmelden mit einem Klick (RFC 8058). Die Kopfzeile `List-Unsubscribe` der Wiederbuchungs-Hinweise zeigt auf `…/api/online/consent/{Code}/unsubscribe`, dazu `List-Unsubscribe-Post: List-Unsubscribe=One-Click`. Ein POST dorthin widerruft ohne Rückfrage; ein GET ändert nichts (Virenscanner rufen Links vorab auf) und führt auf die Seite der Einwilligung im Kundenbereich. Der Link im Text der Mail bleibt die Seite im Kundenbereich, mit demselben Code. + ## Quellen - § 7 UWG (DE), § 174 TKG 2021 (AT), Art. 7 DSGVO (Nachweis der Einwilligung) diff --git a/docs/stand-und-offene-punkte.md b/docs/stand-und-offene-punkte.md index 68edac9b..9d42dd2e 100644 --- a/docs/stand-und-offene-punkte.md +++ b/docs/stand-und-offene-punkte.md @@ -411,14 +411,14 @@ Die Nummern sind die Reihenfolge, die der jeweilige Thread gewählt hätte ([Üb 6. Teilerstattung; Meldungen des Anbieters zu fehlgeschlagenen Erstattungen. 7. Online-Bestellungen und Erstattungen als Liste in der Kassa: seit 17.11.2026 gebaut (Karte „Online-Zahlungen“, nur zum Nachsehen). 8. Anzahlung in der Windows-App anzeigen: vorhanden (Abschnitt „Anzahlung“ im Termin-Panel, Ä285); am 17.11.2026 als erledigt vermerkt. -9. Aus den Buchungsproblemen offen (seit 16.11.2026 gebaut: Absage eines späteren Termins im Posteingang, Wunsch Therapeutin oder Therapeut bei der Online-Buchung): Bestätigung der E-Mail vor einer Gastbuchung, Gutschein mit Anzahlung verrechnen, Absage eines späteren als des nächsten Termins per Klick, Wunsch ♀/♂ bei der Online-Buchung. +9. Aus den Buchungsproblemen offen (seit 16.11.2026 gebaut: Absage eines späteren Termins im Posteingang, Wunsch Therapeutin oder Therapeut bei der Online-Buchung): Bestätigung der E-Mail vor einer Gastbuchung, Gutschein mit Anzahlung verrechnen (Wunsch ♀/♂ bei der Online-Buchung seit #61 und Absage eines späteren Termins im Posteingang seit #59 gebaut, am 19.11.2026 bereinigt). 10. CSP des Kundenbereichs durchsetzen ([ADR 0080](entscheidungen/0080-csp-fuer-den-kundenbereich.md)): nach einem Stand ohne CSP-Meldungen in Chrome, Edge, Firefox und Safari den Header-Namen umstellen und dabei den Header für `frame-ancestors` (Einbetten, Slice 58) mit der Richtlinie für Inhalte zusammenführen. - Später: Spa-Tag, Paar und Eintritte im Kundenbereich; Regeln für Ausfallgebühr und Anzahlung je Kundengruppe, Tageszeit oder No-Show-Risiko; Wissensbasis des Spas für Fragen im Kundenbereich; Reserve with Google und Gutscheinportale (erst nach der Freigabe des Auftraggebers, [ADR 0014](entscheidungen/0014-buchungsplattformen-ohne-partnervertrag.md)). **KI-Terminannahme, Kanäle, Assistent** 1. KI-Vorschläge für Absagen und Verschiebungen im Posteingang (Termin finden, Storno oder Ersatzzeiten vorschlagen, Rezeption bestätigt). 2. Wissensbasis des Spas (Parken, Anreise, Gutscheine, Hausregeln) als Quelle für Antwortvorschläge. -3. Abmelden mit einem Klick im Mailprogramm (`List-Unsubscribe-Post`); die Kopfzeile `List-Unsubscribe` und die Einwilligung beim Online-Buchen sind seit 16.11.2026 gebaut. +3. Abmelden mit einem Klick im Mailprogramm (`List-Unsubscribe-Post`, RFC 8058): seit 19.11.2026 gebaut. 4. Ansage am Telefon je Spa und in weiteren Sprachen; Rückruf statt SMS für Festnetz-Anrufer. 5. KI-Vorschläge im Dienstplan, nur als Vorschlag, abgestimmt mit dem Kalender. 6. Lokale KI: Schalter in der Windows-App für Ollama beim Einzelplatz, `gemma3:4b` mit echten Mails prüfen und mit `qwen3:4b` vergleichen ([ADR 0057](entscheidungen/0057-lokale-ki-optional-mit-ollama.md)). diff --git a/docs/umsetzung/handtests.md b/docs/umsetzung/handtests.md index 98bf81fe..85357760 100644 --- a/docs/umsetzung/handtests.md +++ b/docs/umsetzung/handtests.md @@ -1421,6 +1421,15 @@ Expected: Im Kalender steht der Termin beim Therapeuten; in der Notiz steht „W Closes: – Result: ☐ +### Wiederbuchungs-Hinweis – Abmelden mit einem Klick im Mailprogramm +Start: Testbetrieb mit echtem Mailversand an ein eigenes Gmail- oder Outlook-Postfach; ein Gast mit bestätigter Einwilligung, dessen letzte Behandlung lange genug her ist +1. Den Wiederbuchungs-Hinweis an das Postfach gehen lassen und die Mail öffnen. +Expected: Neben dem Absender bietet das Mailprogramm **Abmelden** an (Gmail: „Abmelden“ oben; Outlook: Hinweisleiste). +2. **Abmelden** klicken. +Expected: Keine Seite öffnet sich; in der Windows-App zeigt die Kundenkarte die Einwilligung als widerrufen. +Closes: – +Result: ☐ + ### Termin-Panel – Karten- und Anzahlungslink per SMS Start: `dotnet run --project src/AispaStudio.AppHost` mit eingerichtetem SMS-Anbieter (Twilio), Windows-App als Rezeption; am Standort sind Ausfallgebühr oder Anzahlung eingestellt; ein Gast ohne Mailadresse, mit eigener Handynummer in der Kundenkarte 1. Für den Gast einen Termin buchen, öffnen und **Anzahlung per Link** (oder **Karte per Link anfordern**) klicken. diff --git a/docs/umsetzung/pr-protokoll.md b/docs/umsetzung/pr-protokoll.md index 50526610..d508fcfa 100644 --- a/docs/umsetzung/pr-protokoll.md +++ b/docs/umsetzung/pr-protokoll.md @@ -7327,3 +7327,21 @@ Auftraggeber (23.10.2026): „Räume sollen wie Urlaub auch gesperrt werden kön - **Geprüft:** API `CardGuaranteeTests`, `DepositTests`, `OnlineRefundTests`, `OnlineBookingTests`, `StripePaymentTests`, `VoucherShopTests`, `ChannelScanTests` 103 von 103. Neu: Kartenlink per SMS, Zustimmen und Hinterlegen über den Link, Belastung per SMS; Anzahlungslink per SMS, Beleg per SMS; ohne Mail und ohne Nummer keine Anforderung. Windows-App: Ansichtstests zu Karte und Anzahlung grün. - **Nicht geprüft:** eine echte SMS beim Anbieter (Tests mit abgefangenem Versand); Stripe-Checkout ohne Mailadresse beim echten Anbieter; die laufende App unter Windows. - **Text-Prüfung:** von Hand nach [texte.md](../gestaltung/texte.md). + +## Wiederbuchungs-Hinweis: Abmelden mit einem Klick im Mailprogramm (19.11.2026) + +- **Auftrag:** Block „KI-Terminannahme und Posteingang“, Punkt 3 (`List-Unsubscribe-Post`); vom Auftraggeber am 19.11.2026 zum autonomen Abarbeiten freigegeben. +- **Befund:** Die Kopfzeile `List-Unsubscribe` zeigte auf die Seite im Kundenbereich (`…/buchen/#/einwilligung/{Code}`). Dorthin kann ein Mailprogramm kein Abmelden mit einem Klick schicken: Der Teil nach `#` erreicht den Server nicht, und die Seite will einen Klick auf „Widerrufen“. +- **Was:** + - `POST /api/online/consent/{Code}/unsubscribe` widerruft ohne Rückfrage (RFC 8058). + - `GET` auf dieselbe Adresse führt ohne Änderung auf die Seite im Kundenbereich. + - `OutgoingMail.OneClickUnsubscribe` setzt `List-Unsubscribe-Post: List-Unsubscribe=One-Click`. + - Der Wiederbuchungs-Hinweis nutzt beide Adressen mit demselben Code: die Seite im Text, die neue Adresse in der Kopfzeile. + - ADR 0040, Nachtrag; Hilfe `kalender-termin-verlauf`. + - Stand bereinigt: Wunsch ♀/♂ (#61) und Absage eines späteren Termins (#59) waren schon gebaut. +- **Detailentscheidungen:** + 1. GET ändert nichts, weil Virenscanner Links vorab aufrufen; so steht es schon beim Bestätigen der Einwilligung. + 2. Unbekannter oder abgelaufener Code: 404 ohne Hinweis, ob es den Gast gibt. +- **Geprüft:** API `RetentionTests`, `MailboxAdapterTests`, `ChannelScanTests` 25 von 25 (neu: Kopfzeilen, Adresse mit dem Code aus dem Text, GET leitet weiter und ändert nichts, POST widerruft, unbekannter Code 404). +- **Nicht geprüft:** ein echtes Mailprogramm (Gmail und Outlook zeigen den Knopf nur bei signierten Mails mit gutem Ruf des Absenders, DKIM); Handtest dafür angelegt. +- **Text-Prüfung:** von Hand nach [texte.md](../gestaltung/texte.md). diff --git a/src/AispaStudio.Api/Mail/Mail.cs b/src/AispaStudio.Api/Mail/Mail.cs index 0606c62e..34165383 100644 --- a/src/AispaStudio.Api/Mail/Mail.cs +++ b/src/AispaStudio.Api/Mail/Mail.cs @@ -10,6 +10,9 @@ namespace AispaStudio.Api.Mail; /// Adresse zum Abmelden (https) für die Kopfzeile List-Unsubscribe; nur bei Mails nach Einwilligung (ADR 0040), damit das Mailprogramm „Abmelden“ anbietet. /// Adresse für Antworten des Empfängers, z. B. das Postfach des Spas, wenn über den gemeinsamen Versand gesendet wird. /// Anzeigename des Absenders, z. B. der Name des Spas; ohne Angabe der aus . +/// +/// ListUnsubscribe nimmt ein POST ohne Rückfrage an (RFC 8058): dazu die Kopfzeile List-Unsubscribe-Post, damit das Mailprogramm mit einem Klick abmeldet. +/// /// Anhänge, z. B. ein Beleg als PDF (ADR 0092); zusammen höchstens . public sealed record OutgoingMail( string To, @@ -20,7 +23,8 @@ public sealed record OutgoingMail( string? ReplyTo = null, string? FromName = null, IReadOnlyList? Attachments = null, - string? ListUnsubscribe = null) + string? ListUnsubscribe = null, + bool OneClickUnsubscribe = false) { /// 5 MB je Mail: mehr nehmen viele Postfächer nicht an, und die Queue trägt den Anhang mit. public const int MaxAttachmentBytes = 5 * 1024 * 1024; @@ -93,6 +97,10 @@ public static MimeMessage Build(OutgoingMail mail, MailboxAddress from) if (mail.ListUnsubscribe is { } unsubscribe) { message.Headers.Add(HeaderId.ListUnsubscribe, $"<{unsubscribe}>"); + if (mail.OneClickUnsubscribe) + { + message.Headers.Add("List-Unsubscribe-Post", "List-Unsubscribe=One-Click"); + } } if (mail.InReplyTo is { } inReplyTo) diff --git a/src/AispaStudio.Api/Online/OnlinePortal.cs b/src/AispaStudio.Api/Online/OnlinePortal.cs index 9349b31e..5ebe7e05 100644 --- a/src/AispaStudio.Api/Online/OnlinePortal.cs +++ b/src/AispaStudio.Api/Online/OnlinePortal.cs @@ -423,6 +423,9 @@ orderby v.CreatedAt descending .ToListAsync(ct); } + /// Adresse eines öffentlichen Endpunkts der API unter der Adresse des Kundenbereichs, z. B. für das Abmelden mit einem Klick. + public string ApiUrl(string path) => $"{Options.PublicUrl.TrimEnd('/')}/{path.TrimStart('/')}"; + /// Link in den Kundenbereich (Hash-Route, damit der Code nicht in Server-Logs landet). /// Mandant für Links, die ohne Kundin funktionieren müssen (z. B. Buchung aus der Warteliste). public string Url(string route, Guid? spa = null) => diff --git a/src/AispaStudio.Api/Retention/MarketingConsents.cs b/src/AispaStudio.Api/Retention/MarketingConsents.cs index afeb2f25..01e44f2c 100644 --- a/src/AispaStudio.Api/Retention/MarketingConsents.cs +++ b/src/AispaStudio.Api/Retention/MarketingConsents.cs @@ -190,8 +190,17 @@ public async Task DecideAsync(Guid customerId, MarketingConsentState st } /// Neuer Abmeldelink für eine Erinnerung; gespeichert wird er mit dem nächsten SaveChanges des Kundenbereichs. - public string UnsubscribeUrl(Guid customerId) => - portal.Url($"einwilligung/{links.Create(AccessLinkPurpose.MarketingConsent, customerId, null, time.GetUtcNow() + LinkLifetime)}"); + public string UnsubscribeUrl(Guid customerId) => UnsubscribeLinks(customerId).Page; + + /// + /// Abmelden für eine Erinnerung, mit einem Code: Page ist die Seite im Kundenbereich (für den Text der Mail), OneClick die Adresse für + /// die Kopfzeile List-Unsubscribe. Ein POST dorthin meldet ohne Rückfrage ab (RFC 8058), ein GET leitet nur auf die Seite weiter. + /// + public (string Page, string OneClick) UnsubscribeLinks(Guid customerId) + { + var token = links.Create(AccessLinkPurpose.MarketingConsent, customerId, null, time.GetUtcNow() + LinkLifetime); + return (portal.Url($"einwilligung/{token}"), portal.ApiUrl($"api/online/consent/{token}/unsubscribe")); + } public async Task ForTokenAsync(string token, CancellationToken ct) => await FindAsync(token, ct) is { } found ? await ToOnlineAsync(found.Consent, ct) : null; diff --git a/src/AispaStudio.Api/Retention/Rebooking.cs b/src/AispaStudio.Api/Retention/Rebooking.cs index f3054cdd..89c82c7e 100644 --- a/src/AispaStudio.Api/Retention/Rebooking.cs +++ b/src/AispaStudio.Api/Retention/Rebooking.cs @@ -312,11 +312,11 @@ public async Task SendAsync(Guid reminderId, CancellationToken ct) reminder.Text = text ?? RebookTexts.Fallback(facts); var book = portal.Url($"?standort={last.LocationId}&behandlung={last.TreatmentId}", tenantId); - var unsubscribe = consents.UnsubscribeUrl(customer.Id); + var unsubscribe = consents.UnsubscribeLinks(customer.Id); await online.SaveChangesAsync(ct); try { - await mails.SendAsync(RebookTexts.Mail(consent.Email, facts, reminder.Text, reminder.AiWritten, book, unsubscribe), ct); + await mails.SendAsync(RebookTexts.Mail(consent.Email, facts, reminder.Text, reminder.AiWritten, book, unsubscribe.Page, unsubscribe.OneClick), ct); } catch (Exception ex) when (ex is not OperationCanceledException) { @@ -383,7 +383,7 @@ internal static class RebookTexts _ => $"Ihr letzter Besuch bei uns für „{f.Treatment}“ ist schon eine Weile her. Wenn Sie sich wieder etwas Gutes tun möchten, buchen Sie Ihren nächsten Termin einfach online.", }; - public static OutgoingMail Mail(string to, RebookFacts f, string text, bool aiWritten, string book, string unsubscribe) + public static OutgoingMail Mail(string to, RebookFacts f, string text, bool aiWritten, string book, string unsubscribe, string? oneClick = null) { var (subject, greeting, bookLabel, aiNotice, why, unsubscribeLabel) = f.Language switch { @@ -409,6 +409,6 @@ public static OutgoingMail Mail(string to, RebookFacts f, string text, bool aiWr -- {(aiWritten ? aiNotice + "\n" : "")}{why} {unsubscribeLabel}: {unsubscribe} - """, ListUnsubscribe: unsubscribe); + """, ListUnsubscribe: oneClick ?? unsubscribe, OneClickUnsubscribe: oneClick is not null); } } diff --git a/src/AispaStudio.Api/Retention/RetentionEndpoints.cs b/src/AispaStudio.Api/Retention/RetentionEndpoints.cs index 11862e3e..ee85ff7c 100644 --- a/src/AispaStudio.Api/Retention/RetentionEndpoints.cs +++ b/src/AispaStudio.Api/Retention/RetentionEndpoints.cs @@ -169,6 +169,19 @@ await consents.WithdrawAsync(token, ct) is { } dto ? TypedResults.Ok(dto) : Type .WithName("WithdrawOnlineConsent") .WithSummary("Widerruft die Einwilligung; danach gehen keine Wiederbuchungs-Hinweise mehr."); + // Abmelden mit einem Klick (RFC 8058): Das Mailprogramm schickt ein POST mit „List-Unsubscribe=One-Click“ an die Adresse aus der Kopfzeile. + // Ein GET (Virenscanner, ältere Mailprogramme, der Link im Browser) ändert nichts und führt auf die Seite im Kundenbereich. + open.MapPost("/{token}/unsubscribe", async Task> (string token, MarketingConsents consents, CancellationToken ct) => + await consents.WithdrawAsync(token, ct) is not null ? TypedResults.Ok() : TypedResults.NotFound()) + .RequireRateLimiting(OnlineSetup.SensitiveRateLimit) + .DisableAntiforgery() + .WithName("UnsubscribeOneClick") + .WithSummary("Abmelden mit einem Klick aus dem Mailprogramm (RFC 8058): widerruft die Einwilligung ohne Rückfrage."); + + open.MapGet("/{token}/unsubscribe", (string token, OnlinePortal portal) => TypedResults.Redirect(portal.Url($"einwilligung/{token}"))) + .WithName("UnsubscribeOneClickPage") + .WithSummary("Der Abmeldelink im Browser: führt ohne Änderung auf die Seite der Einwilligung im Kundenbereich."); + return routes; } diff --git a/tests/AispaStudio.Api.Tests/MailboxAdapterTests.cs b/tests/AispaStudio.Api.Tests/MailboxAdapterTests.cs index 0ddde09f..f1d8772d 100644 --- a/tests/AispaStudio.Api.Tests/MailboxAdapterTests.cs +++ b/tests/AispaStudio.Api.Tests/MailboxAdapterTests.cs @@ -101,8 +101,15 @@ public void Eine_Mail_mit_Abmeldeadresse_traegt_die_Kopfzeile_List_Unsubscribe_a var reminder = MailMessages.Build(new OutgoingMail("gast@example.at", "Zeit für Ihren nächsten Termin?", "Text", ListUnsubscribe: "https://spa.example/einwilligung/abc"), from); var plain = MailMessages.Build(new OutgoingMail("gast@example.at", "Ihr Termin", "Text"), from); + var oneClick = MailMessages.Build(new OutgoingMail("gast@example.at", "Zeit für Ihren nächsten Termin?", "Text", + ListUnsubscribe: "https://spa.example/api/online/consent/abc/unsubscribe", OneClickUnsubscribe: true), from); + Assert.Equal("", reminder.Headers[HeaderId.ListUnsubscribe]); + Assert.Null(reminder.Headers["List-Unsubscribe-Post"]); Assert.Null(plain.Headers[HeaderId.ListUnsubscribe]); + // Abmelden mit einem Klick (RFC 8058): beide Kopfzeilen. + Assert.Equal("", oneClick.Headers[HeaderId.ListUnsubscribe]); + Assert.Equal("List-Unsubscribe=One-Click", oneClick.Headers["List-Unsubscribe-Post"]); } [Fact] diff --git a/tests/AispaStudio.Api.Tests/RetentionTests.cs b/tests/AispaStudio.Api.Tests/RetentionTests.cs index e9e15b04..95de7556 100644 --- a/tests/AispaStudio.Api.Tests/RetentionTests.cs +++ b/tests/AispaStudio.Api.Tests/RetentionTests.cs @@ -56,18 +56,28 @@ public async Task Erinnert_erst_nach_bestaetigter_Einwilligung_mit_KI_Text_und_A Assert.Contains(RebookTexts.AiNoticeDe, mail.Text, StringComparison.Ordinal); Assert.Contains($"#/?standort={spa.Location.Id}&behandlung={spa.MassageTreatment.Id}", mail.Text, StringComparison.Ordinal); Assert.Contains("Abmelden: ", mail.Text, StringComparison.Ordinal); - // Dieselbe Adresse steht in der Kopfzeile, damit das Mailprogramm „Abmelden“ anbietet. - Assert.NotNull(mail.ListUnsubscribe); - Assert.Contains($"Abmelden: {mail.ListUnsubscribe}", mail.Text, StringComparison.Ordinal); + // In der Kopfzeile steht die Adresse zum Abmelden mit einem Klick (RFC 8058) mit demselben Code; das Mailprogramm schickt dorthin ein POST. + Assert.True(mail.OneClickUnsubscribe); + Assert.EndsWith($"/api/online/consent/{Token(mail.Text)}/unsubscribe", mail.ListUnsubscribe, StringComparison.Ordinal); + // Ein GET (Virenscanner, Browser) ändert nichts und führt auf die Seite im Kundenbereich. + using var noRedirect = fixture.Factory.CreateClient(new Microsoft.AspNetCore.Mvc.Testing.WebApplicationFactoryClientOptions { AllowAutoRedirect = false }); + var preview = await noRedirect.GetAsync($"/api/online/consent/{Token(mail.Text)}/unsubscribe", Ct); + Assert.Equal(HttpStatusCode.Redirect, preview.StatusCode); + Assert.EndsWith($"#/einwilligung/{Token(mail.Text)}", preview.Headers.Location!.ToString(), StringComparison.Ordinal); + Assert.Equal(MarketingConsentState.Confirmed, (await spa.GetAsync($"/api/customers/{guest.Id}/marketing-consent", Ct)).State); var sent = Assert.Single(await WaitForSentAsync(spa, 1)); Assert.Equal("Sent", sent.State); Assert.True(sent.AiWritten); Assert.Equal("Massage", sent.TreatmentName); - // Abmelden über den Link in der Erinnerung, ohne Anmeldung. - var withdrawn = await ReadAsync(await online.PostAsync($"/api/online/consent/{Token(mail.Text)}/withdraw", null, Ct)); - Assert.Equal(MarketingConsentState.Withdrawn, withdrawn.State); + // Abmelden mit einem Klick aus dem Mailprogramm: POST mit „List-Unsubscribe=One-Click“, ohne Anmeldung und ohne Rückfrage. + var oneClick = await online.PostAsync($"/api/online/consent/{Token(mail.Text)}/unsubscribe", + new FormUrlEncodedContent([new KeyValuePair("List-Unsubscribe", "One-Click")]), Ct); + Assert.Equal(HttpStatusCode.OK, oneClick.StatusCode); + Assert.Equal(MarketingConsentState.Withdrawn, (await spa.GetAsync($"/api/customers/{guest.Id}/marketing-consent", Ct)).State); + var unknown = await online.PostAsync("/api/online/consent/unbekannt/unsubscribe", null, Ct); + Assert.Equal(HttpStatusCode.NotFound, unknown.StatusCode); Assert.Equal(MarketingConsentState.Withdrawn, (await spa.GetAsync($"/api/customers/{guest.Id}/marketing-consent", Ct)).State); } diff --git a/web/openapi/aispa-api.json b/web/openapi/aispa-api.json index 91e23fa5..000d8af6 100644 --- a/web/openapi/aispa-api.json +++ b/web/openapi/aispa-api.json @@ -30901,6 +30901,55 @@ } } } + }, + "/api/online/consent/{token}/unsubscribe": { + "post": { + "tags": [ + "Kundenbereich" + ], + "summary": "Abmelden mit einem Klick aus dem Mailprogramm (RFC 8058): widerruft die Einwilligung ohne Rückfrage.", + "operationId": "UnsubscribeOneClick", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "OK" + }, + "404": { + "description": "Not Found" + } + } + }, + "get": { + "tags": [ + "Kundenbereich" + ], + "summary": "Der Abmeldelink im Browser: führt ohne Änderung auf die Seite der Einwilligung im Kundenbereich.", + "operationId": "UnsubscribeOneClickPage", + "parameters": [ + { + "name": "token", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "OK" + } + } + } } }, "components": { diff --git a/web/src/api/schema.d.ts b/web/src/api/schema.d.ts index 15ceea2c..02915e0c 100644 --- a/web/src/api/schema.d.ts +++ b/web/src/api/schema.d.ts @@ -8540,6 +8540,24 @@ export interface paths { patch?: never; trace?: never; }; + "/api/online/consent/{token}/unsubscribe": { + parameters: { + query?: never; + header?: never; + path?: never; + cookie?: never; + }; + /** Der Abmeldelink im Browser: führt ohne Änderung auf die Seite der Einwilligung im Kundenbereich. */ + get: operations["UnsubscribeOneClickPage"]; + put?: never; + /** Abmelden mit einem Klick aus dem Mailprogramm (RFC 8058): widerruft die Einwilligung ohne Rückfrage. */ + post: operations["UnsubscribeOneClick"]; + delete?: never; + options?: never; + head?: never; + patch?: never; + trace?: never; + }; } export type webhooks = Record; export interface components { @@ -38985,4 +39003,51 @@ export interface operations { }; }; }; + UnsubscribeOneClickPage: { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content?: never; + }; + }; + }; + UnsubscribeOneClick: { + parameters: { + query?: never; + header?: never; + path: { + token: string; + }; + cookie?: never; + }; + requestBody?: never; + responses: { + /** @description OK */ + 200: { + headers: { + [name: string]: unknown; + }; + content?: never; + }; + /** @description Not Found */ + 404: { + headers: { + [name: string]: unknown; + }; + content?: never; + }; + }; + }; } diff --git a/web/src/help/content/kalender-termin-verlauf.md b/web/src/help/content/kalender-termin-verlauf.md index 3b5e38dd..caf5cbf6 100644 --- a/web/src/help/content/kalender-termin-verlauf.md +++ b/web/src/help/content/kalender-termin-verlauf.md @@ -34,7 +34,7 @@ Im Termin-Panel stehen weitere Abschnitte, sobald es dazu etwas gibt: ![Termin mit dem Abschnitt Anzahlung, nachdem der Link verschickt ist](images/app/termin-anzahlung-anfordern.png) - **Terminerinnerungen** zeigt, welche Erinnerungen der Gast bekommen hat, mit Kanal, Zustand und Zeit. -- **Wiederbuchungs-Hinweis** ist eine Werbe-Mail einige Wochen nach der letzten Behandlung und braucht die Einwilligung des Gastes. Die Karte zeigt, ob der Gast eingewilligt hat. **Einwilligung anfragen** schickt ihm eine Mail (Sprache wählbar), er bestätigt per Link; erst dann kommen Hinweise. Sagt der Gast am Empfang, er möchte keine mehr, klicken Sie **Widerrufen**. Beide Knöpfe sehen nur Personen, die buchen dürfen. +- **Wiederbuchungs-Hinweis** ist eine Werbe-Mail einige Wochen nach der letzten Behandlung und braucht die Einwilligung des Gastes. Die Karte zeigt, ob der Gast eingewilligt hat. **Einwilligung anfragen** schickt ihm eine Mail (Sprache wählbar), er bestätigt per Link; erst dann kommen Hinweise. Sagt der Gast am Empfang, er möchte keine mehr, klicken Sie **Widerrufen**. In der Mail selbst kann sich der Gast über den Link unten abmelden; viele Mailprogramme bieten dafür auch einen Knopf **Abmelden** an, der ohne Rückfrage wirkt. Beide Knöpfe sehen nur Personen, die buchen dürfen. ## Gut zu wissen {#gut-zu-wissen}