diff --git a/app/Actions/AssignOccupationGuest.php b/app/Actions/AssignOccupationGuest.php index dea3baf..0316952 100644 --- a/app/Actions/AssignOccupationGuest.php +++ b/app/Actions/AssignOccupationGuest.php @@ -13,7 +13,7 @@ class AssignOccupationGuest { - /** @param array{first_name?: string, last_name?: ?string, email?: ?string, phone?: ?string} $details */ + /** @param array{first_name?: string, last_name?: ?string, email?: ?string, phone?: ?string, street?: ?string, postal_code?: ?string, city?: ?string, country?: ?string, notes?: ?string, tags?: ?array} $details */ public function handle(Booking|BlockedPeriod $occupation, ?int $guestId, array $details = []): Guest { Gate::authorize('update', $occupation); @@ -33,8 +33,15 @@ public function handle(Booking|BlockedPeriod $occupation, ?int $guestId, array $ 'last_name' => ['nullable', 'string', 'max:255'], 'email' => ['nullable', 'email', 'max:255'], 'phone' => ['nullable', 'string', 'max:50'], + 'street' => ['nullable', 'string', 'max:255'], + 'postal_code' => ['nullable', 'string', 'max:20'], + 'city' => ['nullable', 'string', 'max:255'], + 'country' => ['nullable', 'string', 'size:2', 'regex:/^[A-Z]{2}$/'], + 'notes' => ['nullable', 'string'], + 'tags' => ['nullable', 'array'], + 'tags.*' => ['string', 'max:255'], ])->validate(); - $guest = new Guest([...$data, 'last_name' => $data['last_name'] ?? '', 'email' => filled($data['email'] ?? null) ? mb_strtolower(trim($data['email'])) : null]); + $guest = new Guest([...$data, 'last_name' => $data['last_name'] ?? '', 'email' => filled($data['email'] ?? null) ? mb_strtolower(trim($data['email'])) : null, 'country' => $data['country'] ?? 'DE']); $guest->forceFill(['tenant_id' => $record->tenant_id])->save(); } $record->forceFill(['guest_id' => $guest->id])->save(); diff --git a/app/Filament/Actions/AssignGuestAction.php b/app/Filament/Actions/AssignGuestAction.php index e903262..2b0d116 100644 --- a/app/Filament/Actions/AssignGuestAction.php +++ b/app/Filament/Actions/AssignGuestAction.php @@ -4,13 +4,14 @@ use App\Actions\AssignOccupationGuest; use App\Enums\OccupationKind; +use App\Filament\Resources\Guests\Schemas\GuestForm; use App\Models\BlockedPeriod; use App\Models\Booking; use App\Models\Guest; use Filament\Actions\Action; use Filament\Forms\Components\Select; -use Filament\Forms\Components\TextInput; use Filament\Notifications\Notification; +use Filament\Schemas\Components\Section; use Filament\Schemas\Components\Utilities\Get; class AssignGuestAction @@ -18,12 +19,13 @@ class AssignGuestAction public static function make(): Action { return Action::make('assignGuest')->label('Gast zuordnen') + ->modalWidth('3xl') ->visible(fn (Booking|BlockedPeriod $record): bool => auth()->user()?->can('update', $record) && ($record instanceof Booking || (! $record->trashed() && ! $record->is_representation && $record->occupationKind() === OccupationKind::Reservation))) ->authorize(fn (Booking|BlockedPeriod $record): bool => auth()->user()?->can('update', $record) ?? false) ->modalDescription('Einen vorhandenen Gast persönlich auswählen oder einen neuen Gast anlegen. Ein Namensfragment ist kein Identitätsnachweis. Die Zuordnung versendet keine Nachricht und ändert keine Belegungszeiträume.') ->fillForm(fn (Booking|BlockedPeriod $record): array => [ - 'mode' => 'existing', 'guest_id' => $record->guest_id, + 'mode' => 'existing', 'guest_id' => $record->guest_id, 'country' => 'DE', 'first_name' => $record instanceof BlockedPeriod ? ($record->ical_interpretation['fields']['guest_first_name'] ?? '') : '', ]) ->schema([ @@ -34,11 +36,10 @@ public static function make(): Action ->orderBy('last_name')->orderBy('id')->limit(50)->get()->mapWithKeys(fn (Guest $guest): array => [$guest->id => $guest->full_name.($guest->email ? ' · '.$guest->email : ' · E-Mail unbekannt')])->all()) ->getOptionLabelUsing(fn ($value): ?string => Guest::find($value)?->full_name) ->visible(fn (Get $get): bool => $get('mode') === 'existing')->required(fn (Get $get): bool => $get('mode') === 'existing'), - TextInput::make('first_name')->label('Vorname / verfügbarer Namensbestandteil')->maxLength(255) - ->visible(fn (Get $get): bool => $get('mode') === 'new')->required(fn (Get $get): bool => $get('mode') === 'new'), - TextInput::make('last_name')->label('Nachname, sofern bekannt')->maxLength(255)->visible(fn (Get $get): bool => $get('mode') === 'new'), - TextInput::make('email')->label('E-Mail, sofern bekannt')->email()->maxLength(255)->visible(fn (Get $get): bool => $get('mode') === 'new'), - TextInput::make('phone')->label('Telefon, sofern bekannt')->maxLength(50)->visible(fn (Get $get): bool => $get('mode') === 'new'), + Section::make('Kontakt & Adresse')->columns(2)->visible(fn (Get $get): bool => $get('mode') === 'new') + ->schema(GuestForm::contactFields()), + Section::make('Notizen & Markierungen')->visible(fn (Get $get): bool => $get('mode') === 'new') + ->schema(GuestForm::personalFields()), ]) ->action(function (Booking|BlockedPeriod $record, array $data, AssignOccupationGuest $assign): void { $assign->handle($record, $data['mode'] === 'existing' ? (int) $data['guest_id'] : null, $data); diff --git a/app/Filament/Resources/Guests/Schemas/GuestForm.php b/app/Filament/Resources/Guests/Schemas/GuestForm.php index 0590d5e..d5eebd2 100644 --- a/app/Filament/Resources/Guests/Schemas/GuestForm.php +++ b/app/Filament/Resources/Guests/Schemas/GuestForm.php @@ -21,26 +21,11 @@ public static function configure(Schema $schema): Schema Section::make('Kontakt') ->columnSpan(2) ->columns(2) - ->schema([ - TextInput::make('first_name')->label('Vorname')->required()->maxLength(255), - TextInput::make('last_name')->label('Nachname')->maxLength(255)->dehydrateStateUsing(fn (?string $state): string => $state ?? ''), - TextInput::make('email')->label('E-Mail')->email()->maxLength(255)->dehydrateStateUsing(fn (?string $state): ?string => filled($state) ? $state : null)->helperText('Bei Portalgästen gegebenenfalls noch unbekannt. Keine Ersatzadresse eintragen.'), - TextInput::make('phone')->label('Telefon')->tel()->maxLength(50), - TextInput::make('street')->label('Straße')->maxLength(255), - TextInput::make('postal_code')->label('PLZ')->maxLength(20), - TextInput::make('city')->label('Ort')->maxLength(255), - Select::make('country') - ->label('Land') - ->options(['DE' => 'Deutschland', 'AT' => 'Österreich', 'CH' => 'Schweiz', 'NL' => 'Niederlande', 'DK' => 'Dänemark', 'PL' => 'Polen']) - ->default('DE') - ->required(), - ]), + ->schema(static::contactFields()), Section::make('Verwaltung') ->columnSpan(1) ->schema([ - TagsInput::make('tags') - ->label('Markierungen') - ->suggestions(['Stammgast', 'Familie', 'Empfehlung', 'Nicht wieder vermieten']), + ...static::personalFields(), TextEntry::make('marketing_consent_at') ->label('Einwilligung Angebote per E-Mail') ->state(fn (?Guest $record): string => $record?->marketing_consent_at ? 'bestätigt am '.$record->marketing_consent_at->format('d.m.Y') : 'keine'), @@ -48,8 +33,33 @@ public static function configure(Schema $schema): Schema ->label('Anonymisiert') ->dateTime('d.m.Y') ->visible(fn (?Guest $record): bool => $record?->anonymized_at !== null), - Textarea::make('notes')->label('Notizen')->rows(5), ]), ]); } + + /** @return array */ + public static function contactFields(): array + { + return [ + TextInput::make('first_name')->label('Vorname')->required()->maxLength(255), + TextInput::make('last_name')->label('Nachname')->maxLength(255)->dehydrateStateUsing(fn (?string $state): string => $state ?? ''), + TextInput::make('email')->label('E-Mail')->email()->maxLength(255)->dehydrateStateUsing(fn (?string $state): ?string => filled($state) ? $state : null)->helperText('Bei Portalgästen gegebenenfalls noch unbekannt. Keine Ersatzadresse eintragen.'), + TextInput::make('phone')->label('Telefon')->tel()->maxLength(50), + TextInput::make('street')->label('Straße')->maxLength(255), + TextInput::make('postal_code')->label('PLZ')->maxLength(20), + TextInput::make('city')->label('Ort')->maxLength(255), + Select::make('country')->label('Land') + ->options(['DE' => 'Deutschland', 'AT' => 'Österreich', 'CH' => 'Schweiz', 'NL' => 'Niederlande', 'DK' => 'Dänemark', 'PL' => 'Polen']) + ->default('DE')->required(), + ]; + } + + /** @return array */ + public static function personalFields(): array + { + return [ + TagsInput::make('tags')->label('Markierungen')->suggestions(['Stammgast', 'Familie', 'Empfehlung', 'Nicht wieder vermieten']), + Textarea::make('notes')->label('Notizen')->rows(5), + ]; + } } diff --git a/docs/STATUS.md b/docs/STATUS.md index a097594..1c9a740 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -4,6 +4,8 @@ # Projektstand > Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“). +**Vollständige Gästeanlage im Zuordnungsdialog (27.10.2026):** „Gast zuordnen → Neuen Gast anlegen“ bietet dieselben Kontakt- und Adressfelder wie die Gästekartei, zusätzlich Notizen und Markierungen. Ein erneuter Aufruf der Gästekartei entfällt für die Ersterfassung. Speicherung und Validierung in `AssignOccupationGuest` um diese Angaben erweitert; Auswahl bestehender Gäste überschreibt deren Stammdaten nicht. Keine Schemaänderung oder automatische Änderung vorhandener Gäste. **44 relevante Tests / 265 Assertions erfolgreich, Pint erfolgreich.** Bereitstellung über die vorhandene Pipeline vorbereitet; Auslieferungsnachweis folgt. + **Zentrale Belegungsverwaltung bereitgestellt (27.10.2026):** Belegungsplan je Wohnung mit Monats-/Mobilansicht, freien Nächten, Wechseln, Kanal, Gast und Status; gemeinsame Liste eigener Anfragen/Buchungen und erkannter Portalreservierungen; plattformübergreifende Gästezuordnung und gemeinsame Aufenthaltshistorie. Sperrzeiten auf ausdrückliche Sperren begrenzt, eigener Klärungsbereich mit Originaldaten und persönlicher Einordnung. **Entscheidung Lars: Gastzuordnung bei Portalreservierungen zunächst offen lassen**, keine automatische Anlage anhand eines Namensfragments. Fehlende Kontaktdaten sind erlaubt, Mailabläufe entsprechend abgesichert; Portalaufenthalte werden bei Anonymisierung und Stammgast-Auswahl berücksichtigt. Importidentitäten, Datumslogik und Herkunftsschutz weiterverwendet, keine automatische Datumszusammenführung oder erfundene Preis-/Vertragsdaten. Additive Zuordnungsfelder und nullable Gast-E-Mail in Migration `2026_10_27_212523_add_guest_assignment_for_portal_occupations` in MariaDB-Batch 19 bestätigt. [Fachliche Bedienung und Grenzen](architecture/ical-kanalkonfiguration.md#zentrale-belegungsverwaltung). **433 Feature-Tests / 2063 Assertions lokal erfolgreich, darunter 24 neue Prüffälle; Pint und Vite-Build erfolgreich.** Bestehende Herkunfts-/Synchronisations- und Buchungsworkflow-Tests grün. Pipeline 4671 mit Tests/Build, Sicherung und Deployment erfolgreich, finale Serverrevision `f19d698` und Release `20261027205911-f19d6982` bestätigt; vorausgehende Bereitstellung 4670 ebenfalls erfolgreich. Vorher-/Nachher-Prüfung: 2 eigene Buchungen, 11 Kalenderereignisse und 2 Gäste; Bestandsfingerprint und Export bytegleich. Aktuell 3 Portalreservierungen, 8 ungeklärte Belegungen und keine ausdrückliche Sperre; alle Portal-Gastzuordnungen offen. Automatischer Import auch mit der finalen Version um 22:00:04 Uhr erfolgreich. Sperrgründe im Plan und Link zur zugeordneten Gästekartei ebenfalls bereitgestellt. Öffentliche Gesundheits-/Wohnungsseite HTTP 200, neue Verwaltungswege unangemeldet zur Anmeldung umgeleitet. Tokenfreier lokaler Vorher-/Nachher-Nachweis Git-ignoriert: `storage/app/private/occupancy-management/result.json`. Keine zusätzliche echte Browser-Sichtprüfung behauptet; Bedienabläufe mit Livewire-Interaktionstests geprüft. **n8n-Oberfläche wieder zugänglich (27.10.2026):** n8n läuft durchgehend; Port 5678 bietet intern HTTP, keinen direkten HTTPS-Zugang. Die zuvor aus der Konfiguration übernommene öffentliche HTTPS-Adresse war als Zugangslink nicht funktionsfähig. Temporären SSH-Tunnel ausschließlich an `127.0.0.1:15678` eingerichtet; http://localhost:15678 und Workflowroute mit HTTP 200 geprüft. **Lars bestätigt die erfolgreiche Anmeldung.** Serverkonfiguration, Zertifikate, n8n-Konten und Secure-Cookie-Einstellung unverändert. Der Tunnel gilt nur auf diesem Arbeitsplatz und solange er läuft; dauerhafter öffentlicher HTTPS-Zugang bleibt ungeklärt. Lokale Workflowlinks unten setzen diesen Tunnel voraus. Wiederherstellung und Diagnose: [BETRIEB.md](BETRIEB.md#zugang-zur-n8n-oberfläche-27102026). diff --git a/docs/architecture/ical-kanalkonfiguration.md b/docs/architecture/ical-kanalkonfiguration.md index 3a213a2..0ab0bb1 100644 --- a/docs/architecture/ical-kanalkonfiguration.md +++ b/docs/architecture/ical-kanalkonfiguration.md @@ -161,7 +161,7 @@ ### Zentrale Belegungsverwaltung | **Sperrzeiten** (`/admin/blocked-periods`) | Eigene ausdrückliche Sperren und persönlich als Sperrzeit bestätigte importierte Zeiträume. Allgemeine, nicht näher bekannte iCal-Sperren werden nicht automatisch als eigene Sperrzeiten ausgegeben. | | **Ungeklärte Belegungen** (`/admin/portal-occupations`) | Unbekannte Importzeiten und Prüffälle. Zusätzliche Register erlauben die Sicht auf alle Importereignisse sowie auf Einträge, die nicht mehr im Feed stehen. Details zeigen Herkunft, Originalereignis, führende Zuordnung und bekannte Gastinformationen. | -**Gastzuordnung bleibt bei Portalreservierungen zunächst offen**, entsprechend der Entscheidung von Lars. Ein Namensfragment erzeugt keinen Gast automatisch und führt keine Gäste automatisch zusammen. Über **Details → Gast zuordnen** wird ein vorhandener Gast persönlich gewählt oder ein neuer mit den bekannten Angaben angelegt. Nachname und E-Mail dürfen dabei fehlen; es werden keine Ersatzdaten erfunden. Die Zuordnung ist auch an eigenen Buchungen möglich. Sie sendet keine Nachricht, ersetzt keine Vertragsdatei und ändert keine Termine. Ein späterer Kalenderimport erhält die Gastzuordnung anhand derselben Ereignisidentität. Auch archivierte und wiederkehrende Ereignisse behalten diese Zuordnung. +**Gastzuordnung bleibt bei Portalreservierungen zunächst offen**, entsprechend der Entscheidung von Lars. Ein Namensfragment erzeugt keinen Gast automatisch und führt keine Gäste automatisch zusammen. Über **Details → Gast zuordnen** wird ein vorhandener Gast persönlich gewählt oder ein neuer mit den bekannten Angaben angelegt. Im selben Dialog stehen die vollständigen Kontakt- und Adressfelder einschließlich Straße, PLZ, Ort und Land sowie Notizen und Markierungen zur Verfügung. Ein erneutes Öffnen der Gästekartei ist für diese Eingaben nicht erforderlich. Beide Eingabewege verwenden dieselben Formularfelder. Nachname, E-Mail und Adressangaben dürfen fehlen; es werden keine Ersatzadressen erfunden. Die Zuordnung ist auch an eigenen Buchungen möglich. Beim Auswählen eines bestehenden Gastes werden dessen Stammdaten nicht überschrieben. Die Zuordnung sendet keine Nachricht, ersetzt keine Vertragsdatei und ändert keine Termine. Ein späterer Kalenderimport erhält die Gastzuordnung anhand derselben Ereignisidentität. Auch archivierte und wiederkehrende Ereignisse behalten diese Zuordnung. **Belegungsart festlegen** bestätigt eine Portalreservierung, eine ausdrückliche Sperrzeit oder einen weiterhin unbekannten Sachverhalt. Diese persönliche Einordnung bleibt gegenüber späteren iCal-Regelauswertungen erhalten. Sie schließt Überschneidungen und mögliche Mehrfachdarstellungen nicht automatisch ab; dafür bleibt **Belegung zuordnen / klären** zuständig. Die führende Buchung oder Belegung erscheint einmal im Plan und in der gemeinsamen Liste. Zugeordnete Kalenderdarstellungen bleiben in den Quelldetails nachvollziehbar. diff --git a/tests/Feature/OccupancyManagementTest.php b/tests/Feature/OccupancyManagementTest.php index 2e7a6e0..48b9f39 100644 --- a/tests/Feature/OccupancyManagementTest.php +++ b/tests/Feature/OccupancyManagementTest.php @@ -20,6 +20,7 @@ use App\Filament\Pages\OccupancyCalendar; use App\Filament\Resources\BlockedPeriods\Pages\ManageBlockedPeriods; use App\Filament\Resources\Bookings\Pages\ListBookings; +use App\Filament\Resources\Bookings\Pages\ViewBooking; use App\Filament\Resources\Guests\GuestResource; use App\Filament\Resources\Guests\Pages\CreateGuest; use App\Filament\Resources\Guests\Pages\EditGuest; @@ -163,6 +164,62 @@ public function test_guest_can_be_entered_directly_without_fabricating_unknown_c $this->assertSame(['Tanja', '', null], [Guest::sole()->first_name, Guest::sole()->last_name, Guest::sole()->email]); } + #[DataProvider('guestAssignmentSources')] + public function test_complete_guest_profile_can_be_entered_and_assigned_in_one_dialog(string $source): void + { + $property = $this->property(); + $record = $source === 'portal' ? $this->import($property, ['ical_event_type' => 'portal_reservation']) : Booking::factory()->for($property)->reserved()->create(); + $page = $source === 'portal' ? ViewPortalOccupation::class : ViewBooking::class; + $before = $record->only(['id', 'arrival', 'departure', 'starts_on', 'ends_on', 'external_uid']); + Mail::fake(); + + Livewire::test($page, ['record' => $record->id])->callAction('assignGuest', [ + 'mode' => 'new', 'first_name' => 'Samira', 'last_name' => 'Gast', 'email' => 'SAMIRA@example.test', + 'phone' => '+43 123456', 'street' => 'Seestraße 12', 'postal_code' => '1010', 'city' => 'Wien', 'country' => 'AT', + 'notes' => 'Anreise am Abend', 'tags' => ['Familie'], + ])->assertHasNoActionErrors()->assertNotified('Gast zugeordnet'); + + $guest = Guest::query()->where('email', 'samira@example.test')->sole(); + $this->assertSame(['Seestraße 12', '1010', 'Wien', 'AT', '+43 123456', 'Anreise am Abend', ['Familie']], [$guest->street, $guest->postal_code, $guest->city, $guest->country, $guest->phone, $guest->notes, $guest->tags]); + $this->assertSame($guest->id, $record->fresh()->guest_id); + $this->assertEquals($before, $record->fresh()->only(array_keys($before))); + Mail::assertNothingSent(); + } + + public static function guestAssignmentSources(): array + { + return ['portal reservation' => ['portal'], 'own booking' => ['booking']]; + } + + public function test_selecting_an_existing_guest_does_not_overwrite_their_contact_details(): void + { + $property = $this->property(); + $record = $this->import($property, ['ical_event_type' => 'portal_reservation']); + $guest = Guest::factory()->create(['tenant_id' => $property->tenant_id, 'street' => 'Bestehende Straße 1', 'postal_code' => '18225', 'city' => 'Kühlungsborn', 'country' => 'DE', 'notes' => 'Bestehende Notiz']); + $before = $guest->only(['first_name', 'last_name', 'street', 'postal_code', 'city', 'country', 'notes']); + + Livewire::test(ViewPortalOccupation::class, ['record' => $record->id])->callAction('assignGuest', [ + 'mode' => 'existing', 'guest_id' => $guest->id, 'first_name' => 'Ersetzen', 'street' => 'Andere Straße', 'city' => 'Wien', 'country' => 'AT', 'notes' => 'Nicht übernehmen', + ])->assertHasNoActionErrors(); + + $this->assertEquals($before, $guest->fresh()->only(array_keys($before))); + $this->assertSame($guest->id, $record->fresh()->guest_id); + $this->assertSame(1, Guest::count()); + } + + public function test_invalid_new_guest_address_does_not_leave_a_partial_guest_or_assignment(): void + { + $property = $this->property(); + $record = $this->import($property, ['ical_event_type' => 'portal_reservation']); + + Livewire::test(ViewPortalOccupation::class, ['record' => $record->id])->callAction('assignGuest', [ + 'mode' => 'new', 'first_name' => 'Samira', 'postal_code' => str_repeat('1', 21), 'country' => 'DE', + ])->assertHasActionErrors(['postal_code' => 'max']); + + $this->assertSame(0, Guest::count()); + $this->assertNull($record->fresh()->guest_id); + } + public function test_guest_assignment_survives_import_changes_archiving_and_return_with_same_uid(): void { $property = $this->property();