Files
SkinbaseNova/app/Models/RankArtworkScore.php

70 lines
2.0 KiB
PHP

<?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',
};
}
}