From c6d1276db1fc3c6555fe35c2db15b7a6a4462445 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 18 Nov 2026 21:48:24 +0000 Subject: [PATCH 1/2] Sauna und Ruheraum: Namen am Eintritt nachtragen MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Entscheidung des Auftraggebers: Hat ein Gast ohne Namen nur Sauna oder Ruheraum, lässt sich sein Name direkt am Eintritt nachtragen. Neuer Endpunkt am Eintritt mit demselben Kern wie am Termin; Knopf und Karte in „Sauna und Ruheraum“ der Windows-App. Paar und Spa-Tag verlegt die Rezeption weiter von Hand, in Hilfe und Stand vermerkt. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01B5RL9a5NPAggRs8rgvzbVC --- docs/stand-und-offene-punkte.md | 2 +- docs/uebergabe.md | 2 +- docs/umsetzung/handtests.md | 9 ++ docs/umsetzung/pr-protokoll.md | 17 ++++ .../Scheduling/BookingService.Placeholders.cs | 29 +++++-- .../Scheduling/CalendarEndpoints.cs | 14 +++ .../ViewModels/AreasViewModel.cs | 72 +++++++++++++++- .../Views/CalendarView.axaml | 17 +++- .../SpaDayBuilderTests.cs | 29 +++++++ .../GroupAndAreaTests.cs | 31 +++++++ .../ViewTests.CalendarFields.cs | 28 ++++++ .../ViewTests.PanelPrimary.cs | 4 +- web/openapi/aispa-api.json | 81 ++++++++++++++++++ web/src/api/schema.d.ts | 71 +++++++++++++++ .../content/dienstplan-ersatz-vorschlagen.md | 1 + .../help/content/kalender-paar-und-spa-tag.md | 3 + .../app/kalender-sauna-namen-nachtragen.png | Bin 0 -> 90632 bytes 17 files changed, 398 insertions(+), 12 deletions(-) create mode 100644 web/src/help/images/app/kalender-sauna-namen-nachtragen.png diff --git a/docs/stand-und-offene-punkte.md b/docs/stand-und-offene-punkte.md index 97753cc1..3e72b1dd 100644 --- a/docs/stand-und-offene-punkte.md +++ b/docs/stand-und-offene-punkte.md @@ -375,7 +375,7 @@ Die Nummern sind die Reihenfolge, die der jeweilige Thread gewählt hätte ([Üb **Kalender, Dienstplan, Zugänge** 1. Ausfall-Assistent: Gäste ohne Ersatz per WhatsApp informieren (per Mail und SMS seit 16.11.2026; WhatsApp braucht eine eigene freigegebene Vorlage). -2. Ausfall-Assistent: Ersatz an anderen Tagen seit 17.11.2026 gebaut (nächste 14 Tage am eigenen Standort, nicht vorausgewählt); offen: Paar- und Spa-Tag-Buchungen an einen anderen Standort oder Tag verlegen. +2. Ausfall-Assistent: Ersatz an anderen Tagen seit 17.11.2026 gebaut (nächste 14 Tage am eigenen Standort, nicht vorausgewählt); Paar- und Spa-Tag-Buchungen an einen anderen Standort oder Tag verlegt die Rezeption von Hand (Auftraggeber, 18.11.2026: bleibt Handarbeit). 3. Leerlaufzeit eines angemeldeten Empfangsgeräts ändern; Liste aller Empfangsgeräte des Spas. 4. Lücken durch Verschieben mehrerer Termine hintereinander schließen (Ketten). 5. Feiertage weiterer Kantone und einzelner Gemeinden. diff --git a/docs/uebergabe.md b/docs/uebergabe.md index 46e9268e..d97f04c9 100644 --- a/docs/uebergabe.md +++ b/docs/uebergabe.md @@ -104,7 +104,7 @@ Je Modul ausführlich in [stand-und-offene-punkte.md](stand-und-offene-punkte.md 1. **Dependabot-PRs abarbeiten** (Abschnitt 4). 2. **Prototyp unter Windows ausprobieren** (nächster Schritt des Auftraggebers laut [ADR 0019](entscheidungen/0019-autonomes-arbeiten-bis-zum-prototyp.md)): Hilfe mit WebView2, Einzelplatz, Mehrplatz im Netz, Speicher der App, ZVT/OPI an einem echten Gerät. Bisher nur unter Linux und in Tests geprüft. 3. **Windows-App** ([windows-app-2.md](uebergabe/threads/windows-app-2.md)): neuen Kunden aus der Leiste „KI und Hilfe“ anlegen; Handbuch-Bild `web-calendar-assistent.png` neu erzeugen; Lotus-Knopf verdeckt auf manchen Seiten die rechte untere Ecke; Verwaltung über Aspire beim Auftraggeber prüfen (Ursache der fehlenden Weiterleitung API → Vite ungeklärt, #145 umgeht sie); Kassa ohne Verbindung mit Ersatzbelegen nach RKSV; Anzahlung anzeigen; Pakete in der Web-Kassa. -4. **Kalender:** Ausfall-Assistent zu Ende denken (Gäste ohne Ersatz per SMS/WhatsApp, andere Tage, Paar und Spa-Tag verlegen), Empfangsgeräte verwalten, Lückenketten; aus den Rezeptions-Schritten: „Kommt später“ durch den Gast selbst, Sauna und Ausfallgebühr für Gäste ohne Namen, Wunsch ♀/♂ online, Anamnese-Hinweis bei Paar, Spa-Tag und in „Mein Tag“, automatische Vorschläge für Kennzeichen. +4. **Kalender:** Ausfall-Assistent zu Ende denken (Gäste ohne Ersatz per SMS/WhatsApp, andere Tage; Paar und Spa-Tag verlegen bleibt laut Auftraggeber vom 18.11.2026 Handarbeit), Empfangsgeräte verwalten, Lückenketten; aus den Rezeptions-Schritten: „Kommt später“ durch den Gast selbst, Sauna und Ausfallgebühr für Gäste ohne Namen, Wunsch ♀/♂ online, Anamnese-Hinweis bei Paar, Spa-Tag und in „Mein Tag“, automatische Vorschläge für Kennzeichen. 5. **Kundenbereich:** Erinnerung vor Fristablauf, Anzahlung per Link, Links per SMS, Bestätigung der E-Mail vor einer Gastbuchung, Gutschein mit Anzahlung verrechnen, Absage eines späteren Termins, Teilerstattung. 6. **KI-Terminannahme:** Wissensbasis des Spas, Einwilligung beim Online-Buchen, Ansage je Spa, lokale KI mit echten Mails prüfen und Schalter in der App für den Einzelplatz. 7. **Kassa und Lager:** wackeligen Test `CardGuaranteeTests…Frist_freigegeben` robust machen, Schweizer UID-Register, Preisregeln für Eintritte und Artikel, Prüfprogramm der Finanzverwaltung, Rückverfolgung exportieren. diff --git a/docs/umsetzung/handtests.md b/docs/umsetzung/handtests.md index 46861866..6c3248ad 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: ☐ +### Sauna und Ruheraum – Namen am Eintritt nachtragen +Start: `dotnet run --project src/AispaStudio.AppHost`, Windows-App als Rezeption; am Standort gibt es eine Sauna als Bereich +1. **Paar oder Spa-Tag** mit Gast 1 aus der Kartei (Massage) und Gast 2 mit **Name folgt** buchen, Gast 2 bekommt nur die Sauna. +Expected: In **Sauna und Ruheraum** steht der Eintritt „Gast 2 · Name folgt“ mit **Namen nachtragen** darunter. +2. **Namen nachtragen** klicken, einen Gast suchen und **Gast eintragen** klicken. +Expected: Der Eintritt trägt den Namen des Gastes; die Massage von Gast 1 bleibt bei Gast 1. +Closes: – +Result: ☐ + ### Paar und Spa-Tag – Ausfallgebühr für einen Gast ohne Namen Start: `dotnet run --project src/AispaStudio.AppHost`, Windows-App als Rezeption; am Standort ist eine Ausfallgebühr eingestellt, Zahlungsanbieter im Testbetrieb; die buchende Person hat eine Mailadresse 1. **Paar oder Spa-Tag** mit Gast 1 aus der Kartei und Gast 2 mit **Name folgt** buchen, den Termin von Gast 2 öffnen und **Karte per Link anfordern** klicken. diff --git a/docs/umsetzung/pr-protokoll.md b/docs/umsetzung/pr-protokoll.md index 2f7f0d42..e7c961d3 100644 --- a/docs/umsetzung/pr-protokoll.md +++ b/docs/umsetzung/pr-protokoll.md @@ -7289,3 +7289,20 @@ Auftraggeber (23.10.2026): „Räume sollen wie Urlaub auch gesperrt werden kön - **Geprüft:** API `CardGuaranteeTests`, `DepositTests`, `OnlineBookingTests`, `GroupBookingTests`, `OnlineRefundTests`, `ChannelScanTests`: 100 von 100. Neu: Mail an die buchende Person mit Gastnummer; nach dem Nachtragen öffnet ihr Link die Seite ohne Absagen und Verschieben; Absagen über den Link 404; Zustimmen und Hinterlegen gehen; Hinweis für das Team; Termin gehört dem Gast. - **Nicht geprüft:** die laufende App unter Windows; echte Belastung beim Anbieter. - **Text-Prüfung:** von Hand nach [texte.md](../gestaltung/texte.md). + +## Sauna und Ruheraum: Namen am Eintritt nachtragen (18.11.2026) + +- **Auftrag:** Entscheidung des Auftraggebers am 18.11.2026: Für einen Gast ohne Namen, der in der Buchung nur Sauna oder Ruheraum hat, lässt sich der Name direkt am Eintritt nachtragen. Paar und Spa-Tag im Ausfall-Assistenten an einen anderen Tag oder Standort verlegen bleibt Handarbeit. +- **Befund:** Namen nachtragen ging nur über einen Termin. Ein Gast mit nur einem Eintritt blieb „Gast 2 · Name folgt“. +- **Was:** + - `PUT /api/locations/{id}/area-visits/{visitId}/guest` (Buchen): trägt den Gast bei allen Eintritten und Terminen dieses Gastes in der Buchung ein. + - `BookingService.AssignVisitGuestAsync` nutzt denselben Kern wie das Nachtragen am Termin (`AssignAsync`), samt Prüfung „Nicht bei mir“. + - Windows-App: **Namen nachtragen** unter einem solchen Eintritt in **Sauna und Ruheraum**; eine Karte mit Suche und **Gast eintragen**. + - Hilfe `kalender-paar-und-spa-tag` mit Bild `kalender-sauna-namen-nachtragen.png`; in `dienstplan-ersatz-vorschlagen` der Hinweis, dass Paar und Spa-Tag von Hand verlegt werden. Stand und Übergabe ergänzt. +- **Detailentscheidungen:** + 1. Eigene Suche für den Gast in der Karte, damit ein angefangener neuer Eintritt stehen bleibt. + 2. **Gast eintragen** ist kein Hauptknopf: Strg+S bleibt beim Buchen eines neuen Eintritts. + 3. Der Knopf steht in einer eigenen Zeile unter dem Eintritt; daneben war in der schmalen Liste kein Platz für den Namen. +- **Geprüft:** API `SpaDayBuilderTests`, `GroupBookingTests`, `CardGuaranteeTests`, `ChannelScanTests` 38 von 38 (neu: Name am Eintritt, Massage der buchenden Person bleibt, zweites Mal 400, fremder Standort 404); Windows-App `GroupAndAreaTests` 15 von 15 (neu: Knopf nur am Gast ohne Namen, Aufruf mit Kunde, Meldung), Ansichtstest, Prüfungen der Knöpfe (165), Strg+S (52), „höchstens“ (33) grün. Die Prüfung „Abbrechen ist ein Ghost-Knopf“ zählt jetzt neun Stellen. +- **Nicht geprüft:** die laufende App unter Windows. +- **Text-Prüfung:** von Hand nach [texte.md](../gestaltung/texte.md). diff --git a/src/AispaStudio.Api/Scheduling/BookingService.Placeholders.cs b/src/AispaStudio.Api/Scheduling/BookingService.Placeholders.cs index c17ffa99..b1f22199 100644 --- a/src/AispaStudio.Api/Scheduling/BookingService.Placeholders.cs +++ b/src/AispaStudio.Api/Scheduling/BookingService.Placeholders.cs @@ -6,7 +6,7 @@ namespace AispaStudio.Api.Scheduling; // ---------- Gruppen mit Gästen ohne Namen: Namen später nachtragen ---------- internal sealed partial class BookingService { - /// Trägt den Gast für einen Platzhalter ein, bei allen Terminen dieses Gastes in der Buchung. + /// Trägt den Gast für einen Platzhalter ein, bei allen Terminen und Eintritten dieses Gastes in der Buchung. public async Task AssignGuestAsync(Guid id, Guid customerId, CancellationToken ct) { var appointment = await LoadAsync(id, ct); @@ -15,11 +15,30 @@ public async Task AssignGuestAsync(Guid id, Guid customerId, Can return new BookingOutcome.NotFound("Termin"); } - if (appointment.PlaceholderGuest is not { } guest || appointment.GroupId is not { } groupId) + return appointment.PlaceholderGuest is not { } guest || appointment.GroupId is not { } groupId + ? new BookingOutcome.Invalid(nameof(AssignGuestRequest.CustomerId), "Der Termin hat schon einen Gast.") + : await AssignAsync(groupId, guest, appointment.CustomerId, customerId, ct); + } + + /// + /// Wie , aber vom Eintritt in Sauna oder Ruheraum aus: für einen Gast ohne Namen, der in der Buchung nur einen + /// Bereich hat (Auftraggeber, 18.11.2026). Hat er auch Termine, bekommen sie den Gast ebenso. + /// + public async Task AssignVisitGuestAsync(Guid locationId, Guid visitId, Guid customerId, CancellationToken ct) + { + var visit = await db.AreaVisits.AsNoTracking().FirstOrDefaultAsync(v => v.Id == visitId && v.LocationId == locationId, ct); + if (visit is null) { - return new BookingOutcome.Invalid(nameof(AssignGuestRequest.CustomerId), "Der Termin hat schon einen Gast."); + return new BookingOutcome.NotFound("Eintritt"); } + return visit.PlaceholderGuest is not { } guest || visit.GroupId is not { } groupId || visit.IsCancelled + ? new BookingOutcome.Invalid(nameof(AssignGuestRequest.CustomerId), "Der Eintritt hat schon einen Gast.") + : await AssignAsync(groupId, guest, visit.CustomerId, customerId, ct); + } + + private async Task AssignAsync(Guid groupId, int guest, Guid bookerId, Guid customerId, CancellationToken ct) + { if (await db.Customers.FirstOrDefaultAsync(c => c.Id == customerId, ct) is not { } customer) { return new BookingOutcome.NotFound("Kunde"); @@ -31,7 +50,7 @@ public async Task AssignGuestAsync(Guid id, Guid customerId, Can } var parts = await db.Appointments.Include(a => a.Customer).Include(a => a.Treatment) - .Where(a => a.GroupId == groupId && a.PlaceholderGuest == guest && a.CustomerId == appointment.CustomerId + .Where(a => a.GroupId == groupId && a.PlaceholderGuest == guest && a.CustomerId == bookerId && a.Status != AppointmentStatus.Cancelled) .OrderBy(a => a.Start) .ToListAsync(ct); @@ -44,7 +63,7 @@ public async Task AssignGuestAsync(Guid id, Guid customerId, Can // Sauna und Ruheraum des Gastes gehören mit: sie tragen dieselbe Nummer und laufen bis jetzt auf die buchende Person. var visits = await db.AreaVisits.Include(v => v.Customer) - .Where(v => v.GroupId == groupId && v.PlaceholderGuest == guest && v.CustomerId == appointment.CustomerId && !v.IsCancelled) + .Where(v => v.GroupId == groupId && v.PlaceholderGuest == guest && v.CustomerId == bookerId && !v.IsCancelled) .ToListAsync(ct); var now = time.GetUtcNow(); foreach (var part in parts) diff --git a/src/AispaStudio.Api/Scheduling/CalendarEndpoints.cs b/src/AispaStudio.Api/Scheduling/CalendarEndpoints.cs index 1f9aad77..b3f6e7a1 100644 --- a/src/AispaStudio.Api/Scheduling/CalendarEndpoints.cs +++ b/src/AispaStudio.Api/Scheduling/CalendarEndpoints.cs @@ -503,6 +503,20 @@ await areas.DayAsync(locationId, date, ct) is { } day ? TypedResults.Ok(day) : T .RequirePermission(AccessRight.Book) .WithSummary("Storniert einen Eintritt und gibt die Plätze frei."); + group.MapPut("/locations/{locationId:guid}/area-visits/{visitId:guid}/guest", async Task, ValidationProblem, ProblemHttpResult, Conflict>> ( + Guid locationId, Guid visitId, AssignGuestRequest request, BookingService booking, CancellationToken ct) => + await booking.AssignVisitGuestAsync(locationId, visitId, request.CustomerId, ct) switch + { + BookingOutcome.GroupBooked g => TypedResults.Ok(g.Result), + BookingOutcome.NotFound n => NotFound(n), + BookingOutcome.Invalid i => Invalid(i), + BookingOutcome.Rejected r => TypedResults.Conflict(r.Reason), + var other => throw Unexpected(other), + }) + .WithName("AssignPlaceholderAreaGuest") + .RequirePermission(AccessRight.Book) + .WithSummary("Trägt für einen Gast ohne Namen den Gast vom Eintritt in Sauna oder Ruheraum aus ein, bei allen seinen Eintritten und Terminen der Buchung."); + group.MapPost("/blocks", async Task, ValidationProblem, Conflict>> ( BlockInput input, AispaDbContext db, BookingService booking, CancellationToken ct) => { diff --git a/src/AispaStudio.Desktop/ViewModels/AreasViewModel.cs b/src/AispaStudio.Desktop/ViewModels/AreasViewModel.cs index ddefea5a..3d28cd5d 100644 --- a/src/AispaStudio.Desktop/ViewModels/AreasViewModel.cs +++ b/src/AispaStudio.Desktop/ViewModels/AreasViewModel.cs @@ -30,8 +30,14 @@ public static AreaGlance Of(AreaDay day, DateTimeOffset now, bool isToday) /// Ein Eintritt in der Liste eines Bereichs. public sealed partial class AreaVisitRow(AreaVisitDto visit, TimeZoneInfo zone, bool canCancel, Func cancel, - Func? checkout = null, bool isPending = false) + Func? checkout = null, bool isPending = false, Action? name = null) { + /// „Namen nachtragen“: ein Gast ohne Namen aus einer Gruppe (Auftraggeber, 18.11.2026), mit dem Recht zu buchen. + public bool CanName { get; } = canCancel && name is not null && visit.PlaceholderGuest is not null && !visit.IsCancelled && !isPending; + + [RelayCommand] + private void NameGuest() => name?.Invoke(this); + /// Ohne Verbindung vorgemerkt: noch nicht beim Server, deshalb weder stornierbar noch an der Kassa. public bool IsPending { get; } = isPending; @@ -308,7 +314,7 @@ private AreaCard Card(AreaDay day, DateTimeOffset open, DateTimeOffset close, Ha } var visits = day.Visits.OrderBy(v => v.IsCancelled).ThenBy(v => v.From) - .Select(v => new AreaVisitRow(v, _zone, CanBook, AskCancelAsync, _checkout, pending.Contains(v.Id))).ToList(); + .Select(v => new AreaVisitRow(v, _zone, CanBook, AskCancelAsync, _checkout, pending.Contains(v.Id), StartNaming)).ToList(); return new AreaCard(day, summary, bars, visits, $"{DayLayout.Local(open, _zone):HH:mm}", $"{DayLayout.Local(close, _zone):HH:mm}"); } @@ -352,6 +358,68 @@ private async Task BookAsync() await LoadAsync().ConfigureAwait(true); } + // ---------- Namen nachtragen für einen Gast ohne Namen ---------- + + /// Der Eintritt, für den gerade ein Name nachgetragen wird; sonst null. + [ObservableProperty] + [NotifyPropertyChangedFor(nameof(IsNaming), nameof(NamingTitle))] + public partial AreaVisitRow? Naming { get; private set; } + + public bool IsNaming => Naming is not null; + + public string NamingTitle => Naming is { } row ? $"Namen nachtragen: {row.Name}" : ""; + + /// Suche für den Gast, der eingetragen wird; eigene Suche, damit ein angefangener neuer Eintritt stehen bleibt. + public CustomerSearchViewModel GuestSearch => _guestSearch ??= NewGuestSearch(); + + private CustomerSearchViewModel? _guestSearch; + + private CustomerSearchViewModel NewGuestSearch() + { + var search = new CustomerSearchViewModel(_api); + search.Changed += () => AssignGuestCommand.NotifyCanExecuteChanged(); + return search; + } + + private void StartNaming(AreaVisitRow row) + { + Error = null; + Info = null; + GuestSearch.Customer = null; + GuestSearch.Query = ""; + Naming = row; + } + + [RelayCommand] + private void CancelNaming() => Naming = null; + + private bool CanAssignGuest => Naming is not null && !Busy && GuestSearch.HasCustomer; + + /// Trägt den Gast ein: bei allen seinen Eintritten und Terminen der Buchung (der Server sucht sie über die Gastnummer). + [RelayCommand(CanExecute = nameof(CanAssignGuest))] + private async Task AssignGuestAsync() + { + if (Naming is not { } row || GuestSearch.Customer is not { } customer) + { + return; + } + + Error = null; + Busy = true; + var result = await _api.PutAsync($"api/locations/{_locationId}/area-visits/{row.Visit.Id}/guest", + new AssignGuestRequest(customer.Id)).ConfigureAwait(true); + Busy = false; + if (result.Value is null) + { + Error = result.Error; + return; + } + + Info = $"{row.Name}: jetzt {GuestSearch.Name}."; + Naming = null; + await LoadAsync().ConfigureAwait(true); + } + /// Eintritt stornieren fragt nach (Rückfragedialog, Design-Brief 5.27). private async Task AskCancelAsync(AreaVisitDto visit) { diff --git a/src/AispaStudio.Desktop/Views/CalendarView.axaml b/src/AispaStudio.Desktop/Views/CalendarView.axaml index c02a69ec..2d549038 100644 --- a/src/AispaStudio.Desktop/Views/CalendarView.axaml +++ b/src/AispaStudio.Desktop/Views/CalendarView.axaml @@ -1672,18 +1672,22 @@ - + + +