ajoute la liaison Laravel-OpenStack et le modèle Heat du lab 08

Un gabarit Heat généré depuis chaque lab.yaml, une stack par session de
lab (création à l'admission, suppression à l'expiration via des jobs
Redis et un worker systemd dédié). Passage du compte de service à une
authentification par mot de passe : Heat refuse de créer un trust à
partir d'un jeton d'application credential (voir ADR 0002).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

portail/app/Services/OpenStack/HeatClient.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Services\OpenStack;
+
+use Illuminate\Support\Facades\Http;
+use RuntimeException;
+
+/**
+ * Juste ce qu'il faut pour créer, suivre et supprimer une stack Heat
+ * (étape 10) — pas de client générique, le besoin réel de Syllabus est
+ * étroit (un lab = une stack, pour la durée d'une session).
+ */
+class HeatClient
+{
+    public function __construct(private readonly KeystoneAuth $auth) {}
+
+    /**
+     * @return array{id: string}
+     */
+    public function creerStack(string $nom, array $template): array
+    {
+        $reponse = $this->requete()->post($this->url('/stacks'), [
+            'stack_name' => $nom,
+            'disable_rollback' => true,
+            'template' => $template,
+        ]);
+
+        if ($reponse->failed()) {
+            throw new RuntimeException("Heat a refusé la création de la stack {$nom} : ".$reponse->body());
+        }
+
+        return ['id' => $reponse->json('stack.id')];
+    }
+
+    /**
+     * @return array{statut: string, raison: ?string, sorties: array<string, mixed>}
+     */
+    public function etatStack(string $nom, string $id): array
+    {
+        $reponse = $this->requete()->get($this->url("/stacks/{$nom}/{$id}"));
+
+        if ($reponse->failed()) {
+            throw new RuntimeException("Impossible de lire l'état de la stack {$nom} : ".$reponse->body());
+        }
+
+        $sorties = [];
+        foreach ($reponse->json('stack.outputs') ?? [] as $sortie) {
+            $sorties[$sortie['output_key']] = $sortie['output_value'];
+        }
+
+        return [
+            'statut' => $reponse->json('stack.stack_status'),
+            'raison' => $reponse->json('stack.stack_status_reason'),
+            'sorties' => $sorties,
+        ];
+    }
+
+    public function supprimerStack(string $nom, string $id): void
+    {
+        $reponse = $this->requete()->delete($this->url("/stacks/{$nom}/{$id}"));
+
+        // 404 : déjà supprimée (idempotent, pas une erreur pour nous).
+        if ($reponse->failed() && $reponse->status() !== 404) {
+            throw new RuntimeException("Heat a refusé la suppression de la stack {$nom} : ".$reponse->body());
+        }
+    }
+
+    private function requete()
+    {
+        return Http::withHeaders(['X-Auth-Token' => $this->auth->jeton()]);
+    }
+
+    private function url(string $chemin): string
+    {
+        return config('openstack.heat_url').'/'.$this->auth->projetId().$chemin;
+    }
+}