portal/app/app/Console/Commands/ExpireInvoicesCommand.php

<?php

declare(strict_types=1);

namespace App\Console\Commands;

use App\Models\SaasInvoice;
use Illuminate\Console\Command;

/**
 * Помечает просроченные неоплаченные счета статусом overdue (Этап 1 «оплата по счёту»).
 * Только issued → overdue по expires_at; оплаченные/отменённые не трогаются.
 */
class ExpireInvoicesCommand extends Command
{
    protected $signature = 'invoices:expire';

    protected $description = 'Помечает просроченные неоплаченные счета статусом overdue';

    public function handle(): int
    {
        SaasInvoice::where('status', SaasInvoice::STATUS_ISSUED)
            ->where('expires_at', '<', now())
            ->update(['status' => SaasInvoice::STATUS_OVERDUE]);

        return self::SUCCESS;
    }
}