Files
fewo-stommer/app/Models/Property.php
T
LarsandClaude Opus 5.5 40d20cb7d1 Pakete 7 und 9: Auskunft und Buchungswunsch, Aufenthalt und Abschluss (Zwischenstand)
- Haltefrist 0: unverbindliche Auskunft mit signiertem Link "Buchung anfragen",
  erneute Prüfung unter Sperre, automatische oder manuelle Bestätigung, Absage
  bei vergebenem Zeitraum, Ablauf unbeantworteter Auskünfte
- Aufenthalt: Anreisedaten, Aufgaben je Wohnung, gebuchte Leistungen,
  Abweichungen und Folgeaufgaben als Aufgaben am Vorgang
- Abschluss getrennt: Aufenthalt abgeschlossen / kaufmännisch abgeschlossen,
  Nachläufer (Forderung, Auszahlung) bleiben sichtbar
- Zahlungsstatus nur aus Geld auf unserem Konto; Altbestand per Vorschau-Befehl
- Verlauf weist Testzustellungen als solche aus
- Abnahmetests T16-T25, T23 über isolierten SMTP-Empfänger

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

224 lines
6.3 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\Enums\CancellationMode;
use App\Enums\OfferMode;
use App\Models\Concerns\BelongsToTenant;
use Carbon\CarbonImmutable;
use Database\Factories\PropertyFactory;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
use Illuminate\Support\Str;
/**
* A rentable holiday apartment. All money amounts are stored in euro cents.
*/
#[Fillable([
'site_id',
'name',
'slug',
'image_world',
'address',
'size_sqm',
'max_guests',
'included_guests',
'extra_guest_fee_per_night',
'cleaning_fee',
'tourist_tax_rate',
'deposit_percent',
'balance_due_days_before_arrival',
'hold_hours',
'offer_mode',
'pre_reservation_enabled',
'arrival_info_days_before',
'cancellation_mode',
'free_cancellation_days',
'contract_template_id',
'contract_data',
'check_in_time',
'check_out_time',
'changeover_weekday',
'min_stay_fill_gaps',
'min_stay_until_changeover',
'min_stay_absolute',
'is_active',
'process_overrides',
'stay_tasks',
'asks_arrival_time',
])]
class Property extends Model
{
/** @use HasFactory<PropertyFactory> */
use BelongsToTenant, HasFactory;
/**
* Get the attributes that should be cast.
*
* @return array<string, string>
*/
/**
* Defaults of the minimum stay rules (as in the migration), also before the model is reloaded.
*
* @var array<string, mixed>
*/
protected $attributes = [
'min_stay_fill_gaps' => true,
'min_stay_until_changeover' => false,
'min_stay_absolute' => 2,
'offer_mode' => 'manual',
'pre_reservation_enabled' => true,
'arrival_info_days_before' => 3,
'cancellation_mode' => 'request',
'free_cancellation_days' => 14,
];
protected function casts(): array
{
return [
'is_active' => 'boolean',
'offer_mode' => OfferMode::class,
'pre_reservation_enabled' => 'boolean',
'arrival_info_days_before' => 'integer',
'cancellation_mode' => CancellationMode::class,
'free_cancellation_days' => 'integer',
'contract_data' => 'array',
'process_overrides' => 'array',
'stay_tasks' => 'array',
'asks_arrival_time' => 'boolean',
'min_stay_fill_gaps' => 'boolean',
'min_stay_until_changeover' => 'boolean',
'changeover_weekday' => 'integer',
'min_stay_absolute' => 'integer',
];
}
/**
* @return HasMany<Season, $this>
*/
/**
* @return BelongsTo<Site, $this>
*/
public function site(): BelongsTo
{
return $this->belongsTo(Site::class);
}
public function seasons(): HasMany
{
return $this->hasMany(Season::class)->orderBy('starts_on');
}
/**
* @return HasMany<Booking, $this>
*/
public function bookings(): HasMany
{
return $this->hasMany(Booking::class);
}
/**
* @return HasMany<BlockedPeriod, $this>
*/
public function blockedPeriods(): HasMany
{
return $this->hasMany(BlockedPeriod::class)->orderBy('starts_on');
}
/**
* @return HasMany<Channel, $this>
*/
public function channels(): HasMany
{
return $this->hasMany(Channel::class);
}
/**
* @return HasMany<Amenity, $this>
*/
public function amenities(): HasMany
{
return $this->hasMany(Amenity::class)->orderBy('sort_order');
}
/**
* @return HasOne<FloorPlan, $this>
*/
public function floorPlan(): HasOne
{
return $this->hasOne(FloorPlan::class);
}
/**
* @return HasMany<SpecialOffer, $this>
*/
public function specialOffers(): HasMany
{
return $this->hasMany(SpecialOffer::class);
}
/**
* Periods within [$from, $until) for which no season defines a price.
*
* @return list<array{from: CarbonImmutable, until: CarbonImmutable}>
*/
public function uncoveredPeriods(CarbonImmutable $from, CarbonImmutable $until): array
{
$gaps = [];
$cursor = $from;
foreach ($this->seasons()->overlapping($from, $until)->get() as $season) {
if ($season->starts_on->greaterThan($cursor)) {
$gaps[] = ['from' => $cursor, 'until' => $season->starts_on];
}
$cursor = $cursor->max($season->ends_on);
}
if ($cursor->lessThan($until)) {
$gaps[] = ['from' => $cursor, 'until' => $until];
}
return $gaps;
}
/**
* @return HasMany<Extra, $this>
*/
public function extras(): HasMany
{
return $this->hasMany(Extra::class)->orderBy('sort_order');
}
/**
* The stay tasks of this property (package 9): local services and provider jobs such as cleaning, linen or the key
* handover, each with when it is due and for which kinds of stays it applies. No staff planning – a task per case.
*
* @return list<array{key: string, title: string, when: string, days: int, responsible: ?string, applies_to: list<string>}>
*/
public function stayTaskDefinitions(): array
{
$definitions = [];
foreach ((array) ($this->stay_tasks ?? []) as $task) {
$title = trim((string) ($task['title'] ?? ''));
if ($title === '') {
continue;
}
$definitions[] = [
'key' => 'stay:'.mb_substr(Str::slug($title), 0, 70),
'title' => $title,
'when' => in_array($task['when'] ?? null, ['before_arrival', 'on_arrival', 'after_departure'], true) ? $task['when'] : 'before_arrival',
'days' => max(0, (int) ($task['days'] ?? 1)),
'responsible' => filled($task['responsible'] ?? null) ? trim((string) $task['responsible']) : null,
'applies_to' => array_values(array_filter((array) ($task['applies_to'] ?? ['rental']))) ?: ['rental'],
];
}
return $definitions;
}
}