Portale als Kacheln zeigen und Kalenderabrufe je Kanal protokollieren
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m41s

This commit is contained in:
Lars committed 2026-10-27 17:48:17 +01:00
1 parent 98eabaeb0c
commit 511faa64d2
12 files changed
+337 -98

No files matched your search

+18 -3
View File
@@ -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;
});
@@ -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),
]);
}
}
+2 -2
View File
@@ -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']);
}
+6
View File
@@ -106,6 +106,12 @@ public function syncLogs(): HasMany
return $this->hasMany(ChannelSyncLog::class)->latest('id');
}
/** @return HasMany<ChannelExportRequest, $this> */
public function exportRequests(): HasMany
{
return $this->hasMany(ChannelExportRequest::class)->latest('requested_at')->latest('id');
}
/**
* @return HasMany<ChannelTask, $this>
*/
+28
View File
@@ -0,0 +1,28 @@
<?php
namespace App\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
#[Fillable(['channel_id', 'requested_at', 'method', 'user_agent', 'response_status', 'export_state'])]
class ChannelExportRequest extends Model
{
use BelongsToTenant;
public $timestamps = false;
/** @return array<string, string> */
protected function casts(): array
{
return ['requested_at' => 'immutable_datetime', 'response_status' => 'integer'];
}
/** @return BelongsTo<Channel, $this> */
public function channel(): BelongsTo
{
return $this->belongsTo(Channel::class);
}
}
+1
View File
@@ -31,6 +31,7 @@ class TenantArchive
private const DELETE_ORDER = [
'floor_plans',
'channel_sync_logs',
'channel_export_requests',
'channel_tasks',
'portal_emails',
'payments',
+1
View File
@@ -27,5 +27,6 @@
'removal_confirmation_runs' => 2,
'max_automatic_removals' => 5,
'export_request_history_limit' => 100,
];
@@ -0,0 +1,34 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::create('channel_export_requests', function (Blueprint $table) {
$table->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');
}
};
+2
View File
@@ -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.
+2 -2
View File
@@ -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
@@ -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.
+140
View File
@@ -0,0 +1,140 @@
<?php
namespace Tests\Feature;
use App\Actions\ConfigureChannel;
use App\Actions\RotateChannelToken;
use App\Filament\Resources\Channels\Pages\ListChannels;
use App\Models\Channel;
use App\Models\ChannelExportRequest;
use App\Models\Property;
use App\Models\Tenant;
use App\Models\User;
use App\Tenancy\TenantContext;
use Carbon\CarbonImmutable;
use Database\Seeders\PropertySeeder;
use Filament\Actions\Testing\TestAction;
use Filament\Infolists\Components\RepeatableEntry;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Livewire\Livewire;
use Tests\TestCase;
class ChannelExportRequestTest extends TestCase
{
use RefreshDatabase;
public function test_feed_receipt_is_tracked_per_channel_without_claiming_portal_processing(): void
{
$property = $this->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;
}
}