Vorgangskern und geführte Vorgangsbearbeitung (Pakete 1 und 2, Prozessarchitektur v0.10)
- 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>
This commit is contained in:
1 parent
9005c12164
commit
3a728c3255
78 files changed
+4296
-1180
No files matched your search
@@ -0,0 +1,163 @@
|
||||
<?php
|
||||
|
||||
namespace App\Process;
|
||||
|
||||
use App\Enums\CaseType;
|
||||
use App\Enums\IntakeKind;
|
||||
use App\Enums\ProcessingMode;
|
||||
use App\Enums\ProcessSetting;
|
||||
use App\Enums\Responsibility;
|
||||
|
||||
/**
|
||||
* The rules that apply to one case: its intake kind, case type and the effective value of every process setting
|
||||
* together with the level it came from. Frozen on the case when it comes in, so later changes of the settings only
|
||||
* affect new cases.
|
||||
*/
|
||||
final class ProcessProfile
|
||||
{
|
||||
public const SYSTEM = 'system';
|
||||
|
||||
public const TENANT = 'tenant';
|
||||
|
||||
public const PROPERTY = 'property';
|
||||
|
||||
public const CHANNEL = 'channel';
|
||||
|
||||
/** Settings resolved when they are used instead of being frozen (documents capture their own template). */
|
||||
public const LIVE = [ProcessSetting::ContractTemplate];
|
||||
|
||||
/**
|
||||
* @param array<string, string|int|bool|null> $values setting key => effective value
|
||||
* @param array<string, string> $sources setting key => level the value came from
|
||||
*/
|
||||
public function __construct(
|
||||
public readonly IntakeKind $intake,
|
||||
public readonly CaseType $caseType,
|
||||
public readonly array $values,
|
||||
public readonly array $sources,
|
||||
public readonly ?string $frozenAt = null,
|
||||
public readonly string $origin = 'intake',
|
||||
) {}
|
||||
|
||||
/**
|
||||
* The case type of a constellation: internal occasions are A6; requests are A1 (own way) or A2 (intermediary);
|
||||
* binding external bookings are A3–A5 by who handles documents and payments.
|
||||
*/
|
||||
public static function caseTypeFor(IntakeKind $intake, bool $viaChannel, Responsibility $documents, Responsibility $payments): CaseType
|
||||
{
|
||||
return match ($intake) {
|
||||
IntakeKind::Internal => CaseType::A6,
|
||||
IntakeKind::Inquiry => $viaChannel ? CaseType::A2 : CaseType::A1,
|
||||
IntakeKind::Booking => match (true) {
|
||||
$documents === Responsibility::Portal => CaseType::A5,
|
||||
$payments === Responsibility::Portal => CaseType::A4,
|
||||
default => CaseType::A3,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
public function value(ProcessSetting $setting): string|int|bool|null
|
||||
{
|
||||
return array_key_exists($setting->value, $this->values) ? $this->values[$setting->value] : $setting->default();
|
||||
}
|
||||
|
||||
public function source(ProcessSetting $setting): string
|
||||
{
|
||||
return $this->sources[$setting->value] ?? self::SYSTEM;
|
||||
}
|
||||
|
||||
public function processing(): ProcessingMode
|
||||
{
|
||||
return ProcessingMode::tryFrom((string) $this->value(ProcessSetting::Processing)) ?? ProcessingMode::Manual;
|
||||
}
|
||||
|
||||
public function preReservation(): bool
|
||||
{
|
||||
return (bool) $this->value(ProcessSetting::PreReservation);
|
||||
}
|
||||
|
||||
public function holdHours(): int
|
||||
{
|
||||
return max(1, (int) $this->value(ProcessSetting::HoldHours));
|
||||
}
|
||||
|
||||
public function documents(): Responsibility
|
||||
{
|
||||
return Responsibility::tryFrom((string) $this->value(ProcessSetting::Documents)) ?? Responsibility::Landlord;
|
||||
}
|
||||
|
||||
public function payments(): Responsibility
|
||||
{
|
||||
return Responsibility::tryFrom((string) $this->value(ProcessSetting::Payments)) ?? Responsibility::Landlord;
|
||||
}
|
||||
|
||||
public function guestMessages(): Responsibility
|
||||
{
|
||||
return Responsibility::tryFrom((string) $this->value(ProcessSetting::GuestMessages)) ?? Responsibility::Landlord;
|
||||
}
|
||||
|
||||
public function arrivalInfoDaysBefore(): int
|
||||
{
|
||||
return max(1, (int) $this->value(ProcessSetting::ArrivalInfoDaysBefore));
|
||||
}
|
||||
|
||||
public function contractTemplateId(): ?int
|
||||
{
|
||||
$value = $this->value(ProcessSetting::ContractTemplate);
|
||||
|
||||
return $value === null ? null : (int) $value;
|
||||
}
|
||||
|
||||
/**
|
||||
* Plain words for a level, for the "where does this come from" hint.
|
||||
*/
|
||||
public static function sourceLabel(string $source): string
|
||||
{
|
||||
return match ($source) {
|
||||
self::TENANT => 'Ihre Standardeinstellung',
|
||||
self::PROPERTY => 'Abweichung der Wohnung',
|
||||
self::CHANNEL => 'Abweichung des Portals',
|
||||
'migration' => 'aus dem bisherigen Stand übernommen',
|
||||
default => 'Grundeinstellung',
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* The profile as it is frozen on the case (settings resolved live are left out).
|
||||
*
|
||||
* @return array{intake: string, case_type: string, values: array<string, string|int|bool|null>, sources: array<string, string>, frozen_at: string, origin: string}
|
||||
*/
|
||||
public function toArray(): array
|
||||
{
|
||||
$live = array_flip(array_map(fn (ProcessSetting $setting): string => $setting->value, self::LIVE));
|
||||
|
||||
return [
|
||||
'intake' => $this->intake->value,
|
||||
'case_type' => $this->caseType->value,
|
||||
'values' => array_diff_key($this->values, $live),
|
||||
'sources' => array_diff_key($this->sources, $live),
|
||||
'frozen_at' => $this->frozenAt ?? now()->toIso8601String(),
|
||||
'origin' => $this->origin,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* @param array<string, mixed> $data
|
||||
*/
|
||||
public static function fromArray(array $data): self
|
||||
{
|
||||
return new self(
|
||||
IntakeKind::tryFrom((string) ($data['intake'] ?? '')) ?? IntakeKind::Inquiry,
|
||||
CaseType::tryFrom((string) ($data['case_type'] ?? '')) ?? CaseType::A1,
|
||||
(array) ($data['values'] ?? []),
|
||||
(array) ($data['sources'] ?? []),
|
||||
isset($data['frozen_at']) ? (string) $data['frozen_at'] : null,
|
||||
(string) ($data['origin'] ?? 'intake'),
|
||||
);
|
||||
}
|
||||
|
||||
public function withOrigin(string $origin): self
|
||||
{
|
||||
return new self($this->intake, $this->caseType, $this->values, $this->sources, $this->frozenAt, $origin);
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user