Files
LarsandClaude Opus 5.5 3bcfc09417
Deploy FeWo mit PipelineManager / deploy (push) Successful in 4m44s
Pakete 8, 5 und 6: Beträge und Zahlungen, Ändern und Stornieren, A6 im Vorgang
- Paket 8: Zahlungsarten (Gast an uns, laut Portal, Auszahlung, Erstattung),
  Portalbeträge als Angaben mit Quelle, Übersicht nach Zuständigkeit (R09).
- Paket 5: Ändern mit Folgenvorschau, vereinbart oder dem Gast vorgeschlagen
  (signierter Link), ein Stornoweg mit Grund und Erstattung, Portalstorno erst
  nach Bestätigung.
- Paket 6: eigene Nutzung, Besuch und Sperre als Vorgang mit Kurabgabe und
  Aufenthaltsbestätigung; Bestandsübernahme der Sperren mit identischem Export.
- Wirksame Einstellungen (Expertenansicht), Abnahmekatalog T01–T14, Ergebnis-,
  Abnahme- und Konfigurationsdokument.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 22:16:47 +01:00

139 lines
4.7 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\Pricing;
use App\Enums\AmountKind;
use App\Enums\Responsibility;
use App\Models\Booking;
use App\Models\CaseAmount;
use Illuminate\Support\Collection;
/**
* The money of a case as four separate questions (package 8, K01): what the guest owes and to whom, what the guest has
* paid (to us or – according to the portal – to the portal), what the portal still has to pay out to us, and what has
* really arrived on our account. Every figure comes from a stated amount or a recorded payment; nothing is split up,
* estimated or counted twice, and contradicting statements are shown side by side with their difference.
*/
final class CaseMoney
{
private function __construct(private Booking $booking) {}
public static function of(Booking $booking): self
{
$booking->loadMissing(['payments', 'amounts']);
return new self($booking);
}
/**
* Who collects the guest's money (us, the portal, nobody for internal cases).
*/
public function collector(): Responsibility
{
return $this->booking->process()->payments();
}
public function total(): ?int
{
return $this->booking->total;
}
public function totalSource(): string
{
return match (true) {
$this->booking->total === null => 'noch nicht bekannt',
($this->booking->quote['source'] ?? null) === 'portal' => 'laut '.($this->booking->processChannel()?->name ?? 'Portal'),
$this->booking->isInternal() => 'vereinbart',
default => 'aus Ihren Preisen berechnet',
};
}
/**
* What the guest still owes us – only when we collect the money.
*/
public function openForUs(): int
{
return $this->collector() === Responsibility::Landlord ? $this->booking->openAmount() : 0;
}
/**
* What the guest still owes the portal according to the portal's statements (informational; the portal collects it).
*/
public function openAtPortal(): ?int
{
if ($this->collector() !== Responsibility::Portal || $this->booking->total === null) {
return null;
}
return max(0, $this->booking->total - $this->booking->paidViaPortal());
}
/**
* Instalments of the guest that the portal still shows as due.
*
* @return Collection<int, CaseAmount>
*/
public function installmentsDue(): Collection
{
return $this->amounts(AmountKind::InstallmentDue);
}
/**
* The price positions as stated, with their sum and whether they add up to the agreed total.
*
* @return array{positions: Collection<int, CaseAmount>, sum: int, difference: ?int}
*/
public function positions(): array
{
$positions = $this->booking->amounts->filter(fn (CaseAmount $amount): bool => $amount->kind->isPricePosition())->values();
$sum = (int) $positions->sum('amount');
return ['positions' => $positions, 'sum' => $sum, 'difference' => $positions->isEmpty() || $this->booking->total === null ? null : $this->booking->total - $sum];
}
/**
* @return Collection<int, CaseAmount>
*/
public function commissions(): Collection
{
return $this->amounts(AmountKind::Commission);
}
/**
* Payout announcements of the portal. Several different values are kept as they are; the difference is shown.
*
* @return array{announcements: Collection<int, CaseAmount>, values: list<int>, difference: int, received: int, outstanding: ?int}
*/
public function payout(): array
{
$announcements = $this->amounts(AmountKind::PayoutAnnounced);
$values = array_values(array_unique($announcements->pluck('amount')->map(fn ($value): int => (int) $value)->all()));
$received = $this->booking->payoutsReceived();
return [
'announcements' => $announcements,
'values' => $values,
'difference' => $values === [] ? 0 : max($values) - min($values),
'received' => $received,
// Only a single, consistent announcement gives an outstanding amount; contradicting ones are left to the person.
'outstanding' => count($values) === 1 ? max(0, $values[0] - $received) : null,
];
}
/**
* Money that really arrived on our account for this case: the guest's own payments (less refunds) and payouts.
*/
public function receivedOnAccount(): int
{
return $this->booking->paidToUs() + $this->booking->payoutsReceived();
}
/**
* @return Collection<int, CaseAmount>
*/
private function amounts(AmountKind $kind): Collection
{
return $this->booking->amounts->filter(fn (CaseAmount $amount): bool => $amount->kind === $kind)->values();
}
}