- Connector-System (app/Channels, config/channels.php) mit iCal-Connector, robustem Parser und Export-Feed je Portal (ohne eigene Belegungen, ohne Gästedaten) - Abgleich alle 5 Min. mit Protokoll, Echo-Erkennung, Konflikt-Mail bei möglicher Doppelbuchung - Überwachung: Störungs-Mail, Status-Endpunkt /health/sync für n8n - Portal-Aufgaben für Sofortbuchungsportale (FeWo-direkt): automatisch aus Buchungen/Sperren/anderen Portalen, Mail + Erinnerung, Abhaken im Admin - Optionaler signierter Automatisierungs-Webhook mit Rückmeldung - Herkunftsmessung: Abfrage im Formular + UTM-Parameter - Portal-Analyse: AGB-Prüfung Automatisierung, Umsetzungsbeschreibung Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
43 lines
1.0 KiB
PHP
43 lines
1.0 KiB
PHP
<?php
|
|
|
|
namespace App\Channels\Contracts;
|
|
|
|
use App\Channels\ChannelSyncException;
|
|
use App\Channels\ExternalPeriod;
|
|
use App\Models\Channel;
|
|
use Filament\Schemas\Components\Component;
|
|
|
|
/**
|
|
* Connects one kind of portal or channel manager. Register implementations in config/channels.php.
|
|
*/
|
|
interface ChannelConnector
|
|
{
|
|
/**
|
|
* Stable identifier stored on the channel, e.g. "ical".
|
|
*/
|
|
public static function key(): string;
|
|
|
|
public static function label(): string;
|
|
|
|
/**
|
|
* Admin form fields for the connector's settings; use state paths below "settings.".
|
|
*
|
|
* @return list<Component>
|
|
*/
|
|
public static function settingsSchema(): array;
|
|
|
|
/**
|
|
* Whether occupations can currently be imported (e.g. an import URL is configured).
|
|
*/
|
|
public function canImport(Channel $channel): bool;
|
|
|
|
/**
|
|
* All occupations the portal currently reports.
|
|
*
|
|
* @return list<ExternalPeriod>
|
|
*
|
|
* @throws ChannelSyncException
|
|
*/
|
|
public function fetchOccupations(Channel $channel): array;
|
|
}
|