diff --git a/app/Enums/AdminMode.php b/app/Enums/AdminMode.php index 5a18189..dc100f5 100644 --- a/app/Enums/AdminMode.php +++ b/app/Enums/AdminMode.php @@ -5,6 +5,7 @@ use App\Filament\Pages\PricesAndOffers; use App\Filament\Resources\BlockedPeriods\BlockedPeriodResource; use App\Filament\Resources\Bookings\BookingResource; +use App\Filament\Resources\Channels\ChannelResource; use App\Filament\Resources\ChannelTasks\ChannelTaskResource; use App\Filament\Resources\Guests\GuestResource; use App\Filament\Resources\Photos\PhotoResource; @@ -31,6 +32,7 @@ enum AdminMode: string implements HasDescription, HasLabel PricesAndOffers::class, GuestResource::class, ChannelTaskResource::class, + ChannelResource::class, ReviewResource::class, PhotoResource::class, ]; @@ -46,7 +48,7 @@ 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, Portal-Aufgaben, Bewertungen, Fotos', + 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', }; } diff --git a/app/Filament/Resources/Channels/ChannelResource.php b/app/Filament/Resources/Channels/ChannelResource.php new file mode 100644 index 0000000..5774e7e --- /dev/null +++ b/app/Filament/Resources/Channels/ChannelResource.php @@ -0,0 +1,63 @@ + ListChannels::route('/'), + 'create' => CreateChannel::route('/create'), + 'edit' => EditChannel::route('/{record}/edit'), + ]; + } +} diff --git a/app/Filament/Resources/Channels/Pages/CreateChannel.php b/app/Filament/Resources/Channels/Pages/CreateChannel.php new file mode 100644 index 0000000..437c72b --- /dev/null +++ b/app/Filament/Resources/Channels/Pages/CreateChannel.php @@ -0,0 +1,31 @@ +findOrFail($data['property_id']); + + return app(ConfigureChannel::class)->handle($property, $data); + } + + protected function getCreatedNotificationTitle(): ?string + { + return 'Portalkanal angelegt – eigener Exportlink automatisch erzeugt'; + } + + protected function getRedirectUrl(): string + { + return ChannelResource::getUrl('index'); + } +} diff --git a/app/Filament/Resources/Channels/Pages/EditChannel.php b/app/Filament/Resources/Channels/Pages/EditChannel.php new file mode 100644 index 0000000..201df08 --- /dev/null +++ b/app/Filament/Resources/Channels/Pages/EditChannel.php @@ -0,0 +1,28 @@ + $this->record->settings]; + } + + protected function handleRecordUpdate(Model $record, array $data): Model + { + return app(ConfigureChannel::class)->handle($record->property, $data, $record); + } + + protected function getRedirectUrl(): string + { + return ChannelResource::getUrl('index'); + } +} diff --git a/app/Filament/Resources/Channels/Pages/ListChannels.php b/app/Filament/Resources/Channels/Pages/ListChannels.php new file mode 100644 index 0000000..d751eaf --- /dev/null +++ b/app/Filament/Resources/Channels/Pages/ListChannels.php @@ -0,0 +1,19 @@ +columns(2) + ->components([ + ...($selectProperty ? [Select::make('property_id')->label('Wohnung')->required() + ->options(fn (): array => Property::query()->orderBy('name')->pluck('name', 'id')->all()) + ->default(fn (): ?int => Property::query()->where('is_active', true)->value('id')) + ->disabled(fn (?Channel $record): bool => $record !== null)->dehydrated()->columnSpanFull()] : []), + TextInput::make('name') + ->label('Name') + ->placeholder('z. B. FeWo-direkt') + ->required() + ->maxLength(100), + Select::make('status')->label('Kanalstatus')->options(ChannelStatus::class)->default(ChannelStatus::Setup)->required(), + 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') + ->options($registry->options()) + ->default('ical') + ->live() + ->required(), + Group::make() + ->columnSpanFull() + ->schema(fn (Get $get): array => filled($get('connector')) ? $registry->connectors()[$get('connector')]::settingsSchema() : []), + Toggle::make('import_enabled')->label('Import aktiviert')->default(false) + ->helperText('Abruf durch FewoPortal alle fünf Minuten, sofern der Kanal aktiv ist.'), + Toggle::make('export_enabled')->label('Export aktiviert')->default(false) + ->helperText('Ausgeschaltet bleibt der letzte gültige Export eingefroren erreichbar. Ohne Stand: HTTP 503, kein leerer Kalender.'), + Select::make('export_mode')->label('Exportmodus')->options(ChannelExportMode::class)->default(ChannelExportMode::Test)->required() + ->helperText('Testbetrieb exportiert keine Fremdbelegungen und gewährleistet keine vollständige kanalübergreifende Sperrung. Regulär nur nach bewusster Freigabe wählen.') + ->columnSpanFull(), + TextInput::make('external_poll_minutes')->label('Erwarteter externer Abrufabstand (Minuten)') + ->integer()->minValue(1)->maxValue(43200) + ->helperText('Nur eine Annahme zum Portal; verändert weder unseren Abruf noch bestätigt sie eine Übernahme.'), + Select::make('echo_behavior')->label('Beobachtetes Rückkopplungsverhalten')->options(ChannelEchoBehavior::class)->default(ChannelEchoBehavior::Unverified)->required()->columnSpanFull() + ->helperText('Bei Weitergabe mit neuen UIDs bleiben neue Importereignisse bis zur persönlichen Klärung vom Export ausgeschlossen. Sie sperren intern weiterhin.'), + Textarea::make('echo_notes')->label('Nachweis / Beobachtung zum Rückkopplungsverhalten')->maxLength(4000)->columnSpanFull(), + DateTimePicker::make('portal_verified_at')->label('Tatsächliche Übernahme im Portal zuletzt persönlich geprüft')->seconds(false) + ->helperText('Nur nach Sichtkontrolle im Portal eintragen. Wird durch einen Feedabruf nicht automatisch gesetzt.'), + Textarea::make('operating_notes')->label('Zusätzliche Anforderungen dieses Portals')->maxLength(4000)->columnSpanFull() + ->helperText('Zum Beispiel eine zusätzliche Bestätigung, dass der Belegungskalender gepflegt ist.'), + TextInput::make('settings.email_senders') + ->label('Absender der Buchungs-E-Mails (Schnellerkennung)') + ->helperText('Komma-getrennt, z. B. „fewo-direkt.de, vrbo.com“. Buchungsbestätigungen dieser Absender werden sofort gesperrt.') + ->maxLength(500) + ->columnSpanFull(), + Toggle::make('requires_manual_blocking') + ->label('Zusätzlich von Hand sperren (Sofortbuchung)') + ->helperText('Bei jeder Belegung über andere Wege entsteht eine Aufgabe „Im Portal sperren“ – für Portale, die unseren Kalender zu selten abholen.') + ->live() + ->columnSpanFull(), + TextInput::make('manage_url') + ->label('Link zum Kalender im Vermieterbereich') + ->url() + ->maxLength(2048) + ->visible(fn (Get $get): bool => (bool) $get('requires_manual_blocking')) + ->columnSpanFull(), + ]); + } +} diff --git a/app/Filament/Resources/Channels/Tables/ChannelsTable.php b/app/Filament/Resources/Channels/Tables/ChannelsTable.php new file mode 100644 index 0000000..a61f69f --- /dev/null +++ b/app/Filament/Resources/Channels/Tables/ChannelsTable.php @@ -0,0 +1,141 @@ +recordTitleAttribute('name') + ->defaultSort('id') + ->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('Für jedes neue Portal wird automatisch ein eigener dauerhafter Exportlink erzeugt. Über „Vertraulicher Exportlink“ kopieren Sie ihn in das Portal. Die Importadresse erhalten Sie vom Portal. Import und Export sind getrennt schaltbar; eine Pause hält den letzten gültigen Exportstand.') + ->modifyQueryUsing(fn (Builder $query) => $query->withCount(['blockedPeriods as review_count' => fn ($blocks) => $blocks->where('needs_review', true)])) + ->columns([ + TextColumn::make('property.name')->label('Wohnung')->visible($owner === null)->searchable(), + TextColumn::make('name')->label('Portal')->weight('medium')->searchable()->sortable(), + TextColumn::make('status')->label('Kanalstatus')->badge(), + TextColumn::make('import_state') + ->label('Import') + ->badge() + ->state(fn (Channel $record): string => match (true) { + ! $record->is_active || ! $record->import_enabled => 'Pausiert', + ! $record->importsOccupations() => 'Nicht eingerichtet', + $record->last_error !== null => 'Fehler', + $record->isStale() => 'Veraltet', + default => 'OK', + }) + ->color(fn (string $state): string => match ($state) { + 'OK' => 'success', + 'Fehler', 'Veraltet' => 'danger', + default => 'gray', + }) + ->tooltip(fn (Channel $record): ?string => $record->last_error), + TextColumn::make('last_success_at')->label('Letzter Abgleich')->since()->placeholder('–'), + TextColumn::make('last_error_at')->label('Letzter Importfehler')->dateTime('d.m.Y H:i')->placeholder('–')->toggleable(), + TextColumn::make('last_import_events')->label('Ereignisse'), + TextColumn::make('export_state')->label('Export')->badge()->state(fn (Channel $record): string => $record->exportsOccupations() ? 'Aktuell' : ($record->export_snapshot_at ? 'Eingefroren' : 'Kein Stand (503)')), + TextColumn::make('export_mode')->label('Exportmodus'), + TextColumn::make('echo_behavior')->label('Rückkopplung')->toggleable(), + TextColumn::make('portal_verified_at')->label('Übernahme im Portal persönlich geprüft')->dateTime('d.m.Y H:i')->placeholder('Nicht bestätigt')->toggleable(), + TextColumn::make('review_count')->label('Prüffälle')->badge(), + TextColumn::make('warning_count')->label('Hinweise')->state(fn (Channel $record): int => count($record->sync_warnings ?? [])) + ->tooltip(fn (Channel $record): string => implode(' ', $record->sync_warnings ?? []))->badge(), + TextColumn::make('external_poll_minutes')->label('Erwarteter Portalabruf')->suffix(' Min.')->placeholder('Unbekannt')->toggleable(), + TextColumn::make('last_export_requested_at')->label('Letzter Feedabruf (Client unbekannt)')->dateTime('d.m.Y H:i')->placeholder('–')->toggleable(), + TextColumn::make('requires_manual_blocking') + ->label('Handpflege') + ->formatStateUsing(fn (bool $state): string => $state ? 'ja' : '–'), + ]) + ->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'), + ] : []) + ->recordActions([ + Action::make('coverage')->label('Exportumfang prüfen')->modalSubmitAction(false)->modalCancelActionLabel('Schließen') + ->modalDescription('Aktuell berechneter Umfang der nächsten aktiven Ausgabe. Bei pausiertem Export bleibt der gespeicherte Stand maßgeblich. Ausgelassene Ereignisse sind unter Sperrzeiten mit Herkunft und Zuordnung einsehbar.') + ->schema([ + TextEntry::make('export_events')->label('Ereignisse im berechneten Feed')->state(fn (Channel $record): int => count(app(ICalParser::class)->parse(app(ICalFeed::class)->build($record)))), + TextEntry::make('held_events')->label('Importe in persönlicher Klärung oder zugeordnete Darstellungen')->state(fn (Channel $record): int => $record->property->blockedPeriods()->where(fn ($query) => $query->where('export_approved', false)->orWhere('is_representation', true))->count()), + ]), + Action::make('exportLink')->label('Vertraulicher Exportlink') + ->modalDescription('Diese Adresse erlaubt den Kalenderabruf. Nur dem vorgesehenen Portal geben. Ein Abruf beweist keine tatsächliche Übernahme.') + ->schema([ + TextEntry::make('export_url')->label('Kalenderadresse')->state(fn (Channel $record): string => $record->exportUrl())->copyable(), + TextEntry::make('token_transition')->label('Bisheriger Link bleibt gültig bis')->state(fn (Channel $record): string => $record->previous_export_token_expires_at?->format('d.m.Y H:i') ?? 'Keine Übergangsphase'), + ])->modalSubmitAction(false)->modalCancelActionLabel('Schließen'), + Action::make('rotateToken')->label('Exporttoken wechseln')->requiresConfirmation() + ->modalDescription('Eine neue Adresse entsteht. Die bisherige bleibt während der Übergangsphase gültig. Die neue Adresse selbst im Portal eintragen; danach Ablauf beachten.') + ->schema([TextInput::make('grace_hours')->label('Übergangsphase in Stunden')->integer()->minValue(24)->maxValue(720)->default(168)->required()]) + ->action(function (Channel $record, array $data, RotateChannelToken $rotate): void { + $rotate->handle($record, (int) $data['grace_hours']); + Notification::make()->title('Token gewechselt – neuen Exportlink im Portal eintragen')->success()->send(); + }), + Action::make('sync') + ->label('Jetzt abgleichen') + ->icon(Heroicon::OutlinedArrowPath) + ->visible(fn (Channel $record): bool => $record->importsOccupations()) + ->action(function (Channel $record, SyncChannel $syncChannel): void { + $log = $syncChannel->handle($record); + + $log->successful + ? Notification::make()->title("{$log->events} Belegungen eingelesen")->body("Neu: {$log->added}, geändert: {$log->changed}, entfernt: {$log->removed}, Konflikte: {$log->conflicts}")->success()->send() + : Notification::make()->title('Abgleich fehlgeschlagen')->body($log->message)->danger()->send(); + }), + Action::make('logs') + ->label('Protokoll') + ->icon(Heroicon::OutlinedListBullet) + ->color('gray') + ->modalSubmitAction(false) + ->modalCancelActionLabel('Schließen') + ->schema([ + RepeatableEntry::make('recentLogs') + ->hiddenLabel() + ->state(fn (Channel $record): array => $record->syncLogs()->limit(30)->get()->map(fn (ChannelSyncLog $log): array => [ + 'time' => $log->created_at->format('d.m. H:i'), + 'result' => $log->successful ? "✓ {$log->events} Belegungen (+{$log->added} ~{$log->changed} -{$log->removed})" : '✗ '.$log->message, + 'conflicts' => $log->conflicts ?: '', + 'warnings' => implode(' ', $log->warnings ?? []), + ])->all()) + ->table([ + TableColumn::make('Zeit'), + TableColumn::make('Ergebnis'), + TableColumn::make('Konflikte'), + TableColumn::make('Hinweise'), + ]) + ->schema([ + TextEntry::make('time'), + TextEntry::make('result'), + TextEntry::make('conflicts'), + TextEntry::make('warnings'), + ]), + ]), + ...($owner ? [EditAction::make()->mutateRecordDataUsing(fn (array $data, Channel $record): array => [...$data, 'settings' => $record->settings]) + ->using(fn (Channel $record, array $data): Channel => app(ConfigureChannel::class)->handle($owner, $data, $record))] : [EditAction::make()]), + ]); + } +} diff --git a/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php b/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php index b26ef0c..e23740c 100644 --- a/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php +++ b/app/Filament/Resources/Properties/RelationManagers/ChannelsRelationManager.php @@ -2,38 +2,11 @@ namespace App\Filament\Resources\Properties\RelationManagers; -use App\Actions\ConfigureChannel; -use App\Actions\RotateChannelToken; -use App\Actions\SyncChannel; -use App\Channels\ChannelRegistry; -use App\Channels\ICal\ICalFeed; -use App\Channels\ICal\ICalParser; -use App\Enums\ChannelBookingModel; -use App\Enums\ChannelEchoBehavior; -use App\Enums\ChannelExportMode; -use App\Enums\ChannelStatus; -use App\Models\Channel; -use App\Models\ChannelSyncLog; -use Filament\Actions\Action; -use Filament\Actions\CreateAction; -use Filament\Actions\EditAction; -use Filament\Forms\Components\DateTimePicker; -use Filament\Forms\Components\Select; -use Filament\Forms\Components\Textarea; -use Filament\Forms\Components\TextInput; -use Filament\Forms\Components\Toggle; -use Filament\Infolists\Components\RepeatableEntry; -use Filament\Infolists\Components\RepeatableEntry\TableColumn; -use Filament\Infolists\Components\TextEntry; -use Filament\Notifications\Notification; +use App\Filament\Resources\Channels\Schemas\ChannelForm; +use App\Filament\Resources\Channels\Tables\ChannelsTable; use Filament\Resources\RelationManagers\RelationManager; -use Filament\Schemas\Components\Group; -use Filament\Schemas\Components\Utilities\Get; use Filament\Schemas\Schema; -use Filament\Support\Icons\Heroicon; -use Filament\Tables\Columns\TextColumn; use Filament\Tables\Table; -use Illuminate\Database\Eloquent\Builder; class ChannelsRelationManager extends RelationManager { @@ -47,171 +20,11 @@ class ChannelsRelationManager extends RelationManager public function form(Schema $schema): Schema { - $registry = app(ChannelRegistry::class); - - return $schema - ->columns(2) - ->components([ - TextInput::make('name') - ->label('Name') - ->placeholder('z. B. FeWo-direkt') - ->required() - ->maxLength(100), - Select::make('status')->label('Kanalstatus')->options(ChannelStatus::class)->default(ChannelStatus::Setup)->required(), - 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') - ->options($registry->options()) - ->default('ical') - ->live() - ->required(), - Group::make() - ->columnSpanFull() - ->schema(fn (Get $get): array => filled($get('connector')) ? $registry->connectors()[$get('connector')]::settingsSchema() : []), - Toggle::make('import_enabled')->label('Import aktiviert')->default(false) - ->helperText('Abruf durch FewoPortal alle fünf Minuten, sofern der Kanal aktiv ist.'), - Toggle::make('export_enabled')->label('Export aktiviert')->default(false) - ->helperText('Ausgeschaltet bleibt der letzte gültige Export eingefroren erreichbar. Ohne Stand: HTTP 503, kein leerer Kalender.'), - Select::make('export_mode')->label('Exportmodus')->options(ChannelExportMode::class)->default(ChannelExportMode::Test)->required() - ->helperText('Testbetrieb exportiert keine Fremdbelegungen und gewährleistet keine vollständige kanalübergreifende Sperrung. Regulär nur nach bewusster Freigabe wählen.') - ->columnSpanFull(), - TextInput::make('external_poll_minutes')->label('Erwarteter externer Abrufabstand (Minuten)') - ->integer()->minValue(1)->maxValue(43200) - ->helperText('Nur eine Annahme zum Portal; verändert weder unseren Abruf noch bestätigt sie eine Übernahme.'), - Select::make('echo_behavior')->label('Beobachtetes Rückkopplungsverhalten')->options(ChannelEchoBehavior::class)->default(ChannelEchoBehavior::Unverified)->required()->columnSpanFull() - ->helperText('Bei Weitergabe mit neuen UIDs bleiben neue Importereignisse bis zur persönlichen Klärung vom Export ausgeschlossen. Sie sperren intern weiterhin.'), - Textarea::make('echo_notes')->label('Nachweis / Beobachtung zum Rückkopplungsverhalten')->maxLength(4000)->columnSpanFull(), - DateTimePicker::make('portal_verified_at')->label('Tatsächliche Übernahme im Portal zuletzt persönlich geprüft')->seconds(false) - ->helperText('Nur nach Sichtkontrolle im Portal eintragen. Wird durch einen Feedabruf nicht automatisch gesetzt.'), - Textarea::make('operating_notes')->label('Zusätzliche Anforderungen dieses Portals')->maxLength(4000)->columnSpanFull() - ->helperText('Zum Beispiel eine zusätzliche Bestätigung, dass der Belegungskalender gepflegt ist.'), - TextInput::make('settings.email_senders') - ->label('Absender der Buchungs-E-Mails (Schnellerkennung)') - ->helperText('Komma-getrennt, z. B. „fewo-direkt.de, vrbo.com“. Buchungsbestätigungen dieser Absender werden sofort gesperrt.') - ->maxLength(500) - ->columnSpanFull(), - Toggle::make('requires_manual_blocking') - ->label('Zusätzlich von Hand sperren (Sofortbuchung)') - ->helperText('Bei jeder Belegung über andere Wege entsteht eine Aufgabe „Im Portal sperren“ – für Portale, die unseren Kalender zu selten abholen.') - ->live() - ->columnSpanFull(), - TextInput::make('manage_url') - ->label('Link zum Kalender im Vermieterbereich') - ->url() - ->maxLength(2048) - ->visible(fn (Get $get): bool => (bool) $get('requires_manual_blocking')) - ->columnSpanFull(), - ]); + return ChannelForm::configure($schema); } public function table(Table $table): Table { - return $table - ->recordTitleAttribute('name') - ->description('Für jedes neue Portal wird automatisch ein eigener dauerhafter Exportlink erzeugt. Über „Vertraulicher Exportlink“ kopieren Sie ihn in das Portal. Die Importadresse erhalten Sie vom Portal. Import und Export sind getrennt schaltbar; eine Pause hält den letzten gültigen Exportstand.') - ->modifyQueryUsing(fn (Builder $query) => $query->withCount(['blockedPeriods as review_count' => fn ($blocks) => $blocks->where('needs_review', true)])) - ->columns([ - TextColumn::make('name')->label('Portal')->weight('medium'), - TextColumn::make('status')->label('Kanalstatus')->badge(), - TextColumn::make('import_state') - ->label('Import') - ->badge() - ->state(fn (Channel $record): string => match (true) { - ! $record->is_active || ! $record->import_enabled => 'Pausiert', - ! $record->importsOccupations() => 'Nicht eingerichtet', - $record->last_error !== null => 'Fehler', - $record->isStale() => 'Veraltet', - default => 'OK', - }) - ->color(fn (string $state): string => match ($state) { - 'OK' => 'success', - 'Fehler', 'Veraltet' => 'danger', - default => 'gray', - }) - ->tooltip(fn (Channel $record): ?string => $record->last_error), - TextColumn::make('last_success_at')->label('Letzter Abgleich')->since()->placeholder('–'), - TextColumn::make('last_error_at')->label('Letzter Importfehler')->dateTime('d.m.Y H:i')->placeholder('–')->toggleable(), - TextColumn::make('last_import_events')->label('Ereignisse'), - TextColumn::make('export_state')->label('Export')->badge()->state(fn (Channel $record): string => $record->exportsOccupations() ? 'Aktuell' : ($record->export_snapshot_at ? 'Eingefroren' : 'Kein Stand (503)')), - TextColumn::make('export_mode')->label('Exportmodus'), - TextColumn::make('echo_behavior')->label('Rückkopplung')->toggleable(), - TextColumn::make('portal_verified_at')->label('Übernahme im Portal persönlich geprüft')->dateTime('d.m.Y H:i')->placeholder('Nicht bestätigt')->toggleable(), - TextColumn::make('review_count')->label('Prüffälle')->badge(), - TextColumn::make('warning_count')->label('Hinweise')->state(fn (Channel $record): int => count($record->sync_warnings ?? [])) - ->tooltip(fn (Channel $record): string => implode(' ', $record->sync_warnings ?? []))->badge(), - TextColumn::make('external_poll_minutes')->label('Erwarteter Portalabruf')->suffix(' Min.')->placeholder('Unbekannt')->toggleable(), - TextColumn::make('last_export_requested_at')->label('Letzter Feedabruf (Client unbekannt)')->dateTime('d.m.Y H:i')->placeholder('–')->toggleable(), - TextColumn::make('requires_manual_blocking') - ->label('Handpflege') - ->formatStateUsing(fn (bool $state): string => $state ? 'ja' : '–'), - ]) - ->headerActions([ - CreateAction::make()->using(fn (array $data): Channel => app(ConfigureChannel::class)->handle($this->getOwnerRecord(), $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'), - ]) - ->recordActions([ - Action::make('coverage')->label('Exportumfang prüfen')->modalSubmitAction(false)->modalCancelActionLabel('Schließen') - ->modalDescription('Aktuell berechneter Umfang der nächsten aktiven Ausgabe. Bei pausiertem Export bleibt der gespeicherte Stand maßgeblich. Ausgelassene Ereignisse sind unter Sperrzeiten mit Herkunft und Zuordnung einsehbar.') - ->schema([ - TextEntry::make('export_events')->label('Ereignisse im berechneten Feed')->state(fn (Channel $record): int => count(app(ICalParser::class)->parse(app(ICalFeed::class)->build($record)))), - TextEntry::make('held_events')->label('Importe in persönlicher Klärung oder zugeordnete Darstellungen')->state(fn (Channel $record): int => $record->property->blockedPeriods()->where(fn ($query) => $query->where('export_approved', false)->orWhere('is_representation', true))->count()), - ]), - Action::make('exportLink')->label('Vertraulicher Exportlink') - ->modalDescription('Diese Adresse erlaubt den Kalenderabruf. Nur dem vorgesehenen Portal geben. Ein Abruf beweist keine tatsächliche Übernahme.') - ->schema([ - TextEntry::make('export_url')->label('Kalenderadresse')->state(fn (Channel $record): string => $record->exportUrl())->copyable(), - TextEntry::make('token_transition')->label('Bisheriger Link bleibt gültig bis')->state(fn (Channel $record): string => $record->previous_export_token_expires_at?->format('d.m.Y H:i') ?? 'Keine Übergangsphase'), - ])->modalSubmitAction(false)->modalCancelActionLabel('Schließen'), - Action::make('rotateToken')->label('Exporttoken wechseln')->requiresConfirmation() - ->modalDescription('Eine neue Adresse entsteht. Die bisherige bleibt während der Übergangsphase gültig. Die neue Adresse selbst im Portal eintragen; danach Ablauf beachten.') - ->schema([TextInput::make('grace_hours')->label('Übergangsphase in Stunden')->integer()->minValue(24)->maxValue(720)->default(168)->required()]) - ->action(function (Channel $record, array $data, RotateChannelToken $rotate): void { - $rotate->handle($record, (int) $data['grace_hours']); - Notification::make()->title('Token gewechselt – neuen Exportlink im Portal eintragen')->success()->send(); - }), - Action::make('sync') - ->label('Jetzt abgleichen') - ->icon(Heroicon::OutlinedArrowPath) - ->visible(fn (Channel $record): bool => $record->importsOccupations()) - ->action(function (Channel $record, SyncChannel $syncChannel): void { - $log = $syncChannel->handle($record); - - $log->successful - ? Notification::make()->title("{$log->events} Belegungen eingelesen")->body("Neu: {$log->added}, geändert: {$log->changed}, entfernt: {$log->removed}, Konflikte: {$log->conflicts}")->success()->send() - : Notification::make()->title('Abgleich fehlgeschlagen')->body($log->message)->danger()->send(); - }), - Action::make('logs') - ->label('Protokoll') - ->icon(Heroicon::OutlinedListBullet) - ->color('gray') - ->modalSubmitAction(false) - ->modalCancelActionLabel('Schließen') - ->schema([ - RepeatableEntry::make('recentLogs') - ->hiddenLabel() - ->state(fn (Channel $record): array => $record->syncLogs()->limit(30)->get()->map(fn (ChannelSyncLog $log): array => [ - 'time' => $log->created_at->format('d.m. H:i'), - 'result' => $log->successful ? "✓ {$log->events} Belegungen (+{$log->added} ~{$log->changed} -{$log->removed})" : '✗ '.$log->message, - 'conflicts' => $log->conflicts ?: '', - 'warnings' => implode(' ', $log->warnings ?? []), - ])->all()) - ->table([ - TableColumn::make('Zeit'), - TableColumn::make('Ergebnis'), - TableColumn::make('Konflikte'), - TableColumn::make('Hinweise'), - ]) - ->schema([ - TextEntry::make('time'), - TextEntry::make('result'), - TextEntry::make('conflicts'), - TextEntry::make('warnings'), - ]), - ]), - EditAction::make()->mutateRecordDataUsing(fn (array $data, Channel $record): array => [...$data, 'settings' => $record->settings]) - ->using(fn (Channel $record, array $data): Channel => app(ConfigureChannel::class)->handle($this->getOwnerRecord(), $data, $record)), - ]); + return ChannelsTable::configure($table, $this->getOwnerRecord()); } } diff --git a/app/Policies/ChannelPolicy.php b/app/Policies/ChannelPolicy.php new file mode 100644 index 0000000..e012b75 --- /dev/null +++ b/app/Policies/ChannelPolicy.php @@ -0,0 +1,13 @@ + Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“). +**Eigenständige Portalverwaltung (Folgeauftrag 27.10.2026):** Eigene Seite **Vermietung › Portale & Kalender** (`/admin/channels`), auch in der einfachen Ansicht, für frei benannte Kanäle und individuell gewählte Wohnungen. Automatische dauerhafte Exportlinks, vollständige Konfiguration, manuelle Abgleiche und Überwachung über gemeinsame Formulare/Aktionen mit der Wohnungsansicht. Rollen und Mandantentrennung über `ChannelPolicy`. **Keinen Ostseeklar-Kanal oder anderen neuen Anbieter eingerichtet.** Der vorausgehende iCal-Kern wurde durch [Pipeline 4662](https://gitea.stommer.de/Lars/fewo-stommer/actions/runs/4662) erfolgreich mit Commit `7830685` nach stommer.info ausgeliefert; Server-REVISION und beide MariaDB-Migrationen in Batch 16 bestätigt. **368 Feature-Tests / 1755 Assertions lokal erfolgreich, Pint erfolgreich.** Folge-Deployment der eigenständigen Seite wird über dieselbe Pipeline ausgeliefert. [Benutzung und Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). + **iCal-MVP zur Auslieferung vorbereitet (27.10.2026):** Automatischer eigener dauerhafter Exportlink je frei benanntem Portalkanal in der Verwaltung; manuelle Klärung und Zuordnung mehrfach dargestellter Belegungen; führende Sperre/Buchung steuert Verfügbarkeit und Export, zugeordnete UID-Darstellungen bleiben nachvollziehbar. Archivierung erhält die Identität verschwundener und wiederkehrender Ereignisse. Konfigurierbares Echoverhalten, Exportumfang, Portal-Pflegehinweise und getrennte persönliche Übernahmeprüfung ergänzt. **359 Feature-Tests / 1701 Assertions lokal erfolgreich, Pint erfolgreich.** Der Nutzer hat Deployment und Migration auf der bestehenden Instanz ausdrücklich beauftragt. Keine separate Testinstallation. Vorab auf stommer.info gelesen: ein reiner FeWo-direkt-Exportkanal, keine Sperren und keine belegende Buchung; Link unverändert HTTP 200 ohne Ereignisse. Externe Importadressen fehlen dort noch und sollen auf Wunsch über die Oberfläche statt lokaler JSON-Datei eingetragen werden. [Benutzung, Zuordnung und praktische Abnahme](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Auslieferungsnachweis folgt nach Abschluss der bestehenden Pipeline. **Generische iCal-Kanäle lokal umgesetzt (27.10.2026):** Auf `feature/ical-portalkanaele` wurde das vorhandene Connector-System erweitert: getrennte Import-/Exportrichtungen, Einrichtungsstatus und Buchungsmodell, Test-/Regulärmodus, eingefrorener letzter Export bei Pause, kontrollierte Tokenrotation, zusätzliche Herkunft, strikte vollständige Feedprüfung, bestätigte Entfernung fehlender Ereignisse und Prüffälle statt datumsbasierter Mail/iCal-Zusammenführung. Portal-Aufgaben erhalten alte/neue Termine nach Commit und geben nur aktuell freie Nächte frei; überholte Automationsaufgaben werden vor Übergabe verworfen. **Abnahme lokal: 347 Feature-Tests / 1626 Assertions grün, darunter 44 neue iCal-Fälle; Pint erfolgreich.** Neue Migration ausschließlich an synthetischer SQLite-In-Memory-Testdatenbank geprüft, keine Anwendungsdatenbank migriert. [GAP-Analyse, Konfiguration, Grenzen, Testplan und Freigabe](architecture/ical-kanalkonfiguration.md). **Nicht ausgeliefert, keine echte Kalenderverknüpfung, kein Server-/Portalbestand verändert.** Bestehende Kanäle behalten bei späterer Migration ihren bisherigen regulären Exportumfang; neue starten ausgeschaltet im Testmodus. Offen vor Auslieferung: MariaDB-/Zielsystemprüfung, Bestandsklärung und ausdrückliche Freigabe realer Verbindungen. Die von Lars berichtete FeWo-direkt-Probe ist ein konkreter Nutzerbericht, kein allgemeiner Nachweis des Portalverhaltens. Der historische iCal-Prüfbericht bleibt unverändert. diff --git a/docs/architecture/ical-kanalkonfiguration.md b/docs/architecture/ical-kanalkonfiguration.md index 466e3c0..1aeb6ce 100644 --- a/docs/architecture/ical-kanalkonfiguration.md +++ b/docs/architecture/ical-kanalkonfiguration.md @@ -1,6 +1,6 @@ # Generische iCal-Integration und konfigurierbare Portalkanäle -Stand: 27.10.2026 · lokale Implementierung auf `feature/ical-portalkanaele` · **noch nicht ausgeliefert** +Stand: 27.10.2026 · erste Ausbaustufe und MVP-Kern mit `7830685` auf stommer.info ausgeliefert, Pipeline 4662 erfolgreich. Aktuelle eigenständige Verwaltungsseite und 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. @@ -40,7 +40,7 @@ ## 2. Kompakte GAP-Analyse ## 3. Kanal je Wohnung konfigurieren -Ort: **Verwaltung → Wohnung → Portale & Kanäle**. Der Kanal gehört zur geöffneten Wohnung und ihrem Mandanten. Namen wie „FeWo-direkt“ und „Ostseeklar“ sind freie Konfiguration; der Connector bleibt `ical`. +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`. | 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 5a24e6f..95f8984 100644 --- a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md +++ b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md @@ -1,10 +1,12 @@ # iCal-MVP: Bereitstellung und Benutzung -Stand: 27.10.2026 · Auslieferung vorbereitet; tatsächlicher Auslieferungsnachweis wird nach Pipeline-Abschluss ergänzt. +Stand: 27.10.2026 · Kern `7830685` auf stommer.info ausgeliefert, Pipeline 4662 erfolgreich. Eigenständige Verwaltungsseite im Folge-Deployment; Nachweis wird nach dessen Abschluss ergänzt. ## Oberfläche und automatische Exportlinks -Unter **Verwaltung → Wohnungen → Wohnung bearbeiten → Portale & Kanäle** wird jeder weitere Anbieter mit einem frei wählbaren Namen und der Anbindung „Kalender-Abgleich (iCal)“ angelegt. Für FeWo-direkt, Ostseeklar und weitere kompatible Anbieter gilt derselbe Ablauf. +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. + +Jeder Kanal lässt sich individuell konfigurieren und bearbeiten. Die Liste 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. **Beim Speichern erzeugt FewoPortal automatisch einen eigenen dauerhaften Exportlink für diesen Kanal.** Keine Datei, manuelle Tokenanlage oder Programmierung ist nötig. Über **„Vertraulicher Exportlink“** wird die Adresse 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. @@ -46,7 +48,7 @@ ## Intervalle und Ostseeklar ## Verifikation und praktische Grenzen -Lokale Gesamtabnahme: **359 Feature-Tests / 1701 Assertions erfolgreich**, Pint erfolgreich. Zwölf zusätzliche MVP-Fälle prüfen unter anderem automatische Links beliebig benannter Portale, Zuordnung in der Verwaltung, Rollen, getrennte UID-Identität, Echozurückhaltung, Stornierung der führenden Belegung und Wiederauftauchen derselben UID. Die bisherigen 44 iCal-Fälle bleiben enthalten. +Die erste lokale Gesamtabnahme und Pipeline 4662 umfassen **359 Feature-Tests / 1701 Assertions**, Pint erfolgreich. Zwölf zusätzliche MVP-Fälle prüfen unter anderem automatische Links beliebig benannter Portale, Zuordnung in der Verwaltung, Rollen, getrennte UID-Identität, Echozurückhaltung, Stornierung der führenden Belegung und Wiederauftauchen derselben UID. Die bisherigen 44 iCal-Fälle bleiben enthalten. Neun weitere Tests der eigenständigen Oberfläche prüfen frei benannte Kanäle, geschützte Linkanzeige, individuelle Bearbeitung, sichere Exportpause, Schutz vor ungeprüftem Quellwechsel, manuellen Import, Rollen, einfache Ansicht und Mandantentrennung. **Abschließende lokale Gesamtabnahme: 368 Feature-Tests / 1755 Assertions erfolgreich; Pint erfolgreich.** Vor Auslieferung wurde der vorhandene FeWo-direkt-Export auf stommer.info lesend geprüft: HTTP 200, derzeit kein Ereignis. Der Serverbestand enthält keine Sperren und nur eine abgelehnte sowie eine stornierte Buchung. Es wird kein realer Aufenthalt für Tests geändert. Der bereits eingerichtete Exportlink wird weder ersetzt noch rotiert. diff --git a/tests/Feature/ChannelManagementTest.php b/tests/Feature/ChannelManagementTest.php new file mode 100644 index 0000000..07a9531 --- /dev/null +++ b/tests/Feature/ChannelManagementTest.php @@ -0,0 +1,144 @@ +property(); + $this->actingAs(User::factory()->create()); + foreach (['Mein Anfrageportal', 'Ein weiterer Anbieter'] as $name) { + Livewire::test(CreateChannel::class)->fillForm(['property_id' => $property->id, 'name' => $name, 'connector' => 'ical'])->call('create')->assertHasNoFormErrors(); + } + $channels = Channel::all(); + $this->assertSame(2, $channels->count()); + $this->assertSame(2, $channels->pluck('export_token')->unique()->count()); + $this->assertSame([ChannelStatus::Setup, false, false, ChannelExportMode::Test], [$channels[0]->status, $channels[0]->import_enabled, $channels[0]->export_enabled, $channels[0]->export_mode]); + $this->assertSame($property->id, $channels[1]->property_id); + Livewire::test(ListChannels::class)->assertCanSeeTableRecords($channels)->assertSee('Mein Anfrageportal')->assertSee('Ein weiterer Anbieter'); + } + + public function test_management_list_hides_secret_urls_until_the_link_action_is_opened(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(['settings' => ['import_url' => 'https://portal.example/private-import-secret.ics']]); + $this->actingAs(User::factory()->create()); + $page = Livewire::test(ListChannels::class)->assertCanSeeTableRecords([$channel])->assertDontSee($channel->export_token)->assertDontSee('private-import-secret'); + $page->mountAction(TestAction::make('exportLink')->table($channel))->assertActionMounted(TestAction::make('exportLink')->table($channel)); + $schema = $page->instance()->getSchema($page->instance()->getMountedActionSchemaName()); + $entry = collect($schema->getFlatComponents())->first(fn ($component): bool => $component instanceof TextEntry && $component->getName() === 'export_url'); + $this->assertSame($channel->exportUrl(), $entry->getState()); + } + + public function test_editing_preserves_the_link_and_the_independent_configuration_of_another_channel(): void + { + $property = $this->property(); + $a = Channel::factory()->for($property)->create(['settings' => ['import_url' => 'https://portal.example/calendar.ics']]); + $b = Channel::factory()->for($property)->create(); + $token = $a->export_token; + $this->actingAs(User::factory()->create()); + Livewire::test(EditChannel::class, ['record' => $a->id])->fillForm(['name' => 'Individuell gepflegt', 'import_enabled' => false, 'export_enabled' => true, 'external_poll_minutes' => 90])->call('save')->assertHasNoFormErrors(); + $this->assertSame(['Individuell gepflegt', false, true, 90, $token], [$a->fresh()->name, $a->fresh()->import_enabled, $a->fresh()->export_enabled, $a->fresh()->external_poll_minutes, $a->fresh()->export_token]); + $this->assertTrue($b->fresh()->import_enabled); + $this->assertSame('https://portal.example/calendar.ics', $a->fresh()->setting('import_url')); + } + + public function test_editor_uses_safe_export_pause_instead_of_a_bare_model_update(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(); + BlockedPeriod::factory()->for($property)->create(['starts_on' => '2027-05-23', 'ends_on' => '2027-05-30']); + $this->actingAs(User::factory()->create()); + Livewire::test(EditChannel::class, ['record' => $channel->id])->fillForm(['export_enabled' => false])->call('save')->assertHasNoFormErrors(); + $this->get($channel->exportUrl())->assertOk()->assertHeader('X-Fewo-Export-State', 'frozen')->assertSee('20270523'); + $this->assertNotNull($channel->fresh()->export_snapshot_at); + } + + public function test_editor_cannot_replace_the_source_of_an_existing_import_inventory(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(['settings' => ['import_url' => 'https://portal.example/calendar.ics']]); + BlockedPeriod::factory()->for($property)->create(['source' => 'channel', 'channel_id' => $channel->id, 'external_uid' => 'existing']); + $this->actingAs(User::factory()->create()); + Livewire::test(EditChannel::class, ['record' => $channel->id])->fillForm(['settings' => ['import_url' => 'https://other.example/new.ics']])->call('save')->assertHasFormErrors(); + $this->assertSame('https://portal.example/calendar.ics', $channel->fresh()->setting('import_url')); + } + + public function test_manual_import_works_from_the_standalone_list(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(['settings' => ['import_url' => 'https://portal.example/synthetic.ics']]); + $this->actingAs(User::factory()->create()); + Http::preventStrayRequests(); + Http::fake(['https://portal.example/synthetic.ics' => Http::response("BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Synthetic//DE\r\nBEGIN:VEVENT\r\nUID:one\r\nDTSTAMP:20261027T120000Z\r\nDTSTART;VALUE=DATE:20270523\r\nDTEND;VALUE=DATE:20270530\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n")]); + Mail::fake(); + Livewire::test(ListChannels::class)->callTableAction('sync', $channel)->assertNotified('1 Belegungen eingelesen'); + $this->assertSame('one', $channel->blockedPeriods()->sole()->external_uid); + Http::assertSentCount(1); + } + + public function test_content_role_cannot_list_or_create_portal_connections(): void + { + $this->property(); + $this->actingAs(User::factory()->role(UserRole::Content)->create()); + Livewire::test(ListChannels::class)->assertForbidden(); + Livewire::test(CreateChannel::class)->assertForbidden(); + } + + public function test_rentals_role_can_reach_portal_management_in_simple_mode(): void + { + $this->property(); + $this->actingAs(User::factory()->role(UserRole::Rentals)->create(['admin_mode' => AdminMode::Simple])); + Livewire::test(ListChannels::class)->assertSuccessful(); + $this->assertTrue(ChannelResource::shouldRegisterNavigation()); + } + + public function test_another_landlords_channel_cannot_be_seen_or_edited(): void + { + $property = $this->property(); + $otherTenant = Tenant::factory()->create(); + app(TenantContext::class)->set($otherTenant); + $other = Channel::factory()->create(['name' => 'Vertraulicher fremder Kanal']); + app(TenantContext::class)->set($property->tenant); + $this->actingAs(User::factory()->create()); + Livewire::test(ListChannels::class)->assertCanNotSeeTableRecords([$other])->assertDontSee('Vertraulicher fremder Kanal'); + Livewire::test(EditChannel::class, ['record' => $other->id])->assertNotFound(); + } + + private function property(): Property + { + $this->travelTo(CarbonImmutable::parse('2026-10-27 12:00')); + $this->seed(PropertySeeder::class); + $property = Property::sole(); + app(TenantContext::class)->set($property->tenant); + + return $property; + } +}