TenantAtlas/apps/platform/app/Models/FindingExceptionDecision.php

<?php

declare(strict_types=1);

namespace App\Models;

use App\Support\Concerns\DerivesWorkspaceIdFromTenant;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use LogicException;

class FindingExceptionDecision extends Model
{
    use DerivesWorkspaceIdFromTenant;
    use HasFactory;

    public const string TYPE_REQUESTED = 'requested';

    public const string TYPE_APPROVED = 'approved';

    public const string TYPE_REJECTED = 'rejected';

    public const string TYPE_RENEWAL_REQUESTED = 'renewal_requested';

    public const string TYPE_RENEWED = 'renewed';

    public const string TYPE_REVOKED = 'revoked';

    protected $guarded = [];

    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'effective_from' => 'datetime',
            'expires_at' => 'datetime',
            'metadata' => 'array',
            'decided_at' => 'datetime',
        ];
    }

    protected static function booted(): void
    {
        static::updating(static function (): void {
            throw new LogicException('Finding exception decisions are append-only.');
        });

        static::deleting(static function (): void {
            throw new LogicException('Finding exception decisions are append-only.');
        });
    }

    /**
     * @return BelongsTo<FindingException, $this>
     */
    public function exception(): BelongsTo
    {
        return $this->belongsTo(FindingException::class, 'finding_exception_id');
    }

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