iCal-Ereignisse mit LAST-MODIFIED statt fehlendem DTSTAMP lesen
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m3s

This commit is contained in:
Lars committed 2026-10-29 15:53:55 +01:00
1 parent 386e2cf0a9
commit 2ae48e77fa
4 files changed
+64 -4

No files matched your search

+9 -4
View File
@@ -120,7 +120,7 @@ public function parseDocument(string $ics): array
}
$calendar[$name] = $property;
} elseif ($stack === ['VCALENDAR', 'VEVENT']) {
if (isset($event[$name]) && in_array($name, ['UID', 'DTSTART', 'DTEND', 'STATUS'], true)) {
if (isset($event[$name]) && in_array($name, ['UID', 'DTSTART', 'DTEND', 'DTSTAMP', 'LAST-MODIFIED', 'STATUS'], true)) {
throw new ChannelSyncException('Doppelte Identitäts- oder Datumsangaben im Kalenderereignis.');
}
$event[$name] = $property;
@@ -145,16 +145,21 @@ public static function text(string $value): string
return preg_replace_callback('/\\\\([nN,;\\\\])/', fn (array $match): string => in_array($match[1], ['n', 'N'], true) ? "\n" : $match[1], $value);
}
/** @param array<string, array{value: string, params: list<string>}> $event */
/**
* Availability feeds may omit DTSTAMP. Validate event-level LAST-MODIFIED in its place,
* retaining the actual original properties and rejecting an invalid present DTSTAMP.
*
* @param array<string, array{value: string, params: list<string>}> $event
*/
private function toPeriod(array $event): ?ExternalPeriod
{
$stamp = $event['DTSTAMP']['value'] ?? '';
$stamp = $event['DTSTAMP']['value'] ?? $event['LAST-MODIFIED']['value'] ?? '';
try {
if (! preg_match('/^\d{8}T\d{6}Z$/D', $stamp) || CarbonImmutable::createFromFormat('!Ymd\THis\Z', $stamp, 'UTC')->format('Ymd\THis\Z') !== $stamp) {
throw new \RuntimeException;
}
} catch (Throwable) {
throw new ChannelSyncException('Ein Ereignis benötigt einen gültigen UTC-Zeitstempel (DTSTAMP).');
throw new ChannelSyncException('Ein Ereignis benötigt einen gültigen UTC-Zeitstempel (DTSTAMP oder ersatzweise LAST-MODIFIED).');
}
foreach (['RRULE', 'RDATE', 'EXDATE', 'RECURRENCE-ID', 'DURATION'] as $unsupported) {
if (isset($event[$unsupported])) {
+2
View File
@@ -1,5 +1,7 @@
# Projektstand
**iCal-Kompatibilität für fehlenden DTSTAMP (29.10.2026, lokal umgesetzt):** 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. Bereitstellung noch ausstehend. [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).
**Repository-Sichtung und Dokumentationsabgleich (29.10.2026):** 30 bislang offene Dateien fachlich gruppiert: Architektur-/Vermietungskonzept, Betriebsnachweise, lokales iCal-Vergleichswerkzeug sowie Grundriss- und SVG-Entwürfe. Verweise der inzwischen mit `Konzept_` benannten Dateien berichtigt; bekannte Änderungen der Belegungsverwaltung und des Schedulers in den älteren Bestandsübersichten abgegrenzt. Keine offenen Änderungen am PHP-/Frontend-Anwendungscode. Lokales Vergleichsskript mit zwölf synthetischen Fällen ohne Netzwerk-/Anwendungszugriff geprüft; Grafiken auf Lesbarkeit und SVG-Struktur geprüft. Versionierung auf `feature/ical-portalkanaele`, ohne Zusammenführung nach `develop` oder Deployment.
@@ -113,6 +113,10 @@ ## 6. Import, Änderungen und Entfernung
Das unterstützte Profil umfasst einen vollständigen `VCALENDAR` mit `VERSION:2.0`, `PRODID`, geschlossenen Komponenten und einzelnen `VEVENT`s mit UID, gültigem UTC-`DTSTAMP` und positivem Übernachtungszeitraum. Gefaltete UTF-8-Zeilen, ganztägige Daten, unterstützte Zeitzonen und Zeitangaben werden verarbeitet. Fehlendes `DTEND` bedeutet nur bei einem ganztägigen Ereignis eine Nacht. `CANCELLED` und `TRANSPARENT` sind nicht belegend. Ein gültiger leerer Gesamtkalender ist möglich.
**Kompatibilität bei fehlendem DTSTAMP (29.10.2026):** Einige Verfügbarkeitsfeeds lassen den nach [RFC 5545](https://www.rfc-editor.org/rfc/rfc5545.html#section-3.6.1) vorgesehenen Ereigniszeitstempel weg. Fehlt `DTSTAMP` vollständig, akzeptiert der Connector ersatzweise ein gültiges UTC-`LAST-MODIFIED` desselben Ereignisses. Ein leerer oder ungültiger vorhandener `DTSTAMP` wird nicht ersetzt. Zeitstempel im Kalenderkopf oder `CREATED` genügen nicht; doppelte `DTSTAMP`-/`LAST-MODIFIED`-Angaben werden abgewiesen. Originaldaten bleiben unverändert, insbesondere wird kein künstlicher `DTSTAMP` ergänzt. UID-, Datums-, Vollständigkeits- und Entfernungsschutz gelten unverändert.
Anlass war ein am 29.10. geprüfter Kalender von Ferienundwohnen: elf Ereignisse ohne `DTSTAMP`, jeweils mit gültigem `LAST-MODIFIED`. Die lokal privat abgelegte Originaldatei wird mit der Ergänzung vollständig gelesen; elf Belegungen, gleicher Zeitraum und gleiche UID je Ereignis. UTC-Uhrzeiten und eine um eine Sekunde verkürzte Endzeit werden weiter auf die vorhandenen Anreise-/Abreisetage abgebildet. Das numerische Quellfeld `STATUS:1` bleibt Originalinformation und wird nicht als bestätigte Buchung oder Stornierung interpretiert. Echte Kalenderinhalte sind nicht als Testfixture versioniert; synthetische Tests prüfen Import, Wiederholung, Datumsänderung und fehlerhafte Ersatzzeitstempel.
HTML, abgeschnittene oder widersprüchliche Strukturen, ungültige Daten, fehlende Identität/Zeitstempel und widersprüchliche doppelte UIDs lehnen den ganzen Stand ab. Identische Belegungen derselben UID werden einmal verarbeitet. Serien (`RRULE`, `RDATE`, `EXDATE`, `RECURRENCE-ID`), `DURATION` sowie einzelne Kalendernachrichten statt Gesamtkalendern werden abgewiesen. Das ist ein bewusst begrenztes Belegungsprofil, keine vollständige Implementierung aller iCalendar-Möglichkeiten. Die Kompatibilität der echten Feeds ist vor Aktivierung zu prüfen.
| Ereignis | Verarbeitung |
@@ -177,6 +177,7 @@ public function test_repeated_import_and_identical_duplicate_uids_are_idempotent
public static function invalidFeedProvider(): array
{
$valid = self::feed(self::event('external-1'));
$fallback = str_replace('DTSTAMP:20261101T090000Z', 'LAST-MODIFIED:20261101T090000Z', $valid);
return [
'not calendar' => ['<html>Login</html>'],
@@ -186,6 +187,16 @@ public static function invalidFeedProvider(): array
'invalid date' => [str_replace('20261107', '20261131', $valid)],
'missing UID' => [str_replace("UID:external-1\r\n", '', $valid)],
'missing stamp' => [str_replace("DTSTAMP:20261101T090000Z\r\n", '', $valid)],
'empty fallback stamp' => [str_replace('LAST-MODIFIED:20261101T090000Z', 'LAST-MODIFIED:', $fallback)],
'non UTC fallback stamp' => [str_replace('LAST-MODIFIED:20261101T090000Z', 'LAST-MODIFIED:20261101T090000', $fallback)],
'invalid fallback date' => [str_replace('LAST-MODIFIED:20261101T090000Z', 'LAST-MODIFIED:20260230T090000Z', $fallback)],
'invalid present stamp with valid fallback' => [str_replace('DTSTAMP:20261101T090000Z', "DTSTAMP:invalid\r\nLAST-MODIFIED:20261101T090000Z", $valid)],
'empty present stamp with valid fallback' => [str_replace('DTSTAMP:20261101T090000Z', "DTSTAMP:\r\nLAST-MODIFIED:20261101T090000Z", $valid)],
'duplicate fallback stamp' => [str_replace('LAST-MODIFIED:20261101T090000Z', "LAST-MODIFIED:20261101T090000Z\r\nLAST-MODIFIED:20261101T100000Z", $fallback)],
'duplicate primary stamp' => [str_replace('DTSTAMP:20261101T090000Z', "DTSTAMP:20261101T090000Z\r\nDTSTAMP:20261101T100000Z", $valid)],
'created is not a fallback' => [str_replace('DTSTAMP:20261101T090000Z', 'CREATED:20261101T090000Z', $valid)],
'calendar metadata is not an event fallback' => [str_replace("DTSTAMP:20261101T090000Z\r\n", '', str_replace('VERSION:2.0', "VERSION:2.0\r\nLAST-MODIFIED:20261101T090000Z", $valid))],
'fallback does not relax date validation' => [str_replace('20261107', '20261131', $fallback)],
'recurrence' => [str_replace('UID:external-1', "UID:external-1\r\nRRULE:FREQ=DAILY;COUNT=3", $valid)],
'different dates for same UID' => [self::feed(self::event('same').self::event('same', '20261114', '20261117'))],
'different value types' => [str_replace('DTEND;VALUE=DATE:20261110', 'DTEND:20261110T100000Z', $valid)],
@@ -193,6 +204,44 @@ public static function invalidFeedProvider(): array
];
}
public function test_valid_last_modified_can_replace_missing_dtstamp_without_rewriting_originals_or_identity(): void
{
$property = $this->property();
$channel = $this->channel($property);
$body = self::feed(
"BEGIN:VEVENT\r\nUID:without-stamp\r\nSTATUS:1\r\nDTSTART:20261110T120000Z\r\nDTEND:20261124T115959Z\r\nLAST-MODIFIED:20261029T152031Z\r\nSUMMARY:Belegt\r\nEND:VEVENT\r\n".
"BEGIN:VEVENT\r\nUID:summer-time\r\nSTATUS:1\r\nDTSTART:20270328T130000Z\r\nDTEND:20270404T115959Z\r\nLAST-MODIFIED:20261029T152031Z\r\nSUMMARY:Belegt\r\nEND:VEVENT\r\n"
);
$document = app(ICalParser::class)->parseDocument($body);
$this->assertCount(2, $document['events']);
$this->assertArrayNotHasKey('DTSTAMP', $document['events'][0]['properties']);
$this->assertSame('20261029T152031Z', $document['events'][0]['properties']['LAST-MODIFIED'][0]['value']);
$this->assertStringNotContainsString('DTSTAMP:', $document['events'][0]['raw']);
Http::preventStrayRequests();
Http::fake(['https://portal.example/*' => Http::sequence()->push($body)->push($body)
->push(str_replace('20261124T115959Z', '20261125T115959Z', $body))]);
Mail::fake();
$first = app(SyncChannel::class)->handle($channel);
$ids = $channel->blockedPeriods()->orderBy('id')->pluck('id')->all();
$second = app(SyncChannel::class)->handle($channel);
$third = app(SyncChannel::class)->handle($channel);
$this->assertTrue($first->successful);
$this->assertTrue($second->successful);
$this->assertTrue($third->successful);
$this->assertSame([2, 0, 1], [$first->added, $second->added, $third->changed]);
$this->assertSame($ids, $channel->blockedPeriods()->orderBy('id')->pluck('id')->all());
$ordinary = $channel->blockedPeriods()->where('external_uid', 'without-stamp')->sole();
$summerTime = $channel->blockedPeriods()->where('external_uid', 'summer-time')->sole();
$this->assertSame(['2026-11-10', '2026-11-25'], [$ordinary->starts_on->toDateString(), $ordinary->ends_on->toDateString()]);
$this->assertSame(['2027-03-28', '2027-04-04'], [$summerTime->starts_on->toDateString(), $summerTime->ends_on->toDateString()]);
$this->assertSame('unknown', $ordinary->occupationKind()->value);
$this->assertArrayNotHasKey('DTSTAMP', $ordinary->ical_properties);
$this->assertSame('1', $ordinary->ical_properties['STATUS'][0]['value']);
Http::assertSentCount(3);
}
#[DataProvider('invalidFeedProvider')]
public function test_invalid_snapshot_never_changes_existing_blocks(string $body): void
{