<?php

namespace App\Console\Commands;

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

/**
 * Setzt den monatlichen PM-Kontingent-Verbrauch aller User zurück.
 *
 * Fester Bestandteil des Tarif-Modells (geprüft R1.3, 03.07.2026): Die
 * Plan-Kontingente (§2/§3.3 Decision-Update) gelten pro Kalendermonat;
 * User::pressReleaseQuotaRemaining() rechnet gegen diesen Zähler. Läuft
 * per Scheduler am Monatsersten (siehe routes/console.php). Bewusste
 * Vereinfachung: Reset am Kalendermonat, nicht an der individuellen
 * Abo-Periode ausgerichtet.
 *
 * Idempotent und periodengebunden (Audit F18): zurückgesetzt wird nur, was
 * zu einem früheren Monat gehört (oder noch keinen Monat trägt). Verbrauch
 * des laufenden Monats bleibt – ein doppelter oder verspäteter Lauf ist
 * damit harmlos. Die fachliche Wahrheit liegt ohnehin in
 * User::pressReleaseQuotaUsedThisMonth(), der Befehl räumt nur auf.
 */
class ResetMonthlyPressReleaseQuota extends Command
{
    /**
     * @var string
     */
    protected $signature = 'press-releases:reset-monthly-quota';

    /**
     * @var string
     */
    protected $description = 'Setzt den monatlichen PM-Kontingent-Verbrauch (press_release_quota_used_this_month) aller User auf 0 zurück.';

    public function handle(): int
    {
        $period = User::currentQuotaPeriod();

        $affected = User::query()
            ->where('press_release_quota_used_this_month', '>', 0)
            ->where(fn ($query) => $query
                ->whereNull('press_release_quota_period')
                ->orWhere('press_release_quota_period', '<', $period))
            ->update([
                'press_release_quota_used_this_month' => 0,
                'press_release_quota_period' => $period,
            ]);

        $this->info(sprintf('Kontingent-Verbrauch für %d User zurückgesetzt.', $affected));

        return self::SUCCESS;
    }
}