Files
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

86 lines
3.6 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\Modules\Money;
use App\Enums\ActivityState;
use App\Enums\Execution;
use App\Enums\ProcessSetting;
use App\Enums\Responsibility;
use App\Process\Activity;
use App\Process\CaseContext;
use App\Process\Modules\Module;
use App\Process\Modules\ModuleDefinition;
use App\Support\Money;
/**
* P03: the guest's payments – deposit and balance when we collect (A1–A3), the portal's collection when it collects
* (A4/A5: only "laut Portal", never money on our account). Reminders are sent by SendBookingReminders.
*/
final class PaymentMonitoring extends Module
{
public static function key(): string
{
return 'payments.monitor';
}
public static function definition(): ModuleDefinition
{
return new ModuleDefinition(
label: 'Zahlungen des Gastes',
purpose: 'Überwacht Anzahlung und Restzahlung und erinnert rechtzeitig – oder zeigt, was das Portal laut eigener Angabe eingezogen hat.',
phase: 'P03',
executions: [Execution::Manual, Execution::Portal],
condition: 'bei jeder verbindlichen Buchung',
why: 'Zahlungen werden überwacht – von uns oder durch das Portal (nur „laut Portal“).',
effects: ['case_write', 'guest_mail'],
waits: ['guest', 'portal', 'time'],
triggers: ['payment.recorded', 'portal.amounts', 'schedule:reminders'],
parameters: [ProcessSetting::Payments, ProcessSetting::GuestMessages],
performers: ['landlord', 'portal'],
events: ['payment', 'amount'],
readsContractData: true,
);
}
public function applies(CaseContext $case): bool
{
return ! $case->booking->isInternal();
}
public function activities(CaseContext $case): array
{
$booking = $case->booking;
$binding = $case->binding;
if ($case->profile->payments() === Responsibility::Portal) {
$portal = $booking->processChannel()?->name ?? 'das Portal';
$viaPortal = $booking->paidViaPortal();
return [new Activity('payment', 'Zahlung des Gastes an '.$portal, ActivityState::External, match (true) {
$booking->total === null => 'zieht das Portal ein',
$viaPortal > 0 => 'laut Portal bezahlt: '.Money::format($viaPortal).' von '.Money::format($booking->total).' (Angabe des Portals, kein Geld bei uns)',
default => 'zieht das Portal ein; noch keine Zahlungsangabe',
})];
}
if ($booking->total === null) {
return [new Activity('payment', 'Zahlungen überwachen', $case->later(ActivityState::Waiting), 'erst möglich, wenn der Preis bekannt ist')];
}
$paid = $booking->paidAmount();
return [
new Activity('deposit', 'Anzahlung erhalten', $case->later(match (true) {
$binding && $paid >= (int) $booking->deposit => ActivityState::Done,
$binding => ActivityState::Waiting,
default => ActivityState::Later,
}), Money::format((int) $booking->deposit).($booking->deposit_due_on ? ', fällig '.$booking->deposit_due_on->format('d.m.Y') : '')),
new Activity('balance', 'Restzahlung erhalten', $case->later(match (true) {
$binding && $paid >= $booking->total => ActivityState::Done,
$binding && $paid >= (int) $booking->deposit => ActivityState::Waiting,
default => ActivityState::Later,
}), Money::format(max(0, $booking->total - (int) $booking->deposit)).($booking->balance_due_on ? ', fällig '.$booking->balance_due_on->format('d.m.Y') : '')),
];
}
}