Filament approve and reject actions with reason

<?php

namespace App\Filament\Actions;

use App\Models\Concerns\Approvable;
use Filament\Actions\Action;
use Filament\Forms\Components\Textarea;
use Filament\Notifications\Notification;
use Illuminate\Database\Eloquent\Model;

/** Use in recordActions([...]) of any table whose model uses the Approvable trait. */
class ApprovalActions
{
    public static function approve(): Action
    {
        return Action::make('approve')
            ->icon('heroicon-o-check-circle')
            ->color('success')
            ->requiresConfirmation()
            ->visible(fn (Model $record): bool => $record->isPending() && auth()->user()->can('approve', $record))
            ->action(function (Model $record): void {
                $record->approve(auth()->user());

                Notification::make()->title('Approved')->success()->send();
            });
    }

    public static function reject(): Action
    {
        return Action::make('reject')
            ->icon('heroicon-o-x-circle')
            ->color('danger')
            ->modalHeading('Reject this item')
            ->schema([
                // The reason is stored and shown to the author, so it is mandatory.
                Textarea::make('reason')->required()->minLength(10)->maxLength(500),
            ])
            ->visible(fn (Model $record): bool => $record->isPending() && auth()->user()->can('approve', $record))
            ->action(function (Model $record, array $data): void {
                $record->reject(auth()->user(), $data['reason']);

                Notification::make()->title('Rejected')->warning()->send();
            });
    }
}

<?php

namespace App\Models\Concerns;

use App\Models\User;
use Illuminate\Support\Facades\DB;
use RuntimeException;

/** Expects columns: status, reviewed_by, reviewed_at, rejection_reason. */
trait Approvable
{
    public function isPending(): bool
    {
        return $this->status === 'pending';
    }

    public function approve(User $reviewer): void
    {
        $this->transition('approved', $reviewer);
    }

    public function reject(User $reviewer, string $reason): void
    {
        $this->transition('rejected', $reviewer, $reason);
    }

    private function transition(string $to, User $reviewer, ?string $reason = null): void
    {
        DB::transaction(function () use ($to, $reviewer, $reason) {
            // Conditional update: two reviewers clicking at once cannot both win.
            $changed = static::query()
                ->whereKey($this->getKey())
                ->where('status', 'pending')
                ->update([
                    'status' => $to,
                    'reviewed_by' => $reviewer->getKey(),
                    'reviewed_at' => now(),
                    'rejection_reason' => $reason,
                ]);

            if ($changed === 0) {
                throw new RuntimeException('This item has already been reviewed.');
            }

            $this->refresh();
        });
    }
}