*/ use BelongsToTenant, HasChannelProvenance, HasFactory; public const DIRECT_SOURCES = ['website', 'manual', 'phone', 'direct', 'email']; public function isDirect(): bool { return $this->import_channel_id === null && $this->origin_channel_id === null && in_array($this->source, self::DIRECT_SOURCES, true); } protected static function booted(): void { static::created(function (Booking $booking): void { $booking->forceFill(['reference' => $booking->nextReference()])->saveQuietly(); }); } /** * Next booking number of this landlord in the year of creation, continuing after the highest * number already issued. Existing numbers are never rewritten. */ public function nextReference(): string { $year = $this->created_at->format('Y'); $references = static::withoutGlobalScope('tenant') ->where('tenant_id', $this->tenant_id) ->where('reference', 'like', $year.'-%') ->whereKeyNot($this->id) ->lockForUpdate() ->pluck('reference'); $number = 1; foreach ($references as $reference) { if (is_string($reference) && preg_match('/-(\d+)$/', $reference, $match) === 1) { $number = max($number, ((int) $match[1]) + 1); } } return $year.'-'.str_pad((string) $number, 4, '0', STR_PAD_LEFT); } /** * Get the attributes that should be cast. * * @return array */ protected function casts(): array { return [ 'status' => BookingStatus::class, 'referral_source' => ReferralSource::class, 'arrival' => 'immutable_date', 'departure' => 'immutable_date', 'extras' => 'array', 'quote' => 'array', 'deposit_due_on' => 'immutable_date', 'balance_due_on' => 'immutable_date', 'hold_expires_at' => 'immutable_datetime', 'confirmed_at' => 'immutable_datetime', 'offer_sent_at' => 'immutable_datetime', 'accepted_at' => 'immutable_datetime', 'acceptance' => 'array', 'offer_terms' => 'array', 'confirmation_sent_at' => 'immutable_datetime', 'confirmation_failed_at' => 'immutable_datetime', 'cancelled_at' => 'immutable_datetime', 'review_requested_at' => 'immutable_datetime', 'deposit_reminded_at' => 'immutable_datetime', 'balance_requested_at' => 'immutable_datetime', 'balance_reminded_at' => 'immutable_datetime', 'arrival_info_sent_at' => 'immutable_datetime', 'contact_requested_at' => 'immutable_datetime', 'guest_confirmed_at' => 'immutable_datetime', 'archived_at' => 'immutable_datetime', ]; } /** * @return BelongsTo */ public function property(): BelongsTo { return $this->belongsTo(Property::class); } /** * @return BelongsTo */ public function guest(): BelongsTo { return $this->belongsTo(Guest::class); } /** @return BelongsTo */ public function originChannel(): BelongsTo { return $this->belongsTo(Channel::class, 'origin_channel_id'); } /** @return BelongsTo */ public function importChannel(): BelongsTo { return $this->belongsTo(Channel::class, 'import_channel_id'); } /** @return HasMany */ public function channelRepresentations(): HasMany { return $this->hasMany(BlockedPeriod::class, 'linked_booking_id'); } public function bookingChannelLabel(): string { return $this->originChannel?->name ?? $this->importChannel?->name ?? match ($this->source) { 'website' => 'Eigene Webseite', 'manual' => 'Manuell / direkt', 'phone' => 'Telefon', 'email' => 'E-Mail', 'direct' => 'Direkt', default => $this->source, }; } /** * Bookings that currently occupy their dates: confirmed ones and requests/offers whose hold has not expired. * * @param Builder $query * @return Builder */ #[Scope] protected function occupying(Builder $query): Builder { return $query->where(fn (Builder $query) => $query ->whereIn('status', BookingStatus::occupying()) ->orWhere(fn (Builder $query) => $query ->whereIn('status', BookingStatus::holding()) ->where('hold_expires_at', '>', now()))); } /** * @param Builder $query * @return Builder */ #[Scope] protected function overlapping(Builder $query, CarbonInterface $from, CarbonInterface $until): Builder { return $query ->whereDate('arrival', '<', $until) ->whereDate('departure', '>', $from); } /** * @return HasOne */ public function review(): HasOne { return $this->hasOne(Review::class); } /** * @return HasMany */ public function messages(): HasMany { return $this->hasMany(BookingMessage::class); } /** * @return HasMany */ public function tasks(): HasMany { return $this->hasMany(BookingTask::class); } /** * @return HasMany */ public function payments(): HasMany { return $this->hasMany(Payment::class)->orderBy('paid_on'); } /** * Sum of all payments in cents (refunds are negative). */ public function paidAmount(): int { return (int) ($this->relationLoaded('payments') ? $this->payments->sum('amount') : $this->payments()->sum('amount')); } public function openAmount(): int { return max(0, $this->total - $this->paidAmount()); } public function openDeposit(): int { return max(0, $this->deposit - $this->paidAmount()); } /** * When the balance is already due at confirmation (short-term booking), the guest pays everything at once. */ public function requiresFullPayment(): bool { return $this->deposit_due_on !== null && $this->balance_due_on->lessThanOrEqualTo($this->deposit_due_on); } /** * Whether the landlord chases payments of this booking. Own bookings: always. Portal bookings: as configured * per channel and kind – a reservation whose payment the portal collects (e.g. instant booking) needs no * tasks, a mere inquiry passed on by the portal does. */ public function wantsPaymentTasks(): bool { $channel = $this->importChannel ?? $this->originChannel; if ($channel === null) { return true; } return $channel->booking_model === ChannelBookingModel::PortalBooking ? $channel->payment_tasks_reservation : $channel->payment_tasks_inquiry; } /** * Whether the guest already asked to cancel (or cancelled) through the cancellation link. */ public function cancellationRequested(): bool { return BookingTask::query()->where('booking_id', $this->id)->where('kind', BookingTaskKind::CancellationRequest)->exists(); } public function nights(): int { return (int) $this->arrival->diffInDays($this->departure); } /** * Inside a transaction: locks the property (the lock every writer of bookings takes) and this booking's row * and reloads the attributes from the locked row, so status and dates are the latest committed ones. */ public function lockForTransition(): void { Property::withoutGlobalScope('tenant')->whereKey($this->property_id)->lockForUpdate()->first(); $locked = static::withoutGlobalScope('tenant')->whereKey($this->getKey())->lockForUpdate()->firstOrFail(); $this->setRawAttributes($locked->getAttributes(), sync: true); } /** * A contract text of this offer version (frozen snapshot, live text for bookings without one). */ public function offerText(string $key): ?string { return OfferTerms::text($this, $key); } public function offerHtml(string $key): HtmlString { return OfferTerms::html($this, $key); } /** * Whether the booking may be moved to the archive: it is over (closed, or the stay has ended) and holds nothing. */ public function canBeArchived(): bool { return in_array($this->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true) || ($this->departure->isPast() && in_array($this->status, BookingStatus::occupying(), true)); } public function isHoldActive(): bool { return in_array($this->status, BookingStatus::holding(), true) && $this->hold_expires_at?->isFuture(); } /** * The website this stay belongs to, regardless of which landlord is current. */ public function website(): ?Site { return $this->property()->withoutGlobalScope('tenant')->first() ?->site()->withoutGlobalScope('tenant')->first(); } }