Files
fewo-stommer/app/Models/Property.php
LarsandClaude Opus 5.5 3a728c3255 Vorgangskern und geführte Vorgangsbearbeitung (Pakete 1 und 2, Prozessarchitektur v0.10)
- Buchung ist der einheitliche Vorgang: Eingangsart, Vorgangsart A1–A6, eingefrorenes
  Abwicklungsprofil, gespeicherter Verlauf (booking_events); Gast, Personen und Beträge
  dürfen unbekannt sein, Platzhalter-Gäste werden migriert und nicht mehr angelegt
- Einstellungen in Ebenen: Vermieterstandard (So arbeite ich), Abweichung der Wohnung
  (Experte), Abweichung je Portal und Eingangsart; ersetzt booking_model als Steuergröße
- Ein Weg für extern verbindliche Buchungen (TakeOverExternalBooking) statt
  RecordPortalBooking und "Akte anlegen"; Portalpreis als belegte Gesamtposition
- Startseite "Zu erledigen", neue Vorgangsseite mit nächstem Schritt, Automatik-Schalter,
  "Beenden" mit Storno statt Statusumschaltung; Status von Hand nur im Expertenmodus
- Migration übernimmt bisheriges Verhalten unverändert (abweichende Wohnungswerte bleiben
  als Abweichung), Bericht: php artisan process:settings-report

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

191 lines
4.8 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;
/**
* 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',
'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',
])]
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',
'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');
}
}