- IMAP-Abruf jede Minute (webklex/php-imap, ohne PHP-imap-Erweiterung) oder signierter Push von n8n - Parser für Buchungs-, Storno- und Anfrage-Mails (de/en), Buchungsnummer, An-/Abreise - Erkannte Buchungen werden sofort gesperrt und an handgepflegte Portale weitergegeben; Kalender-Abgleich übernimmt bzw. ersetzt Mail-Sperren - Unklare Mails: Prüf-Mail + Admin-Liste Portal-E-Mails mit Aktion Sperre anlegen - Überwachung des Postfachs in Monitor und /health/sync Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
166 lines
6.2 KiB
PHP
166 lines
6.2 KiB
PHP
<?php
|
||
|
||
namespace App\Actions;
|
||
|
||
use App\Channels\ConflictDetector;
|
||
use App\Channels\Mail\ParsedPortalMail;
|
||
use App\Channels\Mail\PortalMail;
|
||
use App\Channels\Mail\PortalMailParser;
|
||
use App\Enums\PortalEmailStatus;
|
||
use App\Enums\PortalEmailType;
|
||
use App\Mail\ChannelConflict;
|
||
use App\Mail\PortalMailNotification;
|
||
use App\Models\BlockedPeriod;
|
||
use App\Models\Channel;
|
||
use App\Models\PortalEmail;
|
||
use Illuminate\Support\Facades\DB;
|
||
use Illuminate\Support\Facades\Mail;
|
||
|
||
/**
|
||
* Fast path for portal bookings: the notification e-mail usually arrives within a minute, long before
|
||
* the portal's calendar export is read. A recognised booking is blocked immediately; the later calendar
|
||
* sync confirms the block. Anything not recognised with confidence is flagged for review – never guessed.
|
||
*/
|
||
class ProcessPortalMail
|
||
{
|
||
public function __construct(
|
||
private PortalMailParser $parser,
|
||
private ConflictDetector $conflictDetector,
|
||
) {}
|
||
|
||
public function handle(PortalMail $mail): ?PortalEmail
|
||
{
|
||
if (PortalEmail::where('message_id', $mail->messageId)->exists()) {
|
||
return null;
|
||
}
|
||
|
||
$channel = $this->channelFor($mail->from);
|
||
if ($channel === null) {
|
||
return null;
|
||
}
|
||
|
||
$parsed = $this->parser->parse($mail->subject, $mail->text);
|
||
$conflicts = [];
|
||
|
||
$record = DB::transaction(function () use ($mail, $channel, $parsed, &$conflicts): PortalEmail {
|
||
[$status, $block, $note] = match ($parsed->type) {
|
||
PortalEmailType::Booking => $this->block($channel, $parsed, $conflicts),
|
||
PortalEmailType::Cancellation => $this->release($channel, $parsed),
|
||
PortalEmailType::Inquiry => [PortalEmailStatus::Ignored, null, 'Anfrage – keine Sperre nötig.'],
|
||
PortalEmailType::Unknown => [PortalEmailStatus::NeedsReview, null, 'Inhalt nicht erkannt.'],
|
||
};
|
||
|
||
return PortalEmail::create([
|
||
'channel_id' => $channel->id,
|
||
'message_id' => $mail->messageId,
|
||
'from' => mb_substr($mail->from, 0, 255),
|
||
'subject' => mb_substr($mail->subject, 0, 255),
|
||
'received_at' => $mail->receivedAt,
|
||
'type' => $parsed->type,
|
||
'status' => $status,
|
||
'starts_on' => $parsed->startsOn?->toDateString(),
|
||
'ends_on' => $parsed->endsOn?->toDateString(),
|
||
'reference' => $parsed->reference,
|
||
'blocked_period_id' => $block?->id,
|
||
'excerpt' => mb_substr(trim(preg_replace('/\s+/u', ' ', strip_tags($mail->text))), 0, 500),
|
||
'note' => $note,
|
||
]);
|
||
});
|
||
|
||
if (in_array($record->status, [PortalEmailStatus::Blocked, PortalEmailStatus::Released, PortalEmailStatus::NeedsReview], true)) {
|
||
rescue(fn () => Mail::to(config('fewo.notification_email'))->send(new PortalMailNotification($record)));
|
||
}
|
||
|
||
if ($conflicts !== []) {
|
||
rescue(fn () => Mail::to(config('fewo.notification_email'))->send(new ChannelConflict($channel, $conflicts)));
|
||
}
|
||
|
||
return $record;
|
||
}
|
||
|
||
/**
|
||
* Channels list the sender addresses or domains of their notification e-mails in settings.email_senders.
|
||
*/
|
||
public function channelFor(string $from): ?Channel
|
||
{
|
||
$from = mb_strtolower($from);
|
||
|
||
return Channel::query()->active()->get()->first(function (Channel $channel) use ($from): bool {
|
||
foreach ($this->senders($channel) as $sender) {
|
||
if (str_contains($from, $sender)) {
|
||
return true;
|
||
}
|
||
}
|
||
|
||
return false;
|
||
});
|
||
}
|
||
|
||
/**
|
||
* @return list<string>
|
||
*/
|
||
public function senders(Channel $channel): array
|
||
{
|
||
return array_values(array_filter(array_map(
|
||
fn (string $sender): string => mb_strtolower(trim($sender)),
|
||
explode(',', (string) $channel->setting('email_senders')),
|
||
)));
|
||
}
|
||
|
||
/**
|
||
* @param list<string> $conflicts
|
||
* @return array{PortalEmailStatus, ?BlockedPeriod, ?string}
|
||
*/
|
||
private function block(Channel $channel, ParsedPortalMail $parsed, array &$conflicts): array
|
||
{
|
||
if (! $parsed->hasPeriod()) {
|
||
return [PortalEmailStatus::NeedsReview, null, 'Buchung erkannt, aber An-/Abreise nicht sicher lesbar.'];
|
||
}
|
||
|
||
$known = $channel->blockedPeriods()
|
||
->whereDate('starts_on', $parsed->startsOn)
|
||
->whereDate('ends_on', $parsed->endsOn)
|
||
->first();
|
||
if ($known) {
|
||
return [PortalEmailStatus::AlreadyKnown, $known, null];
|
||
}
|
||
|
||
$block = $channel->blockedPeriods()->create([
|
||
'property_id' => $channel->property_id,
|
||
'starts_on' => $parsed->startsOn->toDateString(),
|
||
'ends_on' => $parsed->endsOn->toDateString(),
|
||
'reason' => "{$channel->name} (E-Mail)".($parsed->reference ? ": {$parsed->reference}" : ''),
|
||
'source' => 'email',
|
||
'external_uid' => 'email:'.($parsed->reference ?? $parsed->startsOn->format('Ymd').'-'.$parsed->endsOn->format('Ymd')),
|
||
]);
|
||
|
||
$conflicts = $this->conflictDetector->conflictsFor($block);
|
||
|
||
return [PortalEmailStatus::Blocked, $block, null];
|
||
}
|
||
|
||
/**
|
||
* Only blocks created from e-mails are released here; calendar blocks disappear with the next sync.
|
||
*
|
||
* @return array{PortalEmailStatus, ?BlockedPeriod, ?string}
|
||
*/
|
||
private function release(Channel $channel, ParsedPortalMail $parsed): array
|
||
{
|
||
$emailBlocks = $channel->blockedPeriods()->where('source', 'email');
|
||
|
||
$block = match (true) {
|
||
$parsed->reference !== null => (clone $emailBlocks)->where('external_uid', 'email:'.$parsed->reference)->first(),
|
||
$parsed->hasPeriod() => (clone $emailBlocks)->whereDate('starts_on', $parsed->startsOn)->whereDate('ends_on', $parsed->endsOn)->first(),
|
||
default => null,
|
||
};
|
||
|
||
if ($block) {
|
||
$block->delete();
|
||
|
||
return [PortalEmailStatus::Released, null, 'Sperre aus E-Mail aufgehoben.'];
|
||
}
|
||
|
||
return [PortalEmailStatus::NeedsReview, null, 'Stornierung erkannt – bitte prüfen; Kalender-Sperren verschwinden mit dem nächsten Abgleich.'];
|
||
}
|
||
}
|