114 lines
6.5 KiB
PHP
114 lines
6.5 KiB
PHP
<?php
|
||
|
||
namespace App\Channels\Events;
|
||
|
||
use App\Actions\RecordPortalAmounts;
|
||
use App\Channels\Intake\IntakeDecision;
|
||
use App\Channels\Intake\PortalIntake;
|
||
use App\Enums\IntakeOutcome;
|
||
use App\Models\BlockedPeriod;
|
||
use App\Models\Booking;
|
||
use App\Models\IntakeObservation;
|
||
use App\Process\CaseLog;
|
||
use App\Support\Money;
|
||
use App\Tenancy\TenantContext;
|
||
use InvalidArgumentException;
|
||
|
||
/**
|
||
* The one entry of channel events (docs/Prozessarchitektur/Architektur/02 §8.3–8.4): maps each normalised event onto
|
||
* the existing intake, so iCal, mail and future APIs are judged by the same rules – duplicates and certainty in
|
||
* PortalIntake, amounts in RecordPortalAmounts, reports about known cases as tasks. Contains no decision rules of its
|
||
* own and never changes a binding booking (stage M4 needs the landlord's action).
|
||
*/
|
||
final class ChannelEventHandler
|
||
{
|
||
public function __construct(private PortalIntake $intake, private RecordPortalAmounts $amounts) {}
|
||
|
||
public function handle(ChannelEvent $event): ?IntakeDecision
|
||
{
|
||
$channel = $event->provenance->channel;
|
||
if (! $channel->isPortal() || $channel->tenant_id === null) {
|
||
throw new InvalidArgumentException('Kanalereignisse kommen nur von Portalen.');
|
||
}
|
||
|
||
return app(TenantContext::class)->run($channel->tenant, fn (): ?IntakeDecision => match (true) {
|
||
$event instanceof IncomingBooking => $this->booking($event),
|
||
$event instanceof BookingCancelledByChannel => $this->report($event, IntakeOutcome::CancellationSignal, $channel->name.' meldet über die Schnittstelle eine Stornierung'.($event->note ? ' ('.$event->note.')' : '').'. Bitte prüfen Sie die Buchung und die nächsten Schritte.'),
|
||
$event instanceof BookingChangedByChannel => $this->report($event, IntakeOutcome::ChangeSignal, $channel->name.' meldet über die Schnittstelle eine Änderung'.($event->arrival && $event->departure ? ': '.$event->arrival->format('d.m.').'–'.$event->departure->format('d.m.Y') : '').($event->guests ? ', '.$event->guests.' Personen' : '').'. Die Buchung bleibt unverändert, bis Sie entscheiden.'),
|
||
$event instanceof PaymentReported => $this->payment($event),
|
||
$event instanceof PayoutReported => $this->payout($event),
|
||
default => throw new InvalidArgumentException('Unbekanntes Kanalereignis '.$event::class.'.'),
|
||
});
|
||
}
|
||
|
||
/**
|
||
* A booking binding at the portal: blocked like a booking e-mail – source api, reference in the identifier – and judged
|
||
* by PortalIntake – the same case, never a second one; a case only when certain.
|
||
*/
|
||
private function booking(IncomingBooking $event): IntakeDecision
|
||
{
|
||
$provenance = $event->provenance;
|
||
$reference = $provenance->externalReference;
|
||
// The reference is the identity of the block (as for booking mails); without one it is never taken as a reference.
|
||
$uid = $reference !== null ? 'api:'.$reference : 'api-event:'.$provenance->evidenceRef;
|
||
$block = $provenance->channel->blockedPeriods()->withTrashed()->where('source', 'api')->where('external_uid', $uid)->first()
|
||
?? new BlockedPeriod(['property_id' => $provenance->channel->property_id, 'source' => 'api', 'reason' => $provenance->channel->name, 'external_uid' => $uid]);
|
||
$block->fill(['starts_on' => $event->arrival->toDateString(), 'ends_on' => $event->departure->toDateString()]);
|
||
if ($block->trashed()) {
|
||
$block->restore();
|
||
}
|
||
$provenance->channel->blockedPeriods()->save($block);
|
||
|
||
return $this->intake->process($block->fresh(), IntakeObservation::SOURCE_API);
|
||
}
|
||
|
||
private function report(BookingCancelledByChannel|BookingChangedByChannel $event, IntakeOutcome $outcome, string $message): ?IntakeDecision
|
||
{
|
||
$case = $this->case($event);
|
||
if ($case === null) {
|
||
return new IntakeDecision(IntakeOutcome::Clarify, ['Keinem gebuchten Vorgang sicher zuzuordnen.'], reference: $event->provenance->externalReference);
|
||
}
|
||
$this->intake->reportToCase($event->provenance->channel, $case, $outcome, $message, 'api:'.$event->provenance->evidenceRef, IntakeObservation::SOURCE_API);
|
||
|
||
return new IntakeDecision($outcome, [$message], $case, reference: $event->provenance->externalReference);
|
||
}
|
||
|
||
private function payment(PaymentReported $event): ?IntakeDecision
|
||
{
|
||
$case = $this->case($event);
|
||
if ($case === null) {
|
||
return new IntakeDecision(IntakeOutcome::Clarify, ['Zahlungsmeldung keinem gebuchten Vorgang sicher zuzuordnen.'], reference: $event->provenance->externalReference);
|
||
}
|
||
$this->amounts->handle($case, null, [], [['amount' => $event->amount, 'paid_on' => $event->paidOn->toDateString()]], $event->provenance->channel->name);
|
||
|
||
return new IntakeDecision(IntakeOutcome::Link, ['Zahlung des Gastes laut Portal erfasst (kein Eingang auf unserem Konto).'], $case);
|
||
}
|
||
|
||
private function payout(PayoutReported $event): ?IntakeDecision
|
||
{
|
||
$case = $this->case($event);
|
||
if ($case === null) {
|
||
return new IntakeDecision(IntakeOutcome::Clarify, ['Auszahlungsmeldung keinem gebuchten Vorgang sicher zuzuordnen.'], reference: $event->provenance->externalReference);
|
||
}
|
||
if ($event->executed) {
|
||
// Evidence level "laut Portal erledigt" – the receipt on our account is recorded by the landlord (O5).
|
||
CaseLog::record($case, 'evidence', 'Auszahlung laut '.$event->provenance->channel->name.' ausgeführt: '.Money::format($event->amount).' am '.$event->paidOn->format('d.m.Y').' – Eingang auf unserem Konto noch nicht erfasst.', data: ['module' => 'portal.payout', 'level' => 'stated_by_portal', 'source' => $event->provenance->transport, 'ref' => $event->provenance->evidenceRef], actor: $event->provenance->channel->name);
|
||
} else {
|
||
$this->amounts->handle($case, null, [['kind' => 'payout_announced', 'amount' => $event->amount, 'due_on' => $event->paidOn->toDateString()]], [], $event->provenance->channel->name);
|
||
}
|
||
|
||
return new IntakeDecision(IntakeOutcome::Link, ['Auszahlung laut Portal vermerkt.'], $case);
|
||
}
|
||
|
||
/**
|
||
* The binding case of the event: by the portal's booking reference only (no merging by dates for reports).
|
||
*/
|
||
private function case(ChannelEvent $event): ?Booking
|
||
{
|
||
$reference = $event->provenance->externalReference;
|
||
$case = $reference === null ? null : $this->intake->caseByReference($event->provenance->channel, $reference);
|
||
|
||
return $case !== null && $case->isBinding() ? $case : null;
|
||
}
|
||
}
|