Files
fewo-stommer/app/Models/ContractTemplate.php
T
LarsandClaude Sonnet 5.5 0c4187edaf
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m34s
Stornoregeln mit automatischer Kostenberechnung, Storno-Verwaltung, Vertragsanlagen
- Stornoregel (Stufen nach Tagen vor Anreise, Mietpreis oder Gesamtpreis, Ersatzmieter-Gebuehr), je Vertragsvorlage,
  beim Angebot eingefroren, als Platzhalter im Vertrag
- Stornierung (Gast-Link oder Verwaltung) berechnet die Kosten, legt einen Stornofall an; Verwaltung Stornierungen
  mit Vorschlag, Festlegung, Saldo, Abrechnung und Erlass; Gast sieht die Kosten vorab auf der Storno-Seite
- Vertragsanlagen als eigene versionierte Dokumente mit Bedingung (immer, Zusatzleistung, Portal, von Hand),
  je Angebot ausgewaehlt und eingefroren; Zusatzleistungen in der Buchung erfassbar
- FeWo-direkt-Installation legt die Stornoregel aus Paragraf 13 an

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-30 16:32:48 +01:00

112 lines
3.4 KiB
PHP
Raw 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\Models;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Support\Collection;
/**
* A version of contract texts for offers (e.g. conditions demanded by a portal). The texts replace the website
* texts of the same meaning when an offer is made; the offer then freezes a copy. A version that has been used in
* an offer is never edited – a new version is created instead.
*/
#[Fillable(['name', 'version', 'texts', 'body', 'annex_title', 'annex_body', 'cancellation_policy_id', 'annex_ids', 'notes'])]
class ContractTemplate extends Model
{
use BelongsToTenant;
/** Form/storage key => website text key it replaces in an offer. */
public const TEXTS = [
'intro' => 'contract.intro',
'terms' => 'contract.terms',
'closing' => 'contract.closing',
'cancellation' => 'stay.cancellation',
'house_rules' => 'stay.house_rules',
'contract_note' => 'offer.contract_note',
];
/**
* Get the attributes that should be cast.
*
* @return array<string, string>
*/
protected function casts(): array
{
return ['texts' => 'array', 'version' => 'integer', 'annex_ids' => 'array'];
}
/**
* A complete contract document (text with placeholders) instead of text blocks.
*/
public function hasDocument(): bool
{
return filled($this->body) && trim(strip_tags((string) $this->body)) !== '';
}
/**
* @return BelongsTo<CancellationPolicy, $this>
*/
public function cancellationPolicy(): BelongsTo
{
return $this->belongsTo(CancellationPolicy::class);
}
/**
* The annexes of this template whose condition fits the booking.
*
* @return Collection<int, ContractAnnex>
*/
public function annexesFor(Booking $booking): Collection
{
return ContractAnnex::query()->whereIn('id', (array) ($this->annex_ids ?? []))->orderBy('name')->get()->filter(fn (ContractAnnex $annex): bool => $annex->appliesTo($booking))->values();
}
public function label(): string
{
return $this->name.' (Version '.$this->version.')';
}
/**
* Texts by website text key; blank ones fall back to the website texts.
*
* @return array<string, string>
*/
public function overrides(): array
{
$overrides = [];
foreach (self::TEXTS as $field => $key) {
$value = $this->texts[$field] ?? null;
if (filled($value) && trim(strip_tags((string) $value)) !== '') {
$overrides[$key] = (string) $value;
}
}
return $overrides;
}
public function isUsed(): bool
{
return Booking::query()->where('offer_terms->template->id', $this->id)->exists();
}
public function newVersion(): self
{
$latest = static::query()->where('name', $this->name)->max('version');
return static::query()->create([
'name' => $this->name,
'version' => $latest + 1,
'texts' => $this->texts,
'body' => $this->body,
'annex_title' => $this->annex_title,
'annex_body' => $this->annex_body,
'cancellation_policy_id' => $this->cancellation_policy_id,
'annex_ids' => $this->annex_ids,
'notes' => $this->notes,
]);
}
}