<?php

namespace App\Services;

use App\Models\Classe;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Cache;

/**
 * Cache Redis du tableau de bord prof (bloc B, 2026-10-14) : la liste de
 * ses classes (avec le nombre d'élèves) est relue à chaque chargement de
 * « Mes classes » et du cockpit d'une classe — et, pendant une séance en
 * cours, toutes les 15 secondes par le rafraîchissement automatique. Elle
 * ne change que sur une création, un archivage, un désarchivage ou une
 * purge RGPD : jamais d'expiration, invalidée explicitement à ces moments.
 *
 * Stocke les attributs bruts, pas les modèles (voir CacheCatalogue pour le
 * pourquoi) ; `Classe::hydrate()` reconstruit de vrais modèles à la lecture.
 */
class CacheTableauDeBordProf
{
    /** @return Collection<int, Classe> */
    public static function classes(int $profId): Collection
    {
        return Classe::hydrate(Cache::rememberForever(
            "prof:{$profId}:classes",
            fn () => Classe::where('user_id', $profId)->withCount('eleves')->orderBy('nom')->get()->map->getAttributes()->all()
        ));
    }

    public static function vider(int $profId): void
    {
        Cache::forget("prof:{$profId}:classes");
    }
}