mivita/app/Models/Incentive.php

<?php

namespace App\Models;

use Carbon\Carbon;
use Cviebrock\EloquentSluggable\Sluggable;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

/**
 * Class Incentive
 *
 * @property int $id
 * @property string $name
 * @property array|null $trans_name
 * @property string|null $subtitle
 * @property array|null $trans_subtitle
 * @property string $slug
 * @property string|null $description
 * @property array|null $trans_description
 * @property string|null $image
 * @property string|null $terms
 * @property array|null $trans_terms
 * @property Carbon $qualification_start
 * @property Carbon $qualification_end
 * @property Carbon $calculation_end
 * @property int $points_partner_onetime
 * @property int $points_abo_onetime
 * @property int $min_direct_partners
 * @property int $min_customer_abos
 * @property int $max_winners
 * @property int $status
 * @property Carbon|null $created_at
 * @property Carbon|null $updated_at
 * @property Carbon|null $deleted_at
 * @property-read Collection<int, IncentiveParticipant> $participants
 *
 * @method static \Illuminate\Database\Eloquent\Builder|Incentive newModelQuery()
 * @method static \Illuminate\Database\Eloquent\Builder|Incentive newQuery()
 * @method static \Illuminate\Database\Eloquent\Builder|Incentive query()
 *
 * @mixin \Eloquent
 */
class Incentive extends Model
{
    use HasFactory, Sluggable, SoftDeletes;

    protected $table = 'incentives';

    protected $casts = [
        'trans_name' => 'array',
        'trans_subtitle' => 'array',
        'trans_description' => 'array',
        'trans_terms' => 'array',
        'points_partner_onetime' => 'int',
        'points_abo_onetime' => 'int',
        'min_direct_partners' => 'int',
        'min_customer_abos' => 'int',
        'max_winners' => 'int',
        'status' => 'int',
        'qualification_start' => 'date',
        'qualification_end' => 'date',
        'calculation_end' => 'date',
    ];

    protected $fillable = [
        'name',
        'trans_name',
        'subtitle',
        'trans_subtitle',
        'description',
        'trans_description',
        'image',
        'terms',
        'trans_terms',
        'qualification_start',
        'qualification_end',
        'calculation_end',
        'points_partner_onetime',
        'points_abo_onetime',
        'min_direct_partners',
        'min_customer_abos',
        'max_winners',
        'status',
    ];

    public static $statusTypes = [
        0 => 'draft',
        1 => 'active',
        2 => 'closed',
    ];

    public static $statusColors = [
        0 => 'warning',
        1 => 'success',
        2 => 'secondary',
    ];

    public function sluggable(): array
    {
        return [
            'slug' => [
                'source' => 'name',
            ],
        ];
    }

    // Relationships

    public function participants()
    {
        return $this->hasMany(IncentiveParticipant::class);
    }

    // Scopes

    public function scopeActive($query)
    {
        return $query->where('status', 1);
    }

    public function scopeInQualificationPeriod($query, ?Carbon $date = null)
    {
        $date = $date ?: Carbon::now();

        return $query->where('qualification_start', '<=', $date)
            ->where('qualification_end', '>=', $date);
    }

    public function scopeInCalculationPeriod($query, ?Carbon $date = null)
    {
        $date = $date ?: Carbon::now();

        return $query->where('qualification_start', '<=', $date)
            ->where('calculation_end', '>=', $date);
    }

    /**
     * Incentives, deren Qualifikationsfenster das Datum enthaelt (Datumsvergleich auf Tagesebene,
     * damit auch Zeitstempel am letzten Fenstertag zaehlen).
     */
    public function scopeQualificationWindowContains($query, Carbon $date)
    {
        return $query->whereDate('qualification_start', '<=', $date)
            ->whereDate('qualification_end', '>=', $date);
    }

    // Helpers

    public function isActive(): bool
    {
        return $this->status === 1;
    }

    public function isDraft(): bool
    {
        return $this->status === 0;
    }

    public function isClosed(): bool
    {
        return $this->status === 2;
    }

    public function isInQualificationPeriod(?Carbon $date = null): bool
    {
        $date = $date ?: Carbon::now();

        return $date->between($this->qualification_start, $this->qualification_end);
    }

    public function isInCalculationPeriod(?Carbon $date = null): bool
    {
        $date = $date ?: Carbon::now();

        return $date->between($this->qualification_start, $this->calculation_end);
    }

    public function isDateInScope(int $month, int $year): bool
    {
        $date = Carbon::createFromDate($year, $month, 1);

        return $date->between(
            $this->qualification_start->copy()->startOfMonth(),
            $this->calculation_end->copy()->endOfMonth()
        );
    }

    public function getStatusType(): string
    {
        return isset(self::$statusTypes[$this->status]) ? __('incentive.status_'.self::$statusTypes[$this->status]) : '';
    }

    public function getStatusColor(): string
    {
        return self::$statusColors[$this->status] ?? 'default';
    }

    /**
     * Get specific translation for a field and locale.
     */
    public function getTrans(string $key, string $lang): string
    {
        $transKey = 'trans_'.$key;
        if (! empty($this->{$transKey}[$lang])) {
            return $this->{$transKey}[$lang];
        }

        return '';
    }

    /**
     * Get translated value for the current locale, falling back to German (default).
     */
    public function getLang(string $key): string
    {
        $lang = \App::getLocale();
        if ($lang === 'de') {
            return (string) ($this->{$key} ?? '');
        }
        $trans = $this->getTrans($key, $lang);
        if ($trans !== '') {
            return $trans;
        }

        return (string) ($this->{$key} ?? '');
    }

    /**
     * Qualifikationsfenster als Zeitstempel-Paar: [Start 00:00:00, Ende 23:59:59].
     * Zentrale Fensterberechnung, damit Bestellungen am letzten Fenstertag ueberall zaehlen.
     *
     * @return array{0: Carbon, 1: Carbon}
     */
    public function qualificationWindow(): array
    {
        return [
            $this->qualification_start->copy()->startOfDay(),
            $this->qualification_end->copy()->endOfDay(),
        ];
    }

    /**
     * Liegt der Zeitstempel im Qualifikationsfenster (inkl. des kompletten letzten Tages)?
     */
    public function qualificationWindowContains(Carbon $date): bool
    {
        [$windowStart, $windowEnd] = $this->qualificationWindow();

        return $date->between($windowStart, $windowEnd);
    }

    /**
     * @return array<int, array{month: int, year: int}>
     */
    public function getCalculationMonths(): array
    {
        $months = [];
        $current = $this->qualification_start->copy()->startOfMonth();
        $end = $this->calculation_end->copy()->startOfMonth();

        while ($current->lte($end)) {
            $months[] = [
                'month' => $current->month,
                'year' => $current->year,
            ];
            $current->addMonth();
        }

        return $months;
    }
}