Files
fewo-stommer/app/Process/PortalConfirmation.php
LarsandClaude Sonnet 5.5 8442d0a3d8 V2.1: Kanalfähigkeiten, Ausführungsvarianten, Dokumentenentkopplung, Portalbestätigung
Modellwahl über Kanalfähigkeiten mit erklärten Einschränkungen, Abgleich alter Werte,
Ausführungsvarianten je Modul, getrennte Vertrags-/Buchungsinformation, Warten auf
die Portalbestätigung mit Eskalation und Wiederaufnahme (Fälle C und D getestet).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-05 07:54:11 +01:00

69 lines
3.1 KiB
PHP
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
namespace App\Process;
use App\Enums\PortalEmailType;
use App\Models\Booking;
use App\Models\PortalEmail;
use Carbon\CarbonImmutable;
/**
* The evidence that a portal confirmed a binding booking (docs/Prozessarchitektur/V2.1/02 §5): a booking mail of the portal
* that is assigned to the case deterministically – by the portal's booking reference or by the calendar entry that belongs
* to the case, both of the same channel (CH-13) – or the landlord's explicit confirmation in the case. The evidence level is
* „laut Portal“ (mail) or „nachgewiesen durch den Vermieter“; it never creates or changes a binding, the booking was
* binding from the start (E-036). Pure reading; `confirm` records the landlord's confirmation.
*/
final class PortalConfirmation
{
public const EVENT = 'portal_confirmation';
/**
* @return array{source: 'mail'|'landlord', at: CarbonImmutable, label: string}|null
*/
public static function evidence(Booking $booking): ?array
{
$landlord = $booking->events()->where('type', self::EVENT)->orderBy('occurred_at')->first();
if ($landlord !== null) {
return ['source' => 'landlord', 'at' => CarbonImmutable::parse($landlord->occurred_at), 'label' => 'vom Vermieter bestätigt ('.$landlord->actor.')'];
}
$channelId = $booking->processChannel()?->id;
if ($channelId === null) {
return null;
}
$mail = PortalEmail::query()->where('channel_id', $channelId)->where('type', PortalEmailType::Booking)
->where(fn ($query) => $query
->when(filled($booking->portal_reference), fn ($by) => $by->orWhere('reference', $booking->portal_reference))
->orWhereHas('blockedPeriod', fn ($block) => $block->withTrashed()->where('linked_booking_id', $booking->id)))
->orderBy('received_at')->first();
return $mail === null ? null : ['source' => 'mail', 'at' => CarbonImmutable::parse($mail->received_at), 'label' => 'Bestätigungsmail des Portals vom '.CarbonImmutable::parse($mail->received_at)->format('d.m.Y, H:i').' Uhr (laut Portal)'];
}
/**
* Until when the confirmation is awaited (counted from the case's arrival in the system).
*/
public static function deadline(Booking $booking): CarbonImmutable
{
return CarbonImmutable::parse($booking->created_at)->addHours($booking->process()->portalConfirmationWaitHours());
}
public static function isOverdue(Booking $booking): bool
{
return self::deadline($booking)->isPast();
}
/**
* The landlord states that the portal confirmed (e.g. checked in the portal's own interface). Recorded once.
*/
public static function confirm(Booking $booking, string $by, ?string $note = null): void
{
if ($booking->events()->where('type', self::EVENT)->exists()) {
return;
}
CaseLog::record($booking, self::EVENT, 'Bestätigung des Portals vom Vermieter festgehalten', reason: $note, data: ['module' => 'portal.confirmation', 'level' => 'confirmed_by_landlord'], actor: $by);
}
}