Files
fewo-stommer/app/Models/ContractTemplate.php
LarsandClaude Opus 5.5 cf11c8a474
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m59s
Dokumentenzusammenstellung und Vorlagensteuerung (Paket 3, Prozessarchitektur v0.10)
Eine Zusammenstellung vor jedem Dokument (Angebot, Bestaetigung, Buchungsunterlagen
extern), Dokumentart je Vorgangsart, Freigaben fuer Vorlagen und Dokumentarten,
Schutz vor unvereinbarten Bedingungen bei Portalbuchungen (E-004), kein doppelter
Versand, Absicherung Hold 0 bis Paket 7, A6-Aufenthaltsbestaetigung vorbereitet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 19:44:52 +01:00

179 lines
6.4 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\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.
*
* A version goes to guests automatically only when it is released; for bookings already binding on a portal it must in
* addition be confirmed as reproducing only what guests accept there (E-004). Both statements belong to the text: they
* lapse when the text changes, and a new version starts without them.
*/
#[Fillable(['name', 'version', 'texts', 'body', 'annex_title', 'annex_body', 'cancellation_policy_id', 'annex_ids', 'notes', 'released_at', 'released_by', 'portal_terms_confirmed_at', 'portal_terms_confirmed_by'])]
class ContractTemplate extends Model
{
use BelongsToTenant;
/** Form/storage key => website text key it replaces in an offer. */
/** Attributes whose change makes the release and the portal confirmation lapse. */
/** Whether the statements were given for the pending save (then a text change does not withdraw them). */
private bool $statementsApplied = false;
private const CONTENT = ['texts', 'body', 'annex_title', 'annex_body', 'cancellation_policy_id', 'annex_ids'];
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', 'released_at' => 'datetime', 'portal_terms_confirmed_at' => 'datetime'];
}
protected static function booted(): void
{
static::saved(function (ContractTemplate $template): void {
$template->statementsApplied = false;
});
static::saving(function (ContractTemplate $template): void {
if ($template->exists && $template->isDirty(self::CONTENT) && ! $template->statementsApplied) {
if (! $template->isDirty('released_at')) {
$template->released_at = null;
$template->released_by = null;
}
if (! $template->isDirty('portal_terms_confirmed_at')) {
$template->portal_terms_confirmed_at = null;
$template->portal_terms_confirmed_by = null;
}
}
});
}
/**
* Records the landlord's statements on the (possibly just changed) text: a statement is renewed when it is given for
* a changed text, kept when nothing changed and withdrawn when it is not given.
*/
public function applyStatements(bool $released, bool $portalTerms, string $actor): self
{
$changed = $this->isDirty(self::CONTENT);
$this->statementsApplied = true;
if (! $released) {
$this->forceFill(['released_at' => null, 'released_by' => null]);
} elseif ($changed || ! $this->isReleased()) {
$this->forceFill(['released_at' => now(), 'released_by' => $actor]);
}
if (! $portalTerms) {
$this->forceFill(['portal_terms_confirmed_at' => null, 'portal_terms_confirmed_by' => null]);
} elseif ($changed || ! $this->confirmsPortalTerms()) {
$this->forceFill(['portal_terms_confirmed_at' => now(), 'portal_terms_confirmed_by' => $actor]);
}
return $this;
}
public function isReleased(): bool
{
return $this->released_at !== null;
}
/**
* Whether the landlord confirmed that this version only reproduces the terms guests accept when booking on a portal.
*/
public function confirmsPortalTerms(): bool
{
return $this->portal_terms_confirmed_at !== null;
}
/**
* 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,
]);
}
}