<?php
// app/Jobs/EnvoyerFactureJob.php
namespace App\Jobs;

use App\Models\Commande;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class EnvoyerFactureJob implements ShouldQueue {
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;                  // nombre de tentatives avant échec définitif
    public int $backoff = 60;               // délai (s) entre chaque tentative
    public int $timeout = 120;              // durée max d'exécution avant timeout

    public function __construct(private readonly Commande $commande) {}

    public function handle(\App\Services\FacturationService $facturation): void {
        $pdf = $facturation->genererPdf($this->commande);
        $facturation->envoyerParEmail($this->commande->client, $pdf);
    }

    // Appelé si le job échoue définitivement (toutes les tentatives épuisées)
    public function failed(\Throwable $exception): void {
        \Log::error("Échec envoi facture commande {$this->commande->id}: {$exception->getMessage()}");
        $this->commande->update(['statut_facturation' => 'echec']);
    }

    // Détermine dynamiquement quand chaque nouvelle tentative doit avoir lieu (backoff exponentiel)
    public function backoff(): array {
        return [10, 60, 300]; // 10s, puis 60s, puis 5min
    }
}

// Dispatcher un job sur la queue par défaut, ou une queue nommée
EnvoyerFactureJob::dispatch($commande);
EnvoyerFactureJob::dispatch($commande)->onQueue('emails')->delay(now()->addMinutes(5));

// Dispatch conditionnel et synchrone (utile en tests, exécute immédiatement sans queue)
EnvoyerFactureJob::dispatchSync($commande);
EnvoyerFactureJob::dispatchIf($commande->total > 0, $commande);

// Chaînage de jobs : exécution séquentielle, s'arrête si un job échoue
\Illuminate\Support\Facades\Bus::chain([
    new PreparerCommandeJob($commande),
    new EnvoyerFactureJob($commande),
    new NotifierClientJob($commande),
])->dispatch();

// Batch : exécuter plusieurs jobs en parallèle avec callback de complétion
\Illuminate\Support\Facades\Bus::batch([
    new TraiterImageJob($produit1),
    new TraiterImageJob($produit2),
])->then(function ($batch) {
    \Log::info("Traitement terminé: {$batch->processedJobs()} jobs");
})->catch(function ($batch, \Throwable $e) {
    \Log::error("Batch échoué: {$e->getMessage()}");
})->dispatch();

# config/queue.php -> driver 'redis' recommandé en prod (database/sync en dev/tests seulement)

php artisan queue:work redis --queue=emails,default --tries=3   # worker en premier plan
php artisan queue:work --daemon                                  # process long-vivant (via Supervisor en prod)
php artisan queue:failed                                         # liste les jobs échoués
php artisan queue:retry all                                      # rejoue tous les jobs échoués
php artisan horizon                                               # dashboard de supervision (Redis uniquement)