From 511faa64d2dece9c5695ee305fb806579220861e Mon Sep 17 00:00:00 2001 From: Lars Date: Tue, 27 Oct 2026 17:48:17 +0100 Subject: [PATCH] Portale als Kacheln zeigen und Kalenderabrufe je Kanal protokollieren --- app/Channels/ICal/ICalExport.php | 21 +- .../Channels/Tables/ChannelsTable.php | 180 +++++++++--------- app/Http/Controllers/ChannelController.php | 4 +- app/Models/Channel.php | 6 + app/Models/ChannelExportRequest.php | 28 +++ app/Tenancy/TenantArchive.php | 1 + config/channels.php | 1 + ...3_create_channel_export_requests_table.php | 34 ++++ docs/STATUS.md | 2 + docs/architecture/ical-kanalkonfiguration.md | 4 +- .../ical-mvp-inbetriebnahme-2026-10-27.md | 14 +- tests/Feature/ChannelExportRequestTest.php | 140 ++++++++++++++ 12 files changed, 337 insertions(+), 98 deletions(-) create mode 100644 app/Models/ChannelExportRequest.php create mode 100644 database/migrations/2026_10_27_173923_create_channel_export_requests_table.php create mode 100644 tests/Feature/ChannelExportRequestTest.php diff --git a/app/Channels/ICal/ICalExport.php b/app/Channels/ICal/ICalExport.php index 5a0de9e..ac13d05 100644 --- a/app/Channels/ICal/ICalExport.php +++ b/app/Channels/ICal/ICalExport.php @@ -9,16 +9,31 @@ class ICalExport { public function __construct(private ICalFeed $feed, private ICalParser $parser) {} - public function build(Channel $channel): ?string + public function build(Channel $channel, string $method = 'GET', ?string $userAgent = null): ?string { - return DB::transaction(function () use ($channel): ?string { + $requestedAt = now(); + + return DB::transaction(function () use ($channel, $method, $userAgent, $requestedAt): ?string { $locked = Channel::query()->whereKey($channel->id)->lockForUpdate()->firstOrFail(); if ($locked->exportsOccupations()) { $body = $this->feed->build($locked); $this->parser->parse($body); $locked->forceFill(['export_snapshot' => $body, 'export_snapshot_at' => now()]); } - $locked->forceFill(['last_export_requested_at' => now()])->saveQuietly(); + $lastRequest = $locked->last_export_requested_at; + $locked->forceFill(['last_export_requested_at' => $lastRequest?->greaterThan($requestedAt) ? $lastRequest : $requestedAt])->saveQuietly(); + $userAgent = str_replace(array_filter([$locked->export_token, $locked->previous_export_token]), '[Token entfernt]', $userAgent ?? ''); + $locked->exportRequests()->create([ + 'requested_at' => $requestedAt, + 'method' => $method, + 'user_agent' => filled($userAgent) ? mb_substr(str_replace(["\r", "\n"], ' ', $userAgent), 0, 512) : null, + 'response_status' => $locked->export_snapshot === null ? 503 : 200, + 'export_state' => $locked->export_snapshot === null ? 'unavailable' : ($locked->exportsOccupations() ? 'live' : 'frozen'), + ]); + $expired = $locked->exportRequests()->skip(max(1, (int) config('channels.export_request_history_limit', 100)))->take(1000)->pluck('id'); + if ($expired->isNotEmpty()) { + $locked->exportRequests()->whereIn('id', $expired)->delete(); + } return $locked->export_snapshot; }); diff --git a/app/Filament/Resources/Channels/Tables/ChannelsTable.php b/app/Filament/Resources/Channels/Tables/ChannelsTable.php index a61f69f..c95c2fb 100644 --- a/app/Filament/Resources/Channels/Tables/ChannelsTable.php +++ b/app/Filament/Resources/Channels/Tables/ChannelsTable.php @@ -11,6 +11,7 @@ use App\Models\ChannelSyncLog; use App\Models\Property; use Filament\Actions\Action; +use Filament\Actions\ActionGroup; use Filament\Actions\CreateAction; use Filament\Actions\EditAction; use Filament\Forms\Components\TextInput; @@ -19,6 +20,7 @@ use Filament\Infolists\Components\TextEntry; use Filament\Notifications\Notification; use Filament\Support\Icons\Heroicon; +use Filament\Tables\Columns\Layout\Stack; use Filament\Tables\Columns\TextColumn; use Filament\Tables\Table; use Illuminate\Database\Eloquent\Builder; @@ -30,45 +32,29 @@ public static function configure(Table $table, ?Property $owner = null): Table return $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('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.') + ->description('Jeder Kanal hat einen eigenen Exportlink. Einstellungen ändern Sie über „Bearbeiten“, Abgleiche und Protokolle finden Sie im Zusatzmenü.') ->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' : '–'), + Stack::make([ + TextColumn::make('name')->label('Portal')->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 => $record->importsOccupations() && $record->last_error !== null ? 'Importfehler' : ($record->importsOccupations() && $record->isStale() ? 'Import veraltet' : $record->status->getLabel())) + ->color(fn (Channel $record): string => $record->importsOccupations() && ($record->last_error !== null || $record->isStale()) ? 'danger' : ($record->is_active ? 'success' : 'gray')) + ->description(fn (Channel $record): ?string => $record->review_count || count($record->sync_warnings ?? []) ? 'Prüffälle: '.$record->review_count.' · Hinweise: '.count($record->sync_warnings ?? []) : null) + ->tooltip(fn (Channel $record): ?string => $record->last_error), + TextColumn::make('directions')->label('Richtungen')->color('gray')->wrap() + ->state(fn (Channel $record): string => ($record->importsOccupations() ? 'Import aktiv' : 'Import aus').' · '.($record->exportsOccupations() ? 'Export aktiv' : ($record->export_snapshot_at ? 'Export eingefroren' : 'Export aus'))), + TextColumn::make('last_sync')->label('Letzter Sync-Lauf')->wrap() + ->state(fn (Channel $record): string => 'Letzter Sync: '.($record->last_synced_at?->format('d.m.Y H:i') ?? 'noch kein Lauf')) + ->description(fn (Channel $record): ?string => $record->last_error !== null ? 'Letzter Lauf mit Fehler' : null), + TextColumn::make('last_export_request')->label('Letzter Kalenderabruf')->wrap()->color('gray') + ->state(fn (Channel $record): string => 'Letzter Abruf: '.($record->last_export_requested_at?->format('d.m.Y H:i') ?? 'noch keiner')) + ->tooltip('Empfangener Aufruf dieses Kanalfeeds. Client und tatsächliche Übernahme im Portal sind damit nicht bestätigt.'), + ])->space(2), ]) ->headerActions($owner ? [ CreateAction::make()->using(fn (array $data): Channel => app(ConfigureChannel::class)->handle($owner, $data)) @@ -76,66 +62,82 @@ public static function configure(Table $table, ?Property $owner = null): Table ->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') + Action::make('exportLink')->label('Exportlink')->icon(Heroicon::OutlinedLink)->button() ->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('export_url')->label('Vertrauliche Kalenderadresse')->state(fn (Channel $record): string => $record->exportUrl())->copyable()->wrap()->extraAttributes(['style' => 'overflow-wrap:anywhere']), 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()]), + ActionGroup::make([ + 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.') + ->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('exportRequests')->label('Kalenderabrufe')->icon(Heroicon::OutlinedClock) + ->modalDescription('Die letzten 100 empfangenen Aufrufe dieses Kanalfeeds. Die vom Client gemeldete Kennung ist unbestätigt; auch Browser oder Tests können hier erscheinen. Ein Abruf beweist keine Übernahme im Portal.') + ->modalSubmitAction(false)->modalCancelActionLabel('Schließen') + ->schema([ + RepeatableEntry::make('requests')->label('Abrufhistorie') + ->state(fn (Channel $record): array => $record->exportRequests()->get()->map(fn ($entry): array => [ + 'time' => $entry->requested_at->format('d.m.Y H:i:s'), + 'result' => $entry->method.' · HTTP '.$entry->response_status.' · '.match ($entry->export_state) { + 'live' => 'Aktueller Stand', 'frozen' => 'Eingefrorener Stand', default => 'Kein Stand verfügbar' + }, + 'client' => $entry->user_agent ?? 'Keine Clientkennung übermittelt', + ])->all()) + ->schema([TextEntry::make('time')->label('Empfangen'), TextEntry::make('result')->label('Antwort'), TextEntry::make('client')->label('Clientangabe (unbestätigt)')->wrap()]), + ]), + 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'), + ]), + ]), + ])->label('Weitere Aktionen')->icon(Heroicon::OutlinedEllipsisVertical), ]); } } diff --git a/app/Http/Controllers/ChannelController.php b/app/Http/Controllers/ChannelController.php index 3a2a6ba..723e25f 100644 --- a/app/Http/Controllers/ChannelController.php +++ b/app/Http/Controllers/ChannelController.php @@ -23,14 +23,14 @@ */ class ChannelController extends Controller { - public function feed(string $token, ICalExport $feed): Response + public function feed(string $token, ICalExport $feed, Request $request): Response { $channel = Channel::query()->where(fn ($query) => $query->where('export_token', $token) ->orWhere(fn ($previous) => $previous->where('previous_export_token', $token)->where('previous_export_token_expires_at', '>', now())))->firstOrFail(); abort_unless($channel->servesItsLandlord(), 404); - $body = $feed->build($channel); + $body = $feed->build($channel, $request->method(), $request->userAgent()); if ($body === null) { return response('Der Export ist pausiert; es liegt noch kein gültiger Kalenderstand vor.', 503, ['Retry-After' => '300', 'Cache-Control' => 'no-store']); } diff --git a/app/Models/Channel.php b/app/Models/Channel.php index c063e6b..c734744 100644 --- a/app/Models/Channel.php +++ b/app/Models/Channel.php @@ -106,6 +106,12 @@ public function syncLogs(): HasMany return $this->hasMany(ChannelSyncLog::class)->latest('id'); } + /** @return HasMany */ + public function exportRequests(): HasMany + { + return $this->hasMany(ChannelExportRequest::class)->latest('requested_at')->latest('id'); + } + /** * @return HasMany */ diff --git a/app/Models/ChannelExportRequest.php b/app/Models/ChannelExportRequest.php new file mode 100644 index 0000000..14e60d4 --- /dev/null +++ b/app/Models/ChannelExportRequest.php @@ -0,0 +1,28 @@ + */ + protected function casts(): array + { + return ['requested_at' => 'immutable_datetime', 'response_status' => 'integer']; + } + + /** @return BelongsTo */ + public function channel(): BelongsTo + { + return $this->belongsTo(Channel::class); + } +} diff --git a/app/Tenancy/TenantArchive.php b/app/Tenancy/TenantArchive.php index 89e401d..44d2e94 100644 --- a/app/Tenancy/TenantArchive.php +++ b/app/Tenancy/TenantArchive.php @@ -31,6 +31,7 @@ class TenantArchive private const DELETE_ORDER = [ 'floor_plans', 'channel_sync_logs', + 'channel_export_requests', 'channel_tasks', 'portal_emails', 'payments', diff --git a/config/channels.php b/config/channels.php index b0183fb..2a7c054 100644 --- a/config/channels.php +++ b/config/channels.php @@ -27,5 +27,6 @@ 'removal_confirmation_runs' => 2, 'max_automatic_removals' => 5, + 'export_request_history_limit' => 100, ]; diff --git a/database/migrations/2026_10_27_173923_create_channel_export_requests_table.php b/database/migrations/2026_10_27_173923_create_channel_export_requests_table.php new file mode 100644 index 0000000..a3c66f7 --- /dev/null +++ b/database/migrations/2026_10_27_173923_create_channel_export_requests_table.php @@ -0,0 +1,34 @@ +id(); + $table->foreignId('tenant_id')->constrained()->cascadeOnDelete(); + $table->foreignId('channel_id')->constrained()->cascadeOnDelete(); + $table->dateTime('requested_at'); + $table->string('method', 8); + $table->string('user_agent', 512)->nullable(); + $table->unsignedSmallInteger('response_status'); + $table->string('export_state', 20); + $table->index(['channel_id', 'requested_at']); + }); + } + + /** + * Reverse the migrations. + */ + public function down(): void + { + Schema::dropIfExists('channel_export_requests'); + } +}; diff --git a/docs/STATUS.md b/docs/STATUS.md index 3ff5df1..71d9c3a 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“). +**Portalkacheln und Abrufhistorie vorbereitet (27.10.2026):** Responsive Kacheln ersetzen die breite Portaltabelle; Name/Wohnung, Status, Richtungen, letzter Sync-Lauf und letzter Kalenderabruf bleiben sichtbar. Hauptaktion **Exportlink** zeigt die kopierbare vertrauliche Adresse. Weitere Aktionen sind im Zusatzmenü. Pro Kanal werden die letzten 100 verarbeiteten Feedabrufe mit Empfangszeit, GET/HEAD, Antwortstatus, Exportzustand und unbestätigter Clientkennung gespeichert; keine IP-Adresse und keine Exporttoken im Protokoll, Begrenzung ohne Scheduler. Importerfolg, Feedempfang und persönliche Portalübernahme bleiben getrennt. Lokale Gesamtsuite vor letztem Metadatenschutz: **375 Tests / 1797 Assertions grün**; anschließende vollständige Abruf-Testdatei **8 Tests / 44 Assertions grün**, Pint erfolgreich. Neue additive Migration `2026_10_27_173923_create_channel_export_requests_table`; Auslieferungsnachweis folgt nach Pipeline. [Benutzung und Grenzen](architecture/ical-mvp-inbetriebnahme-2026-10-27.md#kachelansicht-und-kalenderabrufe). + **Eigenständige Portalverwaltung bereitgestellt (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 und beide MariaDB-Migrationen wurden durch Pipeline 4662 erfolgreich bereitgestellt (Batch 16). Die eigenständige Oberfläche ist mit **`1f59cbb` durch Pipeline 4663 erfolgreich ausgeliefert**; Server-REVISION, Release und drei Verwaltungsrouten bestätigt. **368 Feature-Tests / 1755 Assertions lokal erfolgreich; Pipeline-Build und Tests erfolgreich; Pint erfolgreich.** `/up` und Anmeldung HTTP 200, Portalverwaltung unangemeldet zur Anmeldung umgeleitet. Bisheriger Exportlink HTTP 200 und bytegleicher Kalender vor/nach Deployment, ungültiger Token 404. Keine Buchung oder Sperre geändert. [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. diff --git a/docs/architecture/ical-kanalkonfiguration.md b/docs/architecture/ical-kanalkonfiguration.md index 906f63c..c88a3c3 100644 --- a/docs/architecture/ical-kanalkonfiguration.md +++ b/docs/architecture/ical-kanalkonfiguration.md @@ -60,7 +60,7 @@ ## 3. Kanal je Wohnung konfigurieren Import-only, Export-only und beide Richtungen sind unabhängig wählbar. Der Kanalstatus „Pausiert“ stoppt beide Richtungen unabhängig von den vorgemerkten Richtungsschaltern. Der iCal-Importschalter steuert nicht den separaten Portal-Mail-Dienst: Bei aktivem Kanal und eingetragenen Absendern kann dieser weiterhin Sperren erzeugen. Zum vollständigen Pausieren den Kanalstatus verwenden. -Importadresse und Token sind keine normalen Listenwerte. Die Exportadresse ist über **„Vertraulicher Exportlink“** bewusst abrufbar und kopierbar. Token, Snapshot und Einstellungen sind bei normaler Modellserialisierung ausgeblendet. Der Export enthält Belegungen mit `SUMMARY:Belegt`, keine Gastnamen, Preise oder internen Sperrgründe. Die Adresse bleibt ein Zugangsschlüssel; Serverzugriffsprotokolle und Empfänger können sie dennoch kennen. +Importadresse und Token sind keine normalen Übersichtswerte. Die Exportadresse ist über **„Exportlink“ an der Portalkachel** bewusst abrufbar und kopierbar. Token, Snapshot und Einstellungen sind bei normaler Modellserialisierung ausgeblendet. Der Export enthält Belegungen mit `SUMMARY:Belegt`, keine Gastnamen, Preise oder internen Sperrgründe. Die Adresse bleibt ein Zugangsschlüssel; Serverzugriffsprotokolle und Empfänger können sie dennoch kennen. ## 4. Exportmodi und Herkunft @@ -151,7 +151,7 @@ ## 9. Überwachung und Abrufzeiten Unser Aufgabenplan sieht `channels:sync` alle fünf Minuten vor. Der erwartete externe Abrufabstand ist dagegen nur eine Vermutung zum Portal und steuert diesen Plan nicht. Ohne eingerichteten Scheduler erfolgt kein regelmäßiger Abgleich. Der bisher dokumentierte Einrichtungsbedarf auf dem Testserver wurde hier nicht verändert. -`last_export_requested_at` zeigt einen beobachteten Abruf dieser Feedadresse. Die Anzeige heißt ausdrücklich **„Letzter Feedabruf (Client unbekannt)“**. Ein eigener Test, Monitor oder weitergegebener Link kann denselben Abruf auslösen. Der Zeitpunkt beweist weder den Portalclient noch eine erfolgreiche Verarbeitung dort. Getrennte bestätigte Portal-Synchronisationszeiten sind nicht implementiert. Auch Prüffälle müssen persönlich bearbeitet werden; ein technisch erfolgreicher Import bedeutet nicht konfliktfreien Bestand. +`last_export_requested_at` zeigt einen beobachteten Abruf dieser Feedadresse, in der Kachel als **„Letzter Abruf“** getrennt vom Sync-Lauf. Die ergänzte **Abrufhistorie** hält je Kanal die letzten 100 verarbeiteten GET-/HEAD-Aufrufe mit Empfangszeit, Antwortstatus, Exportzustand und unbestätigter Clientkennung fest. IP-Adressen und Token werden dort nicht gespeichert. Ein eigener Test, Monitor oder weitergegebener Link kann denselben Abruf auslösen. Der Zeitpunkt beweist weder den Portalclient noch eine erfolgreiche Verarbeitung dort. Getrennte bestätigte Portal-Synchronisationszeiten werden weiterhin nicht automatisch ermittelt; persönliche Sichtkontrollen sind ein eigenes Feld. Auch Prüffälle müssen persönlich bearbeitet werden; ein technisch erfolgreicher Import bedeutet nicht konfliktfreien Bestand. ## 10. Automatisierte Nachweise und reproduzierbarer Testplan diff --git a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md index b50bfa9..72b559b 100644 --- a/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md +++ b/docs/architecture/ical-mvp-inbetriebnahme-2026-10-27.md @@ -10,9 +10,19 @@ ## 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. -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. +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. -**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. +**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. + +## Kachelansicht und Kalenderabrufe + +Die breite Tabelle wird durch responsive Portalkacheln ersetzt: mobil eine Spalte, ab mittlerer Breite zwei und auf sehr breiten Ansichten drei. Sichtbar bleiben Portalname, Wohnung, Status, aktive Richtungen, letzter Sync-Lauf und letzter Kalenderabruf. Fehler und Prüffälle sind an der Kachel erkennbar. **Exportlink** und **Bearbeiten** stehen direkt bereit; Import, Protokoll, Exportumfang, Abrufhistorie und Tokenwechsel befinden sich im Zusatzmenü. + +Unter **Zusatzmenü → Kalenderabrufe** stehen die letzten 100 verarbeiteten Abrufe eines Kanalfeeds: serverseitige Empfangszeit, GET/HEAD, Antwortstatus, aktueller/eingefrorener/nicht verfügbarer Exportstand und die vom Client selbst gemeldete Kennung. Alte Einträge werden pro Kanal beim nächsten Abruf begrenzt; dafür ist kein Scheduler nötig. IP-Adresse, Exportadresse und Token werden nicht im Abrufprotokoll gespeichert. Die Protokolle gehören zum jeweiligen Mandanten und werden in dessen Archiv-/Löschablauf berücksichtigt. + +Der individuelle Feed ordnet den Aufruf einem Kanal zu. **Er identifiziert den tatsächlichen Aufrufer nicht sicher:** Auch Browser, eigene Prüfungen oder Monitore können den Link verwenden. Die Clientkennung ist unbestätigt und wird nicht als Nachweis eines bestimmten Portals ausgewertet. Erfasst wird der Eingang beim Server, nicht der vorherige interne Startzeitpunkt des externen Portals. Die Historie beginnt erst mit dieser Erweiterung; frühere Einzelabrufe lassen sich daraus nicht rekonstruieren. Abgewiesene ungültige Tokens oder bereits vor der Anwendung begrenzte Anfragen gehören nicht zur Kanalhistorie. + +Import-Sync, Kalenderabruf und persönliche Sichtkontrolle im externen Portal bleiben drei getrennte Angaben. Ein aufgezeichneter Abruf setzt weder `last_success_at` des Imports noch die persönliche Portalbestätigung. Ein HTTP-200-Feed beweist keine erfolgreiche Verarbeitung oder sichtbare Übernahme im Portal. Die **Importadresse** ist die vom externen Portal bereitgestellte Kalenderadresse. Sie wird im selben Formular eingetragen; FewoPortal kann sie nicht selbst für ein fremdes Portalkonto erzeugen. Sie darf zunächst fehlen. Ein neuer Kanal startet ohne aktive Richtung und kann schrittweise eingerichtet werden. Für den normalen kanalübergreifenden Betrieb ausdrücklich **regulären Exportmodus** wählen. Der Testmodus ist ein optionales Untersuchungswerkzeug. diff --git a/tests/Feature/ChannelExportRequestTest.php b/tests/Feature/ChannelExportRequestTest.php new file mode 100644 index 0000000..c0b890b --- /dev/null +++ b/tests/Feature/ChannelExportRequestTest.php @@ -0,0 +1,140 @@ +property(); + $channel = Channel::factory()->for($property)->create(); + $this->withHeader('User-Agent', 'Synthetic-Portal/1.0')->get($channel->exportUrl())->assertOk(); + $entry = $channel->exportRequests()->sole(); + $this->assertSame([$property->tenant_id, 'GET', 'Synthetic-Portal/1.0', 200, 'live'], [$entry->tenant_id, $entry->method, $entry->user_agent, $entry->response_status, $entry->export_state]); + $this->assertSame('2026-10-27 12:00:00', $entry->requested_at->format('Y-m-d H:i:s')); + $this->assertSame($entry->requested_at->toDateTimeString(), $channel->fresh()->last_export_requested_at->toDateTimeString()); + $this->assertNull($channel->fresh()->portal_verified_at); + $this->assertNull($channel->fresh()->last_success_at); + $this->assertStringNotContainsString($channel->export_token, $entry->toJson()); + $this->assertArrayNotHasKey('ip_address', $entry->toArray()); + } + + public function test_head_and_paused_export_are_recorded_as_receipts_without_changing_the_frozen_feed(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(); + $body = $this->get($channel->exportUrl())->assertOk()->getContent(); + app(ConfigureChannel::class)->handle($property, ['export_enabled' => false], $channel); + $this->travel(2)->minutes(); + $this->head($channel->exportUrl())->assertOk(); + $entry = $channel->exportRequests()->first(); + $this->assertSame(['HEAD', 'frozen', 200], [$entry->method, $entry->export_state, $entry->response_status]); + $this->assertSame($body, $channel->fresh()->export_snapshot); + $this->assertSame(2, $channel->exportRequests()->count()); + } + + public function test_paused_feed_without_snapshot_records_503_and_invalid_token_is_not_a_channel_request(): void + { + $property = $this->property(); + $channel = app(ConfigureChannel::class)->handle($property, ['name' => 'Unbekanntes Portal', 'connector' => 'ical']); + $this->get($channel->exportUrl())->assertStatus(503); + $this->get('/kalender/not-a-valid-token.ics')->assertNotFound(); + $this->assertSame(1, ChannelExportRequest::count()); + $this->assertSame([503, 'unavailable'], [$channel->exportRequests()->sole()->response_status, $channel->exportRequests()->sole()->export_state]); + } + + public function test_history_is_bounded_independently_for_each_channel_without_a_scheduler(): void + { + $property = $this->property(); + $a = Channel::factory()->for($property)->create(); + $b = Channel::factory()->for($property)->create(); + config(['channels.export_request_history_limit' => 2]); + $this->withHeader('User-Agent', 'First')->get($a->exportUrl())->assertOk(); + $this->withHeader('User-Agent', 'Other')->get($b->exportUrl())->assertOk(); + $this->withHeader('User-Agent', 'Second')->get($a->exportUrl())->assertOk(); + $this->withHeader('User-Agent', 'Third')->get($a->exportUrl())->assertOk(); + $this->assertSame(['Third', 'Second'], $a->exportRequests()->pluck('user_agent')->all()); + $this->assertSame(['Other'], $b->exportRequests()->pluck('user_agent')->all()); + } + + public function test_old_and_new_tokens_during_rotation_share_one_channel_history(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(); + $oldLink = $channel->exportUrl(); + $rotated = app(RotateChannelToken::class)->handle($channel); + $this->get($oldLink)->assertOk(); + $this->get($rotated->exportUrl())->assertOk(); + $this->assertSame(2, $channel->exportRequests()->count()); + $this->assertSame([$channel->id], ChannelExportRequest::pluck('channel_id')->unique()->all()); + } + + public function test_card_shows_sync_status_and_received_request_separately_and_history_requires_explicit_action(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(['last_synced_at' => now()->subMinutes(10), 'last_success_at' => now()->subMinutes(10)]); + $this->withHeader('User-Agent', 'Unverified-Client/9')->get($channel->exportUrl())->assertOk(); + $this->actingAs(User::factory()->create()); + $page = Livewire::test(ListChannels::class)->assertCanSeeTableRecords([$channel])->assertSee('Letzter Sync: 27.10.2026 11:50')->assertSee('Letzter Abruf: 27.10.2026 12:00')->assertDontSee('Unverified-Client/9')->assertDontSee($channel->export_token); + $page->mountAction(TestAction::make('exportRequests')->table($channel))->assertActionMounted(TestAction::make('exportRequests')->table($channel)); + $schema = $page->instance()->getSchema($page->instance()->getMountedActionSchemaName()); + $entries = collect($schema->getFlatComponents())->first(fn ($component): bool => $component instanceof RepeatableEntry); + $this->assertSame('Unverified-Client/9', $entries->getState()[0]['client']); + } + + public function test_request_history_is_not_visible_across_landlords(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(); + $this->get($channel->exportUrl())->assertOk(); + $other = Tenant::factory()->create(); + app(TenantContext::class)->set($other); + $this->assertSame(0, ChannelExportRequest::count()); + $this->assertSame(0, $channel->exportRequests()->count()); + } + + public function test_client_metadata_is_bounded_and_does_not_keep_reflected_export_tokens(): void + { + $property = $this->property(); + $channel = Channel::factory()->for($property)->create(); + $oldToken = $channel->export_token; + $rotated = app(RotateChannelToken::class)->handle($channel); + $agent = 'Synthetic '.$oldToken.' '.$rotated->export_token.' '.str_repeat('x', 600); + + $this->withHeader('User-Agent', $agent)->get($rotated->exportUrl())->assertOk(); + + $recorded = $channel->exportRequests()->sole()->user_agent; + $this->assertSame(512, mb_strlen($recorded)); + $this->assertStringNotContainsString($oldToken, $recorded); + $this->assertStringNotContainsString($rotated->export_token, $recorded); + } + + 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; + } +}