- 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>
224 lines
6.3 KiB
PHP
224 lines
6.3 KiB
PHP
<?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;
|
||
}
|
||
}
|