Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
4 changes: 2 additions & 2 deletions docs/stand-und-offene-punkte.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)).
Expand Down
9 changes: 9 additions & 0 deletions docs/umsetzung/handtests.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
18 changes: 18 additions & 0 deletions docs/umsetzung/pr-protokoll.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
10 changes: 9 additions & 1 deletion src/AispaStudio.Api/Mail/Mail.cs
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ namespace AispaStudio.Api.Mail;
/// <param name="ListUnsubscribe">Adresse zum Abmelden (https) für die Kopfzeile <c>List-Unsubscribe</c>; nur bei Mails nach Einwilligung (ADR 0040), damit das Mailprogramm „Abmelden“ anbietet.</param>
/// <param name="ReplyTo">Adresse für Antworten des Empfängers, z. B. das Postfach des Spas, wenn über den gemeinsamen Versand gesendet wird.</param>
/// <param name="FromName">Anzeigename des Absenders, z. B. der Name des Spas; ohne Angabe der aus <see cref="MailOptions"/>.</param>
/// <param name="OneClickUnsubscribe">
/// <c>ListUnsubscribe</c> nimmt ein POST ohne Rückfrage an (RFC 8058): dazu die Kopfzeile <c>List-Unsubscribe-Post</c>, damit das Mailprogramm mit einem Klick abmeldet.
/// </param>
/// <param name="Attachments">Anhänge, z. B. ein Beleg als PDF (ADR 0092); zusammen höchstens <see cref="MaxAttachmentBytes"/>.</param>
public sealed record OutgoingMail(
string To,
Expand All @@ -20,7 +23,8 @@ public sealed record OutgoingMail(
string? ReplyTo = null,
string? FromName = null,
IReadOnlyList<MailAttachment>? Attachments = null,
string? ListUnsubscribe = null)
string? ListUnsubscribe = null,
bool OneClickUnsubscribe = false)
{
/// <summary>5 MB je Mail: mehr nehmen viele Postfächer nicht an, und die Queue trägt den Anhang mit.</summary>
public const int MaxAttachmentBytes = 5 * 1024 * 1024;
Expand Down Expand Up @@ -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)
Expand Down
3 changes: 3 additions & 0 deletions src/AispaStudio.Api/Online/OnlinePortal.cs
Original file line number Diff line number Diff line change
Expand Up @@ -423,6 +423,9 @@ orderby v.CreatedAt descending
.ToListAsync(ct);
}

/// <summary>Adresse eines öffentlichen Endpunkts der API unter der Adresse des Kundenbereichs, z. B. für das Abmelden mit einem Klick.</summary>
public string ApiUrl(string path) => $"{Options.PublicUrl.TrimEnd('/')}/{path.TrimStart('/')}";

/// <summary>Link in den Kundenbereich (Hash-Route, damit der Code nicht in Server-Logs landet).</summary>
/// <param name="spa">Mandant für Links, die ohne Kundin funktionieren müssen (z. B. Buchung aus der Warteliste).</param>
public string Url(string route, Guid? spa = null) =>
Expand Down
13 changes: 11 additions & 2 deletions src/AispaStudio.Api/Retention/MarketingConsents.cs
Original file line number Diff line number Diff line change
Expand Up @@ -190,8 +190,17 @@ public async Task<Outcome> DecideAsync(Guid customerId, MarketingConsentState st
}

/// <summary>Neuer Abmeldelink für eine Erinnerung; gespeichert wird er mit dem nächsten <c>SaveChanges</c> des Kundenbereichs.</summary>
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;

/// <summary>
/// Abmelden für eine Erinnerung, mit einem Code: <c>Page</c> ist die Seite im Kundenbereich (für den Text der Mail), <c>OneClick</c> die Adresse für
/// die Kopfzeile <c>List-Unsubscribe</c>. Ein POST dorthin meldet ohne Rückfrage ab (RFC 8058), ein GET leitet nur auf die Seite weiter.
/// </summary>
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<OnlineConsentDto?> ForTokenAsync(string token, CancellationToken ct) =>
await FindAsync(token, ct) is { } found ? await ToOnlineAsync(found.Consent, ct) : null;
Expand Down
8 changes: 4 additions & 4 deletions src/AispaStudio.Api/Retention/Rebooking.cs
Original file line number Diff line number Diff line change
Expand Up @@ -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)
{
Expand Down Expand Up @@ -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
{
Expand All @@ -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);
}
}
13 changes: 13 additions & 0 deletions src/AispaStudio.Api/Retention/RetentionEndpoints.cs
Original file line number Diff line number Diff line change
Expand Up @@ -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<Results<Ok, NotFound>> (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;
}

Expand Down
7 changes: 7 additions & 0 deletions tests/AispaStudio.Api.Tests/MailboxAdapterTests.cs
Original file line number Diff line number Diff line change
Expand Up @@ -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("<https://spa.example/einwilligung/abc>", 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("<https://spa.example/api/online/consent/abc/unsubscribe>", oneClick.Headers[HeaderId.ListUnsubscribe]);
Assert.Equal("List-Unsubscribe=One-Click", oneClick.Headers["List-Unsubscribe-Post"]);
}

[Fact]
Expand Down
22 changes: 16 additions & 6 deletions tests/AispaStudio.Api.Tests/RetentionTests.cs
Original file line number Diff line number Diff line change
Expand Up @@ -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<MarketingConsentDto>($"/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<OnlineConsentDto>(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<string, string>("List-Unsubscribe", "One-Click")]), Ct);
Assert.Equal(HttpStatusCode.OK, oneClick.StatusCode);
Assert.Equal(MarketingConsentState.Withdrawn, (await spa.GetAsync<MarketingConsentDto>($"/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<MarketingConsentDto>($"/api/customers/{guest.Id}/marketing-consent", Ct)).State);
}

Expand Down
Loading