<?php

declare(strict_types=1);

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * App\Models\RankArtworkScore
 *
 * Materialised ranking scores for a single artwork.
 * Rebuilt hourly by RankComputeArtworkScoresJob.
 *
 * @property int    $artwork_id
 * @property float  $score_trending
 * @property float  $score_new_hot
 * @property float  $score_best
 * @property string $model_version
 * @property \Carbon\Carbon|null $computed_at
 */
class RankArtworkScore extends Model
{
    protected $table = 'rank_artwork_scores';

    /** Artwork_id is the primary key; no auto-increment. */
    protected $primaryKey = 'artwork_id';
    public $incrementing  = false;
    public $timestamps    = false;

    protected $fillable = [
        'artwork_id',
        'score_trending',
        'score_new_hot',
        'score_best',
        'model_version',
        'computed_at',
    ];

    protected $casts = [
        'artwork_id'      => 'integer',
        'score_trending'  => 'float',
        'score_new_hot'   => 'float',
        'score_best'      => 'float',
        'computed_at'     => 'datetime',
    ];

    // ── Relations ──────────────────────────────────────────────────────────

    public function artwork(): BelongsTo
    {
        return $this->belongsTo(Artwork::class, 'artwork_id');
    }

    // ── Helpers ────────────────────────────────────────────────────────────

    /**
     * Map list_type string to the corresponding score column.
     */
    public static function scoreColumn(string $listType): string
    {
        return match ($listType) {
            'new_hot' => 'score_new_hot',
            'best'    => 'score_best',
            default   => 'score_trending',
        };
    }
}