diff --git a/app/Actions/ApplyChannelRules.php b/app/Actions/ApplyChannelRules.php index b691187..d12cea2 100644 --- a/app/Actions/ApplyChannelRules.php +++ b/app/Actions/ApplyChannelRules.php @@ -50,7 +50,10 @@ public function handle(Channel $channel): array $event = $events->get($block->external_uid); if ($event && $block->ical_raw !== null && $channel->ical_analyzed_at !== null && $block->updated_at->greaterThan($channel->ical_analyzed_at) && $block->ical_raw !== $event['raw']) { - throw ValidationException::withMessages(['rules' => 'Der Importbestand hat sich seit der Vorschau geändert. Den Kalender erneut analysieren und die Vorschau prüfen.']); + if (! $this->hasEquivalentTimestampUpdate($channel, $block, $event)) { + throw ValidationException::withMessages(['rules' => 'Der Importbestand hat sich seit der Vorschau geändert. Den Kalender erneut analysieren und die Vorschau prüfen.']); + } + $event = [...$event, 'properties' => $block->ical_properties, 'raw' => $block->ical_raw]; } $properties = $event['properties'] ?? $block->ical_properties; if ($properties === null) { @@ -69,4 +72,20 @@ public function handle(Channel $channel): array return $counts; }); } + + private function hasEquivalentTimestampUpdate(Channel $channel, BlockedPeriod $block, array $event): bool + { + if ($block->ical_properties === null) { + return false; + } + + $withoutTimestamps = fn (string $raw): string => preg_replace('/^(?:DTSTAMP|LAST-MODIFIED)(?:;[^:\r\n]*)?:[^\r\n]*(?:\r\n|\n|$)/mi', '', $raw); + if ($withoutTimestamps($block->ical_raw) !== $withoutTimestamps($event['raw'])) { + return false; + } + + $engine = app(ICalRuleEngine::class); + + return $engine->evaluate($channel, $block->ical_properties) === $engine->evaluate($channel, $event['properties']); + } } diff --git a/app/Filament/Resources/Channels/Pages/ChannelRules.php b/app/Filament/Resources/Channels/Pages/ChannelRules.php index 13b7d54..d06854c 100644 --- a/app/Filament/Resources/Channels/Pages/ChannelRules.php +++ b/app/Filament/Resources/Channels/Pages/ChannelRules.php @@ -29,6 +29,7 @@ use Filament\Schemas\Schema; use Illuminate\Database\Eloquent\Model; use Illuminate\Support\Facades\DB; +use Illuminate\Validation\ValidationException; class ChannelRules extends EditRecord { @@ -183,14 +184,26 @@ protected function getHeaderActions(): array }), Action::make('applyRules')->label('Speichern & anwenden')->requiresConfirmation() ->modalDescription('Der Regelentwurf wird aktiviert und der vorhandene Kalenderbestand neu klassifiziert. IDs, Termine und persönliche Zuordnungen bleiben erhalten. Bekannte Herkunft beeinflusst den kanalspezifischen Export. Bei Namensfreigabe werden die gewählten Exportinformationen ebenfalls gespeichert.') - ->action(function (ApplyChannelRules $apply): void { - $counts = DB::transaction(function () use ($apply): array { - $this->record = $this->handleRecordUpdate($this->record, $this->form->getState()); + ->action(function (ApplyChannelRules $apply, Action $action): void { + try { + $counts = DB::transaction(function () use ($apply): array { + $this->record = $this->handleRecordUpdate($this->record, $this->form->getState()); - return $apply->handle($this->record); - }); + return $apply->handle($this->record); + }); + } catch (ValidationException $exception) { + $this->record->refresh(); + $this->setErrorBag($exception->errors()); + Notification::make()->title('Regeln wurden nicht angewendet') + ->body(collect($exception->errors())->flatten()->unique()->implode(' ')) + ->danger()->persistent()->send(); + $action->cancel(); + } $this->record->refresh(); - Notification::make()->title($counts['classified'].' Einträge neu klassifiziert')->body($counts['missing_raw'].' Einträge ohne Originaldaten unverändert.')->success()->send(); + $this->rememberData(); + Notification::make()->title($counts['classified'].' Einträge neu klassifiziert') + ->body($counts['missing_raw'].' Einträge ohne Originaldaten unverändert. Zeitgleiche Einträge anderer Kalender bleiben bis zur ausdrücklichen Zuordnung getrennt.') + ->success()->send(); }), Action::make('configuration')->label('Kalenderverbindung')->url(fn (): string => ChannelResource::getUrl('edit', ['record' => $this->record])), ]; diff --git a/docs/STATUS.md b/docs/STATUS.md index 1349661..d5cb49e 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,5 +1,7 @@ # Projektstand +**Abbruch beim Anwenden von iCal-Regeln korrigiert (29.10.2026, zunächst lokal):** Destination Solution rein lesend geprüft: Entwurf vorhanden, aktive Regeln leer; nachfolgender Import unterscheidet sich von der Vorschau nur in DTSTAMP, bei gleichen Terminen und gleichem Regelergebnis. Bisher blockierte die Prüfung auf veraltete Originaldaten auch diese reine Zeitstempeländerung; die Validierungsnachricht blieb hinter dem Bestätigungsdialog unsichtbar. Reine DTSTAMP-/LAST-MODIFIED-Änderungen werden jetzt nur bei vollständig gleichem Regelergebnis toleriert, neueste importierte Originale bleiben erhalten. Fachliche Änderungen oder ein durch Zeitstempel geändertes Regelergebnis verlangen weiterhin eine neue Vorschau. Validierungsabbrüche schließen den Dialog, zeigen eine dauerhafte Meldung und behalten die Formulareingaben; gespeicherter Regelstand wird nach dem Transaktionsrückbau neu geladen. Erfolg schließt die Bestätigung und aktualisiert den aktiven Regelstand. **174 relevante Tests / 1052 Assertions und Pint erfolgreich**, darin 41 Regelengine-Tests / 289 Assertions und sieben zusätzliche Fälle mit tatsächlichem Öffnen und Bestätigen des Dialogs, Aktualisierungsrennen, fehlerhafter Extraktion und Formularvalidierung. Keine echten Kanalregeln aktiviert, keine Kalenderdaten zusammengeführt; identische Tage allein bleiben kein Identitätsnachweis. [Befund und Bedienung](architecture/ical-regelengine.md#vorschau-entwurf-und-aktivierung). + **iCal-Kompatibilität für fehlenden DTSTAMP (29.10.2026, bereitgestellt):** Ferienundwohnen-Feed liefert elf Ereignisse ohne DTSTAMP, aber mit gültigem ereignisbezogenem UTC-LAST-MODIFIED. Ablehnung mit neuem Test reproduziert; Parser verwendet LAST-MODIFIED nur bei vollständig fehlendem DTSTAMP als Ersatzprüfung. Leere/ungültige vorhandene DTSTAMP, unbrauchbare oder doppelte Zeitstempel und beschädigte Feeds bleiben abgewiesen. Keine künstlichen Originalfelder, keine geänderte UID-/Datums- oder Stornologik. **101 relevante Tests / 530 Assertions und Pint erfolgreich**, darunter zehn zusätzliche ungültige Profile sowie Importwiederholung und Datumsänderung mit fehlendem DTSTAMP. Echte, Git-ignorierte Originaldatei separat ohne Datenbankzugriff lokal erfolgreich gelesen: elf Ereignisse/Belegungen, erste Anreise/Abreise 10.–24.11.2026, letzte 03.–10.10.2027. Vorhandene Verbindung 5 hat den Import derzeit ausgeschaltet; nicht aktiviert und keine echten Belegungen importiert. Mit `2ae48e7` durch [Pipeline 4698](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4698) erfolgreich bereitgestellt; gesamte Feature-Suite, Build, Sicherung und Deployment erfolgreich, Release `20261029150456-2ae48e77`, Serverrevision und Gesundheitscheck HTTP 200 bestätigt. Anschließender echter Abruf auf Strato über ICalConnector und Parser erfolgreich: elf Ereignisse/Belegungen, elf eindeutige UIDs, alle Originale ohne DTSTAMP und mit LAST-MODIFIED. Verbindung 5 weiterhin Import aus, null Bestandszeilen vor/nach dieser rein lesenden Prüfung. Keine Migration und kein manueller Bestandsimport. [Kompatibilitätsgrenze](architecture/ical-kanalkonfiguration.md#6-import-änderungen-und-entfernung). **iCal-Regelbearbeitung präzisiert (29.10.2026, bereitgestellt):** Dauerhafter Kopfbutton „Entwurf speichern“, eindeutiges „Speichern & anwenden“, sichtbarer Unterschied zwischen gespeichertem und aktivem Regelstand sowie direkte Links der Regelvorschau zu importierten Einträgen und zeitgleichen Kandidaten. Hinweise erklären die notwendige Textextraktion für vollständige Gastnamen und die persönliche Zuordnung weiterer Kalenderdarstellungen. Lesender Befund: Destination-Solution-Regel nur als Entwurf, keine aktive Regel und keine Namensextraktion; dadurch unbekannte Einordnung trotz treffender Vorschau. Ein zeitgleicher FeWo-direkt-Eintrag vorhanden, keine automatische Zusammenführung durchgeführt. Keine tatsächlichen Kalenderdaten oder Kanalkonfigurationen geändert. **136 relevante Tests / 779 Assertions erfolgreich**, darunter wiederholtes Speichern und eine synthetische Primärquelle mit vollständigem Namen, separater Kalenderdarstellung und bestätigter Zuordnung. Mit `54efd3b` durch Pipeline 4692 erfolgreich auf stommer.info bereitgestellt, Release `20261029144115-54efd3b8`; vorherige Bereitstellung 4691 ebenfalls erfolgreich. Gesamte Feature-Suite, Build, Sicherung und Deployment erfolgreich; 46 Regelengine-/Zuordnungsprüfungen mit 266 Assertions nach der abschließenden Dialogpräzisierung ebenfalls lokal erfolgreich. Serverrevision, neue Statusmethode und Gesundheits-/Anmeldeseite bestätigt; keine zusätzliche visuelle Browserabnahme. Deployment ohne neue Migration. DS-Import nach Bereitstellung um 15:40:04 MEZ erfolgreich; gespeicherte Regel weiterhin bewusst Entwurf, keine Aktivierung oder Zusammenführung durch den Agenten. Build vorab bei rund 2,5 GB verfügbarem RAM und unterstützten Docker-Speicherlimits geprüft, vorhandene Pipeline mit 2 CPUs / 2 GB verwendet; n8n während des Builds HTTP 200. [Bedienung und Befund](architecture/ical-regelengine.md#mehrere-kanäle-mit-unterschiedlichen-richtungen). diff --git a/docs/architecture/ical-regelengine.md b/docs/architecture/ical-regelengine.md index 2bf8f4f..9c815d8 100644 --- a/docs/architecture/ical-regelengine.md +++ b/docs/architecture/ical-regelengine.md @@ -31,7 +31,11 @@ ## Vorschau, Entwurf und Aktivierung **Entwurf speichern** steht dauerhaft oben auf der Seite und speichert die Regeln zunächst als Entwurf, auch bei wiederholten Änderungen. Bereits aktive Regeln bleiben für die automatischen Importe maßgeblich. **Speichern & anwenden** (zuvor „Auf Bestand anwenden“) speichert die aktuellen Formulareingaben, bestätigt und aktiviert den Entwurf und klassifiziert vorhandene Einträge neu. Danach verwenden auch folgende Importe diese Regeln. Die Anzeige **Gespeicherter Regelstand** zeigt ausdrücklich, ob sich gespeicherter Entwurf und aktive Regeln unterscheiden. Die Live-Vorschau allein ändert weder Kalender noch aktiven Regelstand. -Die Neuauswertung erhält lokale IDs, externe UIDs, Zeiträume und bestätigte persönliche Zuordnungen. Fehlende Originaldaten alter Einträge können anhand derselben UID aus der Analyse ergänzt werden; Löschen und Neuimport sind nicht erforderlich. Nicht zuordenbare alte Einträge bleiben unverändert. Hat ein neuerer Import seit der Analyse andere Originaldaten geliefert, verlangt die Anwendung eine neue Analyse. Abweichende Termine zwischen Analyse und gespeichertem Zeitraum werden als Prüffall markiert und durch die Klassifikation nicht verändert. +Die Neuauswertung erhält lokale IDs, externe UIDs, Zeiträume und bestätigte persönliche Zuordnungen. Fehlende Originaldaten alter Einträge können anhand derselben UID aus der Analyse ergänzt werden; Löschen und Neuimport sind nicht erforderlich. Nicht zuordenbare alte Einträge bleiben unverändert. Hat ein neuerer Import seit der Analyse andere fachliche Originaldaten geliefert, verlangt die Anwendung eine neue Analyse. Ausschließliche Änderungen an DTSTAMP und LAST-MODIFIED verhindern die Aktivierung nicht, sofern das vollständige Regelergebnis unverändert bleibt; die neuesten importierten Originaldaten bleiben erhalten. Verwendet die Regel einen geänderten Zeitstempel und ergibt sich dadurch ein anderes Ergebnis, ist ebenfalls eine neue Vorschau erforderlich. Abweichende Termine zwischen Analyse und gespeichertem Zeitraum werden als Prüffall markiert und durch die Klassifikation nicht verändert. + +Bei erfolgreichem „Speichern & anwenden“ schließt sich die Bestätigung und die Erfolgsmeldung nennt die Anzahl geprüfter Einträge. Bei einer veralteten Vorschau oder ungültigen Formularangaben schließt sie ebenfalls und eine dauerhafte Fehlermeldung erklärt den Grund. Die Formulareingaben bleiben zur Korrektur erhalten; bei einem Abbruch werden weder Entwurf noch Exportkonfiguration oder aktive Regeln teilweise gespeichert. Der angezeigte gespeicherte Regelstand wird aus dem unveränderten Bestand neu geladen. + +**Fehlerbefund vom 29.10.2026:** Bei Destination Solution war ein Regelentwurf gespeichert, aber noch keine aktive Regel vorhanden. Der automatische Import hatte ausschließlich DTSTAMP gegenüber der Vorschau geändert; Zeitraum und Regelergebnis waren gleich. Die bisherige Sicherheitsprüfung brach deshalb unnötig ab, und die zugehörige Validierungsmeldung war hinter dem Bestätigungsdialog unsichtbar. Rein lesend am echten Bestand nachgewiesen; die Korrektur und die Rückmeldungen sind mit synthetischen Livewire-Dialogtests geprüft. Keine echte Regel durch den Agenten aktiviert und keine tatsächlichen Belegungen zusammengeführt. Die vorhandene Destination-Regel enthält weiterhin keine Namensextraktion; für die Anzeige des vollständigen Namens bleibt diese gesondert einzurichten. ## Führende Repräsentation und Zuordnung diff --git a/tests/Feature/ICalRuleEngineTest.php b/tests/Feature/ICalRuleEngineTest.php index af0b168..80e2591 100644 --- a/tests/Feature/ICalRuleEngineTest.php +++ b/tests/Feature/ICalRuleEngineTest.php @@ -28,6 +28,7 @@ use App\Tenancy\TenantContext; use Carbon\CarbonImmutable; use Database\Seeders\PropertySeeder; +use Filament\Notifications\Notification; use Illuminate\Foundation\Testing\RefreshDatabase; use Illuminate\Http\Request; use Illuminate\Support\Facades\DB; @@ -378,6 +379,129 @@ public function test_a_newer_import_cannot_be_overwritten_by_an_old_analysis_dur $this->assertNull($channel->fresh()->ical_active_rules); } + #[DataProvider('timestampChanges')] + public function test_timestamp_only_sync_updates_do_not_block_applying_rules_or_replace_newer_originals(bool $changeStamp, bool $changeModified): void + { + $channel = $this->channel(); + $initial = str_replace('DTSTAMP:20261027T090000Z', "DTSTAMP:20261027T090000Z\r\nLAST-MODIFIED:20261027T090000Z", self::calendar()); + $calendar = str_replace( + ['DTSTAMP:20261027T090000Z', 'LAST-MODIFIED:20261027T090000Z'], + [$changeStamp ? 'DTSTAMP:20261027T090500Z' : 'DTSTAMP:20261027T090000Z', $changeModified ? 'LAST-MODIFIED:20261027T090500Z' : 'LAST-MODIFIED:20261027T090000Z'], + $initial, + ); + Http::preventStrayRequests(); + Http::fake(['https://portal.example/calendar.ics' => Http::sequence()->push($initial)->push($calendar)]); + Mail::fake(); + $this->assertTrue(app(SyncChannel::class)->handle($channel)->successful); + $this->travel(5)->minutes(); + $this->assertTrue(app(SyncChannel::class)->handle($channel)->successful); + $block = $channel->blockedPeriods()->where('external_uid', 'one')->sole(); + $this->assertStringContainsString(($changeStamp ? 'DTSTAMP' : 'LAST-MODIFIED').':20261027T090500Z', $block->ical_raw); + $original = $block->only(['id', 'external_uid', 'starts_on', 'ends_on', 'ical_raw', 'ical_properties']); + $this->actingAs(User::factory()->create()); + + Livewire::test(ChannelRules::class, ['record' => $channel->id]) + ->fillForm(['rules' => self::rules()]) + ->mountAction('applyRules')->assertActionMounted('applyRules') + ->callMountedAction()->assertHasNoFormErrors()->assertActionNotMounted() + ->assertNotified('2 Einträge neu klassifiziert') + ->assertSee('Gespeicherter Entwurf und aktive Regeln stimmen überein.'); + + $this->assertEquals($original, $block->fresh()->only(array_keys($original))); + $this->assertSame('portal_reservation', $block->fresh()->ical_event_type); + $this->assertSame('Lea', $block->fresh()->guestName()); + $this->assertSame($channel->fresh()->ical_rules, $channel->fresh()->ical_active_rules); + Http::assertSentCount(2); + } + + public static function timestampChanges(): array + { + return ['DTSTAMP' => [true, false], 'LAST-MODIFIED' => [false, true], 'both' => [true, true]]; + } + + public function test_changed_import_closes_confirmation_and_shows_why_rules_were_not_activated(): void + { + $channel = $this->channel(); + $this->import($channel); + $this->actingAs(User::factory()->create()); + $page = Livewire::test(ChannelRules::class, ['record' => $channel->id]) + ->fillForm(['rules' => self::rules()])->mountAction('applyRules')->assertActionMounted('applyRules'); + $this->travel(5)->minutes(); + $block = $channel->blockedPeriods()->where('external_uid', 'one')->sole(); + $newEvent = app(ICalParser::class)->parseDocument(self::feed(self::event('one', 'Reserved - Noah')))['events'][0]; + $block->forceFill(['ical_raw' => $newEvent['raw'], 'ical_properties' => $newEvent['properties']])->saveQuietly(); + + $page->callMountedAction()->assertActionNotMounted() + ->assertNotified(Notification::make()->title('Regeln wurden nicht angewendet') + ->body('Der Importbestand hat sich seit der Vorschau geändert. Den Kalender erneut analysieren und die Vorschau prüfen.') + ->danger()->persistent()) + ->assertSee('Es sind noch keine Erkennungsregeln aktiviert.'); + + $this->assertNull($channel->fresh()->ical_rules); + $this->assertNull($channel->fresh()->ical_active_rules); + $this->assertSame('unknown', $block->fresh()->ical_event_type); + $this->assertSame($newEvent['raw'], $block->fresh()->ical_raw); + $this->assertSame($newEvent['properties'], $block->fresh()->ical_properties); + $this->assertCount(2, $page->get('data.rules')); + } + + public function test_invalid_extraction_is_visible_after_confirmation_and_can_be_corrected_without_losing_the_draft(): void + { + $channel = $this->channel(); + $this->actingAs(User::factory()->create()); + $rule = self::rule(['extractions' => [['field' => 'SUMMARY', 'target' => 'guest_full_name', 'method' => 'after', 'start' => '']]]); + + $page = Livewire::test(ChannelRules::class, ['record' => $channel->id]) + ->fillForm(['rules' => [$rule]])->mountAction('applyRules')->callMountedAction() + ->assertActionNotMounted() + ->assertNotified(Notification::make()->title('Regeln wurden nicht angewendet') + ->body('Für die Textextraktion die benötigten Anfangs- und Endtexte angeben.')->danger()->persistent()); + + $this->assertNull($channel->fresh()->ical_rules); + $this->assertNull($channel->fresh()->ical_active_rules); + $page->fillForm(['rules' => [self::rule()]])->mountAction('applyRules')->callMountedAction() + ->assertHasNoFormErrors()->assertActionNotMounted()->assertNotified('0 Einträge neu klassifiziert'); + $this->assertCount(1, $channel->fresh()->ical_active_rules); + } + + public function test_a_rule_using_a_changed_timestamp_requires_a_new_preview(): void + { + $channel = $this->channel(); + $this->import($channel); + $rule = self::rule(['conditions' => [['field' => 'DTSTAMP', 'operator' => 'equals', 'value' => '20261027T090000Z']]]); + app(SaveChannelRules::class)->handle($channel, [$rule]); + $this->travel(5)->minutes(); + $block = $channel->blockedPeriods()->where('external_uid', 'one')->sole(); + $newEvent = app(ICalParser::class)->parseDocument(self::feed(str_replace('DTSTAMP:20261027T090000Z', 'DTSTAMP:20261027T090500Z', self::event('one', 'Reserved - Lea'))))['events'][0]; + $block->forceFill(['ical_raw' => $newEvent['raw'], 'ical_properties' => $newEvent['properties']])->saveQuietly(); + + try { + app(ApplyChannelRules::class)->handle($channel->fresh()); + $this->fail('A changed rule result must require a new preview.'); + } catch (ValidationException $exception) { + $this->assertArrayHasKey('rules', $exception->errors()); + } + + $this->assertNull($channel->fresh()->ical_active_rules); + $this->assertSame($newEvent['raw'], $block->fresh()->ical_raw); + $this->assertSame('unknown', $block->fresh()->ical_event_type); + } + + public function test_main_form_validation_closes_confirmation_and_keeps_the_unsaved_fields(): void + { + $channel = $this->channel(); + $this->actingAs(User::factory()->create()); + + $page = Livewire::test(ChannelRules::class, ['record' => $channel->id]) + ->fillForm(['rules' => [self::rule(['name' => ''])]]) + ->mountAction('applyRules')->callMountedAction()->assertActionNotMounted() + ->assertHasErrors()->assertNotified('Regeln wurden nicht angewendet'); + + $this->assertCount(1, $page->get('data.rules')); + $this->assertNull($channel->fresh()->ical_rules); + $this->assertNull($channel->fresh()->ical_active_rules); + } + public function test_ambiguous_duplicate_uids_with_different_original_fields_are_rejected(): void { $this->expectException(ChannelSyncException::class);