<?php

declare(strict_types=1);

namespace App\Models;

use App\Enums\ReviewEvent;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\MorphTo;

/**
 * One thing somebody said while a record was being reviewed.
 *
 * Sits beside the change history rather than inside it. A revision knows the
 * title used to be something else; it cannot know that the reason this went
 * back is that the photo is missing, because nobody typed that anywhere the
 * history could see.
 */
#[Fillable(['user_id', 'user_name', 'event', 'body'])]
class ReviewComment extends Model
{
    protected function casts(): array
    {
        return ['event' => ReviewEvent::class];
    }

    /**
     * @return MorphTo<Model, $this>
     */
    public function reviewable(): MorphTo
    {
        return $this->morphTo();
    }

    /**
     * @return BelongsTo<User, $this>
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }

    /**
     * The live name when the account is at hand — people rename themselves —
     * and the recorded one otherwise, including once the account is gone.
     */
    public function author(): string
    {
        if ($this->relationLoaded('user') && $this->user !== null) {
            return $this->user->name;
        }

        return $this->user_name ?? __('panel.revisions.system');
    }
}