Namensweitergabe direkt abschaltbar machen und reale Regelresultate dokumentieren
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m39s

This commit is contained in:
Lars committed 2026-10-27 19:14:39 +01:00
1 parent e9db98701b
commit 7c7955b982
6 files changed
+39 -20

No files matched your search

-6
View File
@@ -7,7 +7,6 @@
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;
use Illuminate\Validation\ValidationException;
class ConfigureChannelExport
{
@@ -20,11 +19,6 @@ public function handle(Channel $channel, array $mapping, bool $allowNames): Chan
'export_mapping.*.items.*' => ['required', Rule::in(array_keys(ICalExportFields::FIELDS))],
'export_mapping.*.separator' => ['nullable', 'string', 'max:30'],
])->validate();
foreach ($mapping as $row) {
if (! $allowNames && array_intersect($row['items'], ['guest_first_name', 'guest_full_name']) !== []) {
throw ValidationException::withMessages(['export_names' => 'Für Gastnamen die Namensweitergabe an genau diesen Zielkanal ausdrücklich einschalten.']);
}
}
return DB::transaction(function () use ($channel, $mapping, $allowNames): Channel {
$locked = Channel::query()->whereKey($channel->id)->lockForUpdate()->firstOrFail();
@@ -80,7 +80,8 @@ public function form(Schema $schema): Schema
->schema([View::make('filament.resources.channels.rule-preview')]),
Section::make('4. Informationen im Export an diesen Zielkanal')->description('Diese Exportkonfiguration wird beim Speichern wirksam. Die Vorschau zeigt den aktuell berechneten Inhalt; ein pausierter Export bleibt eingefroren. Nicht vorhandene Informationen werden ausgelassen.')
->schema([
Toggle::make('export_names')->label('Gastnamen ausdrücklich an diesen Zielkanal weitergeben')->default(false)->live(),
Toggle::make('export_names')->label('Gastnamen ausdrücklich an diesen Zielkanal weitergeben')->default(false)->live()
->helperText('Gilt für neu erzeugte Exporte. Ein pausierter Export behält seinen gespeicherten Stand bis zur Reaktivierung.'),
Repeater::make('export_mapping')->label('iCal-Felder befüllen')->maxItems(3)->defaultItems(0)->live(debounce: 600)->addActionLabel('Exportfeld hinzufügen')->schema([
Select::make('field')->label('iCal-Zielfeld')->options(ICalExportFields::ICAL_FIELDS)->required(),
Select::make('items')->label('Enthaltene Informationen (in dieser Reihenfolge)')->options(ICalExportFields::FIELDS)->multiple()->required(),
+2 -2
View File
@@ -1,10 +1,10 @@
# Projektstand
Stand: 27.10.2026 · **Kalenderabgleich (iCal) klar als eigene Anbindungsfunktion auf stommer.info ausgewiesen**, Anwendungskommit `8927f2e`, Release `20261027170945-8927f2ee`, [Pipeline-Lauf 4667 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4667). Exportlink/Erstimport-Anzeige zuvor mit `e5a083c`, Kacheln/Abrufhistorie mit `511faa6`. Vorheriger Mandantenabschluss: `06df80e`, Pipeline 4661.
Stand: 27.10.2026 · **Visuelle iCal-Regelengine auf stommer.info bereitgestellt**, Anwendungskommit `e9db987`, Release `20261027180222-e9db9870`, [Pipeline-Lauf 4668 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4668). Zuvor fachliche Abgrenzung mit `8927f2e`, Exportlink/Erstimport-Anzeige mit `e5a083c`, Kacheln/Abrufhistorie mit `511faa6`.
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
**Visuelle iCal-Regelengine zur Bereitstellung vorbereitet (27.10.2026):** Echte Kalenderanalyse mit Originalfeldern, Beispielen, Häufigkeiten und Textpräfixen; Regeleditor mit UND/ODER, Literalvergleichen, Priorität und einfacher Textextraktion; Live-Vorschau, getrennte Entwurfs-/Aktivierungsstufen und Neuauswertung vorhandener Einträge ohne neue IDs oder Termine. Fachliche Führungskandidaten unterstützen die vorhandene persönliche Zuordnung, ohne automatische Datumszusammenführung. Exportzuordnung nach SUMMARY/DESCRIPTION/LOCATION und ausdrückliche Namensfreigabe je Zielkanal. Originale und Interpretation verschlüsselt gespeichert. **409 Feature-Tests / 1930 Assertions lokal erfolgreich, darunter 32 neue Fälle; Pint erfolgreich.** Additive Migration `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata`. [Bedienung und Grenzen](architecture/ical-regelengine.md). Bereitstellung und reale FeWo-direkt-/Ostseeklar-Nachweise folgen; aktuell sind Quelle und Ziel vorhanden, aber noch keine echten Regelresultate behauptet.
**Visuelle iCal-Regelengine bereitgestellt (27.10.2026):** Echte Kalenderanalyse mit Originalfeldern, Beispielen, Häufigkeiten und Textpräfixen; Regeleditor mit UND/ODER, Literalvergleichen, Priorität und einfacher Textextraktion; Live-Vorschau, getrennte Entwurfs-/Aktivierungsstufen und Neuauswertung vorhandener Einträge ohne neue IDs oder Termine. Fachliche Führungskandidaten unterstützen die persönliche Zuordnung, ohne automatische Datumszusammenführung. Exportzuordnung nach SUMMARY/DESCRIPTION/LOCATION und ausdrückliche Namensfreigabe je Zielkanal. Originale und Interpretation verschlüsselt gespeichert. **409 Feature-Tests / 1930 Assertions lokal erfolgreich, darunter 32 neue Fälle; Pint und Pipeline 4668 erfolgreich.** Additive Migration `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata` in MariaDB-Batch 18, Serverrevision/Release bestätigt. Reale FeWo-direkt-Analyse: **38 Ereignisse, 9 Portalreservierungen, 29 Sperren**, davon 11 zukünftig (3 Reservierungen, 8 Sperren). Beide Regeln als normale Daten aktiviert; 11 vorhandene Einträge ohne geänderte IDs, UIDs, Termine oder Zuordnungen neu klassifiziert. Ostseeklar-Export HTTP 200 mit 11 Ereignissen, davon 3 mit freigegebenen Namensbestandteilen in SUMMARY/DESCRIPTION; Export-IDs/-Zeiträume identisch. **Anzeigeübernahme bei Ostseeklar noch unbestätigt**, Rückfrage an Nutzer offen; keine persönliche Portalbestätigung gesetzt. Browserwerkzeug nicht startbar, daher keine zusätzliche echte Browser-Sichtprüfung behauptet. [Bedienung, Datenabgleich und Grenzen](architecture/ical-regelengine.md). Praktischer Nachweis ohne Namen/Token lokal Git-ignoriert: `storage/app/private/ical-regelengine/real-practical-result.json`.
**iCal-Bereich fachlich abgegrenzt und bereitgestellt (27.10.2026):** Menü und Wohnungsbereich heißen **„Kalenderabgleich (iCal)“**, Datensätze und Anlage **„iCal-Verbindung“**. Übersicht und Formular erklären den Umfang als Austausch von Belegungszeiträumen; weitere Funktionen eines Portals benötigen eigene Anbindungen. Route `/admin/channels`, Daten, Token und Synchronisationsverhalten bleiben erhalten. **66 relevante Tests / 336 Assertions erfolgreich, Pint erfolgreich.** Pipeline 4667 mit Build/Tests/Sicherung/Deployment erfolgreich; Server-REVISION `8927f2e` und Release bestätigt.
+1 -1
View File
@@ -1,6 +1,6 @@
# Generische iCal-Integration und konfigurierbare Portalkanäle
Stand: 27.10.2026 · **Kalenderabgleich (iCal) mit `8927f2e` auf stommer.info als eigener Anbindungsbereich klar ausgewiesen**, Pipeline 4667 erfolgreich. Exportlink/Erstimport-Anzeige zuvor mit `e5a083c`, responsive Kacheln/Abrufhistorie mit `511faa6`, eigenständige Verwaltungsseite mit `1f59cbb`, erster MVP-Kern/Migrationen mit `7830685`. Benutzung und Nachweise: [MVP-Bericht](ical-mvp-inbetriebnahme-2026-10-27.md).
Stand: 27.10.2026 · **Visuelle Regelengine mit `e9db987` auf stommer.info bereitgestellt**, Pipeline 4668 erfolgreich; [Regelengine-Bedienung und echte Kalendernachweise](ical-regelengine.md). Fachliche Abgrenzung zuvor mit `8927f2e`, Exportlink/Erstimport-Anzeige mit `e5a083c`, Kacheln/Abrufhistorie mit `511faa6`. Grundlegende Inbetriebnahme: [MVP-Bericht](ical-mvp-inbetriebnahme-2026-10-27.md).
**MVP-Ergänzung im Folgeauftrag:** [Bereitstellung und Benutzung](ical-mvp-inbetriebnahme-2026-10-27.md) ergänzt die automatische Exportlink-Erzeugung in der Oberfläche, persönliche Belegungszuordnung, archivierte UID-Identität, konfigurierbares Echoverhalten und konkrete Inbetriebnahme. Die nachfolgende ursprüngliche GAP-Analyse dokumentiert die erste Ausbaustufe; Aussagen über fehlende manuelle Zuordnung sind durch die MVP-Ergänzung erweitert. Der tatsächliche Auslieferungsstand wird im verlinkten Bericht nachgeführt.
+29 -4
View File
@@ -1,6 +1,6 @@
# Visuelle iCal-Regelengine
Stand: 27.10.2026 · Implementierung zur Bereitstellung vorbereitet; tatsächliche Auslieferung und echte Kalendernachweise werden nach der Abnahme ergänzt.
Stand: 27.10.2026 · **Auf stommer.info bereitgestellt**, Anwendungskommit `e9db987`, Release `20261027180222-e9db9870`, [Pipeline 4668 erfolgreich](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4668). Additive MariaDB-Migration in Batch 18 bestätigt.
## Kalender analysieren
@@ -47,7 +47,7 @@ ## Exportinformationen je Zielkanal
Ohne Zuordnung bleibt `SUMMARY:Belegt`. Nicht vorhandene Informationen werden ausgelassen. UID, Kalenderidentität und An-/Abreise können nicht durch eine Textzuordnung überschrieben werden. Die vorhandenen Herkunftsausschlüsse, Exportmodi, sicheren Pausen und Echo-Schutzregeln bleiben wirksam.
**Gastnamen ausdrücklich an diesen Zielkanal weitergeben** muss für die Namensfelder eingeschaltet werden. Diese Freigabe ist je Kanal getrennt und standardmäßig aus. Ohne sie werden Namensfelder auch bei einer bereits vorhandenen Zuordnung zur Laufzeit ausgeschlossen. Ein vollständiger Name ist nur verfügbar, wenn er tatsächlich aus der Quelle oder einer eigenen Buchung bekannt ist.
**Gastnamen ausdrücklich an diesen Zielkanal weitergeben** muss für die Namensfelder eingeschaltet werden. Diese Freigabe ist je Kanal getrennt und standardmäßig aus. Sie lässt sich jederzeit ausschalten; die Feldzuordnung darf dabei gespeichert bleiben. Ohne Freigabe werden Namensfelder in neu erzeugten Exporten zur Laufzeit ausgeschlossen. Ein pausierter Export liefert bis zur Reaktivierung seinen bisherigen gespeicherten Stand, einschließlich zuvor freigegebener Textinformationen. Ein vollständiger Name ist nur verfügbar, wenn er tatsächlich aus der Quelle oder einer eigenen Buchung bekannt ist.
Die Exportvorschau zeigt die aktuell berechneten Ereignisse vor dem Speichern. Ein pausierter Export liefert weiterhin seinen eingefrorenen Stand. **Speichern aktiviert die Exportkonfiguration**; der Regelentwurf wird dadurch noch nicht für Import/Bestand aktiviert. Die tatsächliche Darstellung im Zielportal muss unabhängig geprüft werden. Ein Feedabruf oder eine bei uns vorhandene SUMMARY beweist keine Namensübernahme im Portal.
@@ -60,11 +60,36 @@ ## Generischer erster Anwendungsfall
| Portalreservierungen | SUMMARY beginnt mit `Reserved - ` | Portalreservierung; Ursprung aktueller Kanal; führender Kandidat; Text nach `Reserved - ` als Gastvorname/Namensbestandteil |
| Allgemeine Sperren | SUMMARY ist gleich `Blocked` | Allgemeine Sperre; unbekannter Ursprung; zusätzliche Sperre; kein Gastname |
Dieselbe Oberfläche kann andere Felder, Werte und Trennzeichen eines dritten Anbieters verwenden. Die Muster sind keine Sonderfälle im Connector. Konkrete Anzahlen und Resultate des echten FeWo-direkt-Kalenders werden erst nach der tatsächlichen Analyse protokolliert.
Dieselbe Oberfläche kann andere Felder, Werte und Trennzeichen eines dritten Anbieters verwenden. Die Muster sind keine Sonderfälle im Connector.
## Praktische Abnahme mit vorhandenen echten Kanälen
Am 27.10.2026 wurden der vorhandene FeWo-direkt-Importkanal 1 und der vorhandene Ostseeklar-Exportkanal 2 verwendet. Es wurde kein zusätzlicher Anbieter angelegt. Die beiden Beispielregeln sind als normale Konfiguration gespeichert und aktiviert und können auf **Regeln & Exportfelder** eingesehen und bearbeitet werden.
| Prüfung | Tatsächliches Ergebnis |
|---|---|
| Echter FeWo-direkt-Kalender analysiert | 38 Originalereignisse |
| Gefundene Ereignisfelder | DTEND, DTSTAMP, DTSTART, SUMMARY, UID |
| Regel „Portalreservierungen“ | 9 Treffer |
| Regel „Allgemeine Sperren“ | 29 Treffer |
| Noch unbekannte Ereignisse | 0 |
| Aktuell zukünftige Ereignisse | 11: 3 Portalreservierungen und 8 allgemeine Sperren |
| Vergangene Ereignisse in der Analyse | 27; sichtbar in der Analyse, keine zusätzlichen alten Sperren importiert |
| Bestehenden Bestand neu ausgewertet | 11 Datensätze; keine fehlenden Originaldaten nach Ergänzung aus der Analyse |
| IDs, externe UIDs, Zeiträume und bestehende Verknüpfungen | Vorher/nachher unverändert |
| Ostseeklar-Export | Regulärer Modus, HTTP 200, 11 Ereignisse |
| Freigegebene Namensinformationen im HTTP-Export | 3 Belegungen mit verfügbaren Namensbestandteilen |
| Exportierte Ereignis-UIDs und Zeiträume | Vorher/nachher unverändert |
Für Ostseeklar ist die Namensweitergabe ausdrücklich aktiviert: SUMMARY enthält Belegungsbeschreibung und verfügbaren Vornamen/Namensbestandteil, DESCRIPTION den verfügbaren Namensbestandteil und eine Buchungsreferenz, falls vorhanden. Vollständige Gastnamen wurden nicht aus Vornamen erfunden. Die Konfiguration ist am Zielkanal sichtbar. Der öffentliche Feed wurde mit der eigenen Kennung `FewoPortal-Regelengine-Abnahme/1.0` geprüft; dieser Aufruf ist kein Nachweis eines Abrufs durch Ostseeklar.
**Offen bleibt die sichtbare Übernahme im Ostseeklar-Portal.** Die Daten im ausgelieferten Feed sind nachgewiesen. Eine Portalbestätigung oder persönliche Sichtkontrolle im Zielportal liegt noch nicht vor; `portal_verified_at` wurde deshalb nicht gesetzt. Die entsprechende Rückfrage an den Nutzer ist offen.
Die echte Konfiguration wurde über dieselben validierenden Anwendungsaktionen gespeichert, die auch der visuelle Editor aufruft. Die Oberfläche einschließlich Analyse, Live-Vorschau, Speicherung und Aktivierung wurde mit Livewire-Interaktionstests verifiziert. Das Browserwerkzeug ließ sich in dieser Sitzung nicht starten; eine zusätzliche echte Browser-Sichtprüfung durch den Agenten wird daher nicht behauptet.
## Nachweise und technische Orientierung
Die neuen Feature-Tests prüfen Feldentdeckung, Musterzahlen, alle visuellen Vergleiche, UND/ODER, Priorität, einfache Textextraktion, verschlüsselte Speicherung, Vorschau und Aktivierung, Bestandsidentität, persönliche Zuordnungen, unbekannte Drittanbieter, Rollen/Mandanten, HTML- und iCal-Escaping sowie individuelle Namensfreigabe und Exportzuordnung. Es werden ausschließlich synthetische Kalender in isolierter Testdatenbank verwendet.
Die neuen Feature-Tests prüfen Feldentdeckung, Musterzahlen, alle visuellen Vergleiche, UND/ODER, Priorität, einfache Textextraktion, verschlüsselte Speicherung, Vorschau und Aktivierung, Bestandsidentität, persönliche Zuordnungen, unbekannte Drittanbieter, Rollen/Mandanten, HTML- und iCal-Escaping sowie individuelle Namensfreigabe und Exportzuordnung. Es werden ausschließlich synthetische Kalender in isolierter Testdatenbank verwendet. **409 Feature-Tests / 1930 Assertions lokal erfolgreich, darunter 32 neue Regelengine-Fälle; Pint erfolgreich.** Pipeline 4668 mit Build, Tests, Sicherung und Deployment erfolgreich.
Code: `ICalParser`, `ICalAnalysis`, `ICalRuleEngine`, `AnalyzeChannelCalendar`, `SaveChannelRules`, `ApplyChannelRules`, `ICalExportFields`, `ConfigureChannelExport` und die Ressourcenseite `ChannelRules`. Originaldaten und Interpretation erweitern die vorhandenen `Channel`-/`BlockedPeriod`-Modelle. Migration: `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata`. Testdatei: `tests/Feature/ICalRuleEngineTest.php`.
+5 -6
View File
@@ -202,12 +202,8 @@ public function test_export_requires_names_permission_and_keeps_uid_dates_and_or
$parser = app(ICalParser::class);
$feed = app(ICalFeed::class);
$before = $parser->parse($feed->build($target));
try {
app(ConfigureChannelExport::class)->handle($target, $mapping, false);
$this->fail('Names need explicit permission.');
} catch (ValidationException $e) {
$this->assertArrayHasKey('export_names', $e->errors());
}
$target = app(ConfigureChannelExport::class)->handle($target, $mapping, false);
$this->assertFalse($target->ical_export_names);
$this->assertStringNotContainsString('Lea', $feed->build($target));
$target = app(ConfigureChannelExport::class)->handle($target, $mapping, true);
$after = $parser->parse($feed->build($target));
@@ -263,6 +259,9 @@ public function test_export_mapping_can_be_previewed_and_saved_from_the_same_pag
$page->call('save')->assertHasNoFormErrors();
$this->assertTrue($target->fresh()->ical_export_names);
$this->assertStringContainsString('SUMMARY:Lea', app(ICalFeed::class)->build($target->fresh()));
$page->fillForm(['export_names' => false])->call('save')->assertHasNoFormErrors();
$this->assertFalse($target->fresh()->ical_export_names);
$this->assertStringNotContainsString('Lea', app(ICalFeed::class)->build($target->fresh()));
}
public function test_own_bookings_supply_real_full_names_only_when_enabled_for_that_target(): void