- Buchung ist der einheitliche Vorgang: Eingangsart, Vorgangsart A1–A6, eingefrorenes Abwicklungsprofil, gespeicherter Verlauf (booking_events); Gast, Personen und Beträge dürfen unbekannt sein, Platzhalter-Gäste werden migriert und nicht mehr angelegt - Einstellungen in Ebenen: Vermieterstandard (So arbeite ich), Abweichung der Wohnung (Experte), Abweichung je Portal und Eingangsart; ersetzt booking_model als Steuergröße - Ein Weg für extern verbindliche Buchungen (TakeOverExternalBooking) statt RecordPortalBooking und "Akte anlegen"; Portalpreis als belegte Gesamtposition - Startseite "Zu erledigen", neue Vorgangsseite mit nächstem Schritt, Automatik-Schalter, "Beenden" mit Storno statt Statusumschaltung; Status von Hand nur im Expertenmodus - Migration übernimmt bisheriges Verhalten unverändert (abweichende Wohnungswerte bleiben als Abweichung), Bericht: php artisan process:settings-report Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
103 lines
4.1 KiB
PHP
103 lines
4.1 KiB
PHP
<?php
|
|
|
|
namespace App\Process;
|
|
|
|
use App\Enums\ChannelBookingModel;
|
|
use App\Enums\IntakeKind;
|
|
use App\Enums\ProcessSetting;
|
|
use App\Enums\Responsibility;
|
|
use App\Models\Booking;
|
|
use App\Models\Channel;
|
|
use App\Models\Property;
|
|
use App\Models\Tenant;
|
|
|
|
/**
|
|
* Resolves the effective process settings: built-in default → landlord default (tenant) → deviation of the property
|
|
* (expert area) → deviation of the channel for the intake kind. A value that is not set inherits from the level above;
|
|
* a deliberately set 0, "no" or "manual" is a value of its own.
|
|
*/
|
|
class ProcessSettings
|
|
{
|
|
public function resolve(Property $property, ?Channel $channel, IntakeKind $intake): ProcessProfile
|
|
{
|
|
$propertyLevel = (array) ($property->process_overrides ?? []);
|
|
if ($property->contract_template_id !== null) {
|
|
$propertyLevel[ProcessSetting::ContractTemplate->value] = $property->contract_template_id;
|
|
}
|
|
|
|
$levels = [
|
|
ProcessProfile::TENANT => $this->tenantDefaults($property->tenant_id),
|
|
ProcessProfile::PROPERTY => $propertyLevel,
|
|
ProcessProfile::CHANNEL => $intake === IntakeKind::Internal || $channel === null ? [] : (array) (($channel->process_overrides ?? [])[$intake->value] ?? []),
|
|
];
|
|
|
|
$values = [];
|
|
$sources = [];
|
|
foreach (ProcessSetting::cases() as $setting) {
|
|
$values[$setting->value] = $setting->default();
|
|
$sources[$setting->value] = ProcessProfile::SYSTEM;
|
|
|
|
foreach ($levels as $level => $settings) {
|
|
if ($level === ProcessProfile::CHANNEL && ! in_array($intake, $setting->channelIntakes(), true)) {
|
|
continue;
|
|
}
|
|
$value = $setting->normalize($settings[$setting->value] ?? null);
|
|
if ($value !== null) {
|
|
$values[$setting->value] = $value;
|
|
$sources[$setting->value] = $level;
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($intake !== IntakeKind::Booking) {
|
|
// A request is answered with our own offer and an internal case is ours anyway: the documents are ours.
|
|
$values[ProcessSetting::Documents->value] = Responsibility::Landlord->value;
|
|
$sources[ProcessSetting::Documents->value] = ProcessProfile::SYSTEM;
|
|
}
|
|
|
|
$documents = Responsibility::from((string) $values[ProcessSetting::Documents->value]);
|
|
$payments = Responsibility::from((string) $values[ProcessSetting::Payments->value]);
|
|
|
|
return new ProcessProfile($intake, ProcessProfile::caseTypeFor($intake, $channel !== null, $documents, $payments), $values, $sources);
|
|
}
|
|
|
|
/**
|
|
* The settings that would apply to a case right now (its frozen profile is what counts for the case itself).
|
|
*/
|
|
public function forBooking(Booking $booking): ProcessProfile
|
|
{
|
|
// The case's own landlord counts, whichever landlord is current (e.g. a case written by the system).
|
|
$property = $booking->property ?? Property::withoutGlobalScope('tenant')->findOrFail($booking->property_id);
|
|
|
|
return $this->resolve($property, $booking->processChannel(), $booking->intake ?? self::intakeFor($booking));
|
|
}
|
|
|
|
/**
|
|
* Landlord defaults as stored on the tenant (not set: empty).
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function tenantDefaults(?int $tenantId): array
|
|
{
|
|
if ($tenantId === null) {
|
|
return [];
|
|
}
|
|
|
|
return (array) (Tenant::query()->find($tenantId)?->process_defaults ?? []);
|
|
}
|
|
|
|
/**
|
|
* Intake kind of a case that does not name one: a case from a channel that only passes on requests is a request,
|
|
* from other channels a booking that is already binding; everything else (website, phone, e-mail) a request.
|
|
*/
|
|
public static function intakeFor(Booking $booking): IntakeKind
|
|
{
|
|
$channel = $booking->processChannel();
|
|
if ($channel === null) {
|
|
return IntakeKind::Inquiry;
|
|
}
|
|
|
|
return $channel->booking_model === ChannelBookingModel::Inquiry ? IntakeKind::Inquiry : IntakeKind::Booking;
|
|
}
|
|
}
|