ladill-queue/app/Console/Commands/SendAppointmentRemindersCommand.php

<?php

namespace App\Console\Commands;

use App\Models\QueueAppointment;
use App\Services\Qms\QueueNotificationService;
use Illuminate\Console\Command;

class SendAppointmentRemindersCommand extends Command
{
    protected $signature = 'qms:send-appointment-reminders {--minutes=60 : Remind appointments this many minutes ahead}';

    protected $description = 'Send SMS/email reminders for upcoming appointments';

    public function handle(QueueNotificationService $notifications): int
    {
        $minutes = (int) $this->option('minutes');
        $from = now();
        $to = now()->addMinutes($minutes);

        $appointments = QueueAppointment::query()
            ->where('status', 'scheduled')
            ->whereBetween('scheduled_at', [$from, $to])
            ->where(function ($q) {
                $q->whereNull('metadata')
                    ->orWhereNull('metadata->reminder_sent');
            })
            ->get();

        $count = 0;
        foreach ($appointments as $appointment) {
            $notifications->appointmentReminder($appointment);
            $metadata = $appointment->metadata ?? [];
            $metadata['reminder_sent'] = now()->toIso8601String();
            $appointment->update(['metadata' => $metadata]);
            $count++;
        }

        $this->info("Sent {$count} appointment reminder(s).");

        return self::SUCCESS;
    }
}