CaseActivities/CaseAutomation sind Fassaden über ProcessRunner. Verhaltensvergleich v0.11: 11 Abläufe und 198 Konstellationen gleich, beabsichtigte Abweichungen I-004/I-005 (F-001/F-002). Volle Suite vor U-B: 785/785. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
117 lines
4.8 KiB
PHP
117 lines
4.8 KiB
PHP
<?php
|
||
|
||
namespace App\Process\Modules\Settlement;
|
||
|
||
use App\Actions\SendBookingDocuments;
|
||
use App\Enums\ActivityState;
|
||
use App\Enums\ProcessingMode;
|
||
use App\Enums\ProcessSetting;
|
||
use App\Enums\Responsibility;
|
||
use App\Process\Activity;
|
||
use App\Process\CaseAutomation;
|
||
use App\Process\CaseContext;
|
||
use App\Process\Modules\Dependency;
|
||
use App\Process\Modules\Module;
|
||
use App\Process\Modules\ModuleDefinition;
|
||
use App\Process\Modules\RunsAutomatically;
|
||
use App\Process\StepResult;
|
||
|
||
/**
|
||
* P03: the binding contract documentation for the guest (booking confirmation with contract, or the documents of a
|
||
* portal booking). Who is responsible for it decides the case type (decision O1): ours in A1–A4, the portal's in A5 –
|
||
* then the step is shown as external.
|
||
*/
|
||
final class BookingDocuments extends Module implements RunsAutomatically
|
||
{
|
||
public static function key(): string
|
||
{
|
||
return 'documents.send';
|
||
}
|
||
|
||
public static function definition(): ModuleDefinition
|
||
{
|
||
return new ModuleDefinition(
|
||
label: 'Buchungsunterlagen (Vertragsdokumentation)',
|
||
purpose: 'Sendet dem Gast die verbindliche Buchungsbestätigung mit Vertrag bzw. die Unterlagen der Portalbuchung.',
|
||
phase: 'P03',
|
||
requires: [Dependency::hard('guest.details')],
|
||
effects: ['case_write', 'guest_mail', 'document'],
|
||
waits: ['landlord', 'portal'],
|
||
triggers: ['automation', 'booking.taken_over'],
|
||
parameters: [ProcessSetting::Documents, ProcessSetting::Processing, ProcessSetting::ContractTemplate],
|
||
performers: ['system', 'landlord', 'portal'],
|
||
modes: ['automatic', 'manual'],
|
||
events: ['document', 'mail'],
|
||
readsContractData: true,
|
||
);
|
||
}
|
||
|
||
public function applies(CaseContext $case): bool
|
||
{
|
||
return ! $case->booking->isInternal();
|
||
}
|
||
|
||
public function activities(CaseContext $case): array
|
||
{
|
||
$booking = $case->booking;
|
||
if ($case->profile->documents() === Responsibility::Portal) {
|
||
return [new Activity('documents', 'Buchungsunterlagen an den Gast', ActivityState::External)];
|
||
}
|
||
|
||
$binding = $case->binding;
|
||
$state = match (true) {
|
||
$booking->confirmation_sent_at !== null => ActivityState::Done,
|
||
! $binding => ActivityState::Later,
|
||
$booking->confirmation_failed_at !== null => ActivityState::Problem,
|
||
default => ActivityState::Open,
|
||
};
|
||
$missing = $binding && $state === ActivityState::Open ? app(CaseAutomation::class)->documentBlockers($booking) : [];
|
||
// What the landlord still has to confirm (unreleased texts, terms not shown to be agreed on the portal).
|
||
$toConfirm = $binding && $state === ActivityState::Open && $missing === [] ? app(SendBookingDocuments::class)->compose($booking)->toConfirm() : [];
|
||
|
||
return [new Activity('documents', match (true) {
|
||
$state !== ActivityState::Open => $case->inquiry ? 'Buchungsbestätigung mit Vertrag senden' : 'Buchungsunterlagen an den Gast senden',
|
||
$case->inquiry => 'Buchungsbestätigung mit Vertrag prüfen und senden',
|
||
default => 'Buchungsunterlagen prüfen und senden',
|
||
}, $case->later($missing !== [] ? ActivityState::Waiting : $state),
|
||
match (true) {
|
||
$booking->confirmation_sent_at !== null => 'gesendet am '.$booking->confirmation_sent_at->format('d.m.Y'),
|
||
$state === ActivityState::Problem => 'Versand fehlgeschlagen',
|
||
$missing !== [] => 'wartet: '.implode(' ', $missing),
|
||
$toConfirm !== [] => 'vor dem Versand zu prüfen: '.implode(' ', $toConfirm),
|
||
default => null,
|
||
}, match (true) {
|
||
$state === ActivityState::Problem => 'resendConfirmation',
|
||
$binding && $missing === [] && $booking->confirmation_sent_at === null => 'sendDocuments',
|
||
default => null,
|
||
})];
|
||
}
|
||
|
||
/** The guest's e-mail and the price are what the documents need – not every detail of a request. */
|
||
public function due(CaseContext $case): bool
|
||
{
|
||
$booking = $case->booking;
|
||
|
||
return $booking->processingMode() === ProcessingMode::Automatic
|
||
&& $case->binding && $booking->confirmation_sent_at === null
|
||
&& $case->profile->documents() === Responsibility::Landlord && $case->profile->origin !== 'migration';
|
||
}
|
||
|
||
public function blockers(CaseContext $case): array
|
||
{
|
||
return app(CaseAutomation::class)->documentBlockers($case->booking);
|
||
}
|
||
|
||
public function run(CaseContext $case): StepResult
|
||
{
|
||
$reasons = app(SendBookingDocuments::class)->automatically($case->booking);
|
||
|
||
return $reasons === [] ? StepResult::ran() : StepResult::blocked($reasons);
|
||
}
|
||
|
||
public function isOutward(): bool
|
||
{
|
||
return true;
|
||
}
|
||
}
|