From 8927f2eeb1b6a79a789173e0cf80ff885e6d37c0 Mon Sep 17 00:00:00 2001 From: Lars Date: Tue, 27 Oct 2026 18:07:48 +0100 Subject: [PATCH] Kalenderabgleich ueber iCal von weiteren Portalfunktionen abgrenzen --- app/Enums/AdminMode.php | 4 ++-- .../Resources/Channels/ChannelResource.php | 6 +++--- .../Resources/Channels/Pages/CreateChannel.php | 2 +- .../Resources/Channels/Pages/ListChannels.php | 2 +- .../Resources/Channels/Schemas/ChannelForm.php | 5 +++-- .../Resources/Channels/Tables/ChannelsTable.php | 14 +++++++------- .../RelationManagers/ChannelsRelationManager.php | 6 +++--- docs/STATUS.md | 2 ++ docs/architecture/ical-kanalkonfiguration.md | 2 +- .../ical-mvp-inbetriebnahme-2026-10-27.md | 4 ++-- 10 files changed, 25 insertions(+), 22 deletions(-) diff --git a/app/Enums/AdminMode.php b/app/Enums/AdminMode.php index dc100f5..2e33be3 100644 --- a/app/Enums/AdminMode.php +++ b/app/Enums/AdminMode.php @@ -48,8 +48,8 @@ public function getLabel(): string public function getDescription(): string { return match ($this) { - self::Simple => 'Das Tägliche: Anfragen, Buchungen und Verträge, Sperrzeiten, Preise & Angebote, Gäste, Portale & Kalender, Portal-Aufgaben, Bewertungen, Fotos', - self::Expert => 'Alle Einstellungen: Preise, Angebote, Portale, Webseite, System', + self::Simple => 'Das Tägliche: Anfragen, Buchungen und Verträge, Sperrzeiten, Preise & Angebote, Gäste, Kalenderabgleich (iCal), Portal-Aufgaben, Bewertungen, Fotos', + self::Expert => 'Alle Einstellungen: Preise, Angebote, Kalenderabgleich (iCal), Webseite, System', }; } diff --git a/app/Filament/Resources/Channels/ChannelResource.php b/app/Filament/Resources/Channels/ChannelResource.php index 5774e7e..4935097 100644 --- a/app/Filament/Resources/Channels/ChannelResource.php +++ b/app/Filament/Resources/Channels/ChannelResource.php @@ -27,11 +27,11 @@ class ChannelResource extends Resource protected static string|UnitEnum|null $navigationGroup = 'Vermietung'; - protected static ?string $navigationLabel = 'Portale & Kalender'; + protected static ?string $navigationLabel = 'Kalenderabgleich (iCal)'; - protected static ?string $modelLabel = 'Portalkanal'; + protected static ?string $modelLabel = 'iCal-Verbindung'; - protected static ?string $pluralModelLabel = 'Portale & Kalender'; + protected static ?string $pluralModelLabel = 'Kalenderabgleich (iCal)'; protected static ?int $navigationSort = 4; diff --git a/app/Filament/Resources/Channels/Pages/CreateChannel.php b/app/Filament/Resources/Channels/Pages/CreateChannel.php index 437c72b..34790ee 100644 --- a/app/Filament/Resources/Channels/Pages/CreateChannel.php +++ b/app/Filament/Resources/Channels/Pages/CreateChannel.php @@ -21,7 +21,7 @@ protected function handleRecordCreation(array $data): Model protected function getCreatedNotificationTitle(): ?string { - return 'Portalkanal angelegt – eigener Exportlink automatisch erzeugt'; + return 'iCal-Verbindung angelegt – Exportlink automatisch erzeugt'; } protected function getRedirectUrl(): string diff --git a/app/Filament/Resources/Channels/Pages/ListChannels.php b/app/Filament/Resources/Channels/Pages/ListChannels.php index d751eaf..b169aa5 100644 --- a/app/Filament/Resources/Channels/Pages/ListChannels.php +++ b/app/Filament/Resources/Channels/Pages/ListChannels.php @@ -13,7 +13,7 @@ class ListChannels extends ListRecords protected function getHeaderActions(): array { return [ - CreateAction::make(), + CreateAction::make()->label('iCal-Verbindung anlegen'), ]; } } diff --git a/app/Filament/Resources/Channels/Schemas/ChannelForm.php b/app/Filament/Resources/Channels/Schemas/ChannelForm.php index 3f31d26..fb41fb2 100644 --- a/app/Filament/Resources/Channels/Schemas/ChannelForm.php +++ b/app/Filament/Resources/Channels/Schemas/ChannelForm.php @@ -42,7 +42,7 @@ public static function configure(Schema $schema, bool $selectProperty = false): ->extraAttributes(['style' => 'overflow-wrap:anywhere']) ->columnSpanFull(), TextInput::make('name') - ->label('Name') + ->label('Name der Kalenderverbindung') ->placeholder('z. B. FeWo-direkt') ->required() ->maxLength(100), @@ -50,7 +50,8 @@ public static function configure(Schema $schema, bool $selectProperty = false): Select::make('booking_model')->label('Buchungsmodell')->options(ChannelBookingModel::class)->default(ChannelBookingModel::Mixed)->required() ->helperText('Fachliche Einordnung; löst keine automatischen Buchungsentscheidungen aus.'), Select::make('connector') - ->label('Anbindung') + ->label('Kalenderanbindung') + ->helperText('Diese Verbindung gleicht Belegungszeiträume über iCal ab. Weitere Portalfunktionen benötigen eine eigene Anbindung.') ->options($registry->options()) ->default('ical') ->live() diff --git a/app/Filament/Resources/Channels/Tables/ChannelsTable.php b/app/Filament/Resources/Channels/Tables/ChannelsTable.php index e94cc50..b5d2aaf 100644 --- a/app/Filament/Resources/Channels/Tables/ChannelsTable.php +++ b/app/Filament/Resources/Channels/Tables/ChannelsTable.php @@ -33,13 +33,13 @@ public static function configure(Table $table, ?Property $owner = null): Table ->recordTitleAttribute('name') ->defaultSort('id') ->contentGrid(['md' => 2, '2xl' => 3]) - ->emptyStateHeading('Noch keine Portalkanäle') - ->emptyStateDescription('Legen Sie einen frei benannten Kanal für eine Ihrer Wohnungen an. Sein eigener Exportlink wird beim Speichern automatisch erzeugt.') - ->description('Jeder Kanal hat einen eigenen Exportlink. Einstellungen ändern Sie über „Bearbeiten“, Abgleiche und Protokolle finden Sie im Zusatzmenü.') + ->emptyStateHeading('Noch keine iCal-Verbindungen') + ->emptyStateDescription('Legen Sie eine Kalenderverbindung für eine Ihrer Wohnungen an. Ihr eigener iCal-Exportlink wird beim Speichern automatisch erzeugt.') + ->description('Hier verwalten Sie ausschließlich den Belegungsabgleich über iCal. Weitere Portalfunktionen werden separat angebunden.') ->modifyQueryUsing(fn (Builder $query) => $query->withCount(['blockedPeriods as review_count' => fn ($blocks) => $blocks->where('needs_review', true)])) ->columns([ Stack::make([ - TextColumn::make('name')->label('Portal')->weight('bold')->searchable()->sortable()->wrap()->extraAttributes(['style' => 'overflow-wrap:anywhere']), + TextColumn::make('name')->label('Kalenderverbindung')->weight('bold')->searchable()->sortable()->wrap()->extraAttributes(['style' => 'overflow-wrap:anywhere']), TextColumn::make('property.name')->label('Wohnung')->visible($owner === null)->searchable()->color('gray')->wrap(), TextColumn::make('channel_state')->label('Status')->badge()->wrap() ->state(fn (Channel $record): string => match (true) { @@ -70,9 +70,9 @@ public static function configure(Table $table, ?Property $owner = null): Table ])->space(2), ]) ->headerActions($owner ? [ - CreateAction::make()->using(fn (array $data): Channel => app(ConfigureChannel::class)->handle($owner, $data)) - ->modalDescription('Name und Anbindung wählen. Der eigene Exportlink entsteht automatisch beim Speichern. Die externe Importadresse kann auch später ergänzt werden. Für den normalen kanalübergreifenden Betrieb den regulären Exportmodus bewusst wählen.') - ->successNotificationTitle('Portal angelegt – eigener Exportlink automatisch erzeugt'), + CreateAction::make()->label('iCal-Verbindung anlegen')->using(fn (array $data): Channel => app(ConfigureChannel::class)->handle($owner, $data)) + ->modalDescription('Kalenderverbindung benennen und iCal-Anbindung wählen. Der eigene Exportlink entsteht automatisch beim Speichern. Weitere Portalfunktionen sind gesonderte Anbindungen.') + ->successNotificationTitle('iCal-Verbindung angelegt – Exportlink automatisch erzeugt'), ] : []) ->recordActions([ Action::make('exportLink')->label('Exportlink')->icon(Heroicon::OutlinedLink)->button() diff --git a/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php b/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php index e23740c..c4024fb 100644 --- a/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php +++ b/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php @@ -12,11 +12,11 @@ class ChannelsRelationManager extends RelationManager { protected static string $relationship = 'channels'; - protected static ?string $title = 'Portale & Kanäle'; + protected static ?string $title = 'Kalenderabgleich (iCal)'; - protected static ?string $modelLabel = 'Portal'; + protected static ?string $modelLabel = 'iCal-Verbindung'; - protected static ?string $pluralModelLabel = 'Portale'; + protected static ?string $pluralModelLabel = 'iCal-Verbindungen'; public function form(Schema $schema): Schema { diff --git a/docs/STATUS.md b/docs/STATUS.md index e80d1fc..850479c 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“). +**iCal-Bereich fachlich abgegrenzt (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.** Begriffliche Ergänzung zur Auslieferung vorbereitet; Nachweis folgt nach Pipeline. + **Erstimport-Anzeige korrigiert und ausgeliefert (27.10.2026):** Ein neuer aktiver Kanal ohne erfolgreichen Import zeigt **„Erster Import ausstehend“**. „Import veraltet“ bleibt früher erfolgreichen, inzwischen nicht mehr aktuellen Importen vorbehalten; ein erster fehlgeschlagener Abruf zeigt weiterhin „Importfehler“. Erster Lauf über **Weitere Aktionen › Jetzt abgleichen**. Nur die Darstellung geändert, keine Import-/Belegungsregeln oder Portalverbindungen. Relevante Verwaltungs-/Abrufprüfungen: **18 Tests / 106 Assertions erfolgreich**, Pint erfolgreich; Pipeline 4666 mit Build/Tests/Sicherung/Deployment erfolgreich, Server-REVISION und Release bestätigt. Lesend geprüft: Der inzwischen vom Nutzer eingerichtete Importkanal 2 hat einen erfolgreichen Lauf vom 27.10. um 17:58; Aktualitätsgrenze 60 Minuten, `is_stale=false`. Kein weiterer Import durch diese Prüfung ausgelöst. **Exportlink in der Portalkonfiguration bereitgestellt (27.10.2026):** Der vorhandene Link steht oben im Bearbeitungsformular als **„Eigener iCal-Exportlink“**, schreibgeschützt und kopierbar, sowohl in der eigenen Portalverwaltung als auch an der Wohnung. Kein neuer Token und keine Änderung der Kalenderverbindung. Relevante Verwaltungs-/iCal-Tests: **53 Tests / 268 Assertions erfolgreich**, Pint erfolgreich. Mit `0be1cfc` durch Pipeline 4665 erfolgreich ausgeliefert; im aktuellen Stand `e5a083c` enthalten. diff --git a/docs/architecture/ical-kanalkonfiguration.md b/docs/architecture/ical-kanalkonfiguration.md index 2d37328..d6d129a 100644 --- a/docs/architecture/ical-kanalkonfiguration.md +++ b/docs/architecture/ical-kanalkonfiguration.md @@ -40,7 +40,7 @@ ## 2. Kompakte GAP-Analyse ## 3. Kanal je Wohnung konfigurieren -Ort der eigenständigen Oberfläche: **Vermietung → Portale & Kalender**. Alternativ bleiben die Einstellungen an der jeweiligen Wohnung erreichbar. Jeder Kanal wird einer Wohnung und ihrem Mandanten zugeordnet. Namen wie „FeWo-direkt“ und „Ostseeklar“ sind freie Eingaben; es werden keine festen Anbieter angelegt. Der Connector bleibt `ical`. +Ort der eigenständigen Oberfläche: **Vermietung → Kalenderabgleich (iCal)**. Ein Eintrag bezeichnet ausschließlich die iCal-Kalenderverbindung für Belegungszeiträume. Weitere Funktionen desselben Portals benötigen gesonderte Anbindungen. Alternativ bleiben die Kalendereinstellungen an der jeweiligen Wohnung erreichbar. Jede Verbindung wird einer Wohnung und ihrem Mandanten zugeordnet. Namen wie „FeWo-direkt“ und „Ostseeklar“ sind freie Eingaben; es werden keine festen Anbieter angelegt. Der Connector bleibt `ical`. | Einstellung | Bedeutung | |---|---| diff --git a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md index 376c671..d3d1d5f 100644 --- a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md +++ b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md @@ -8,9 +8,9 @@ # iCal-MVP: Bereitstellung und Benutzung ## Oberfläche und automatische Exportlinks -Die eigenständige Verwaltungsseite **Vermietung → Portale & Kalender** (`/admin/channels`) zeigt alle Kanäle des angemeldeten Vermieters. Sie ist in der einfachen und der Expertenansicht erreichbar. Über **Erstellen** werden Wohnung, frei gewählter Kanalname und Anbindung „Kalender-Abgleich (iCal)“ eingetragen. Es gibt keine vorausgewählten oder automatisch eingerichteten Anbieter. Auch auf ausdrücklichen Wunsch im Folgeauftrag wurde kein Ostseeklar-Kanal angelegt. +Die eigenständige Verwaltungsseite **Vermietung → Kalenderabgleich (iCal)** (`/admin/channels`) zeigt die Kalenderverbindungen des angemeldeten Vermieters. Jeder Eintrag steht für den iCal-Belegungsabgleich einer Wohnung mit einem externen Kalender. Weitere Portalfunktionen wie Preise, Nachrichten oder vollständige Buchungsabläufe benötigen eigene Anbindungen und werden durch diesen Eintrag nicht aktiviert. Die Seite ist in der einfachen und der Expertenansicht erreichbar. Über **iCal-Verbindung anlegen** werden Wohnung, frei gewählter Name der Kalenderverbindung und Kalenderanbindung eingetragen. Es gibt keine vorausgewählten oder automatisch eingerichteten Anbieter. Auch auf ausdrücklichen Wunsch im Folgeauftrag wurde kein Ostseeklar-Kanal angelegt. -Jeder Kanal lässt sich individuell konfigurieren und bearbeiten. Die Übersicht bietet Suche nach Namen/Wohnung sowie die Aktionen für Exportlink, Exportumfang, Import und Protokoll. Die Einstellungen bleiben zusätzlich unter **Wohnungen → Wohnung bearbeiten → Portale & Kanäle** erreichbar; beide Ansichten verwenden dieselben Formulare, Aktionen und Geschäftsregeln. +Jede iCal-Verbindung lässt sich individuell konfigurieren und bearbeiten. Die Übersicht bietet Suche nach Namen/Wohnung sowie die Aktionen für Exportlink, Exportumfang, Import und Protokoll. Die Einstellungen bleiben zusätzlich unter **Wohnungen → Wohnung bearbeiten → Kalenderabgleich (iCal)** erreichbar; beide Ansichten verwenden dieselben Formulare, Aktionen und Geschäftsregeln. Die interne Route `/admin/channels`, vorhandene Verbindungen und Exportadressen bleiben bei der begrifflichen Klarstellung erhalten. **Beim Speichern erzeugt FewoPortal automatisch einen eigenen dauerhaften Exportlink für diesen Kanal.** Keine Datei, manuelle Tokenanlage oder Programmierung ist nötig. Über **„Exportlink“ direkt an der Portalkachel** wird die vertrauliche Adresse angezeigt, kopiert und beim externen Portal hinterlegt. Umbenennen, Pausieren und Reaktivieren ändern den Link nicht. Nur eine ausdrücklich ausgeführte Tokenrotation erzeugt eine neue Adresse mit Übergangsfrist.