From fd15f05b7a89c364e51f1adb269dc365cfa46732 Mon Sep 17 00:00:00 2001
From: sorcier <sorcier@sorcier-research.com>
Date: Fri, 6 Nov 2026 02:41:53 +0100
Subject: [PATCH] docs(cluster): clarify SIP registration vs BLF subscription
 timer in HA settings

---
 public/index.php        | 16 +++++++++++-----
 src/ConfigGenerator.php |  4 ++--
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/public/index.php b/public/index.php
index 3f70a9c..603957d 100644
--- a/public/index.php
+++ b/public/index.php
@@ -2945,15 +2945,21 @@ $isDevEnv = file_exists(__DIR__ . '/../.dev')
                                     </div>
                                 </div>
 
-                                <!-- DÉLAI D'EXPIRATION / RÉABONNEMENT BLF (HA) -->
+                                <!-- DÉLAI D'EXPIRATION / RÉENREGISTREMENT POSTES (REGISTER HA) -->
                                 <div id="cluster-blf-expiry-container" class="hidden p-3.5 rounded-xl bg-anthracite-900/80 border border-cyan-500/30 space-y-1">
                                     <div class="flex flex-col sm:flex-row sm:items-center justify-between gap-3">
-                                        <div>
+                                        <div class="space-y-1">
                                             <div class="flex items-center gap-2 mb-0.5">
-                                                <label for="cluster-blf-expiry" class="text-xs font-bold text-white cursor-pointer">Fréquence de réabonnement BLF &amp; Postes</label>
-                                                <span class="px-2 py-0.2 rounded text-[10px] font-bold bg-cyan-500/20 text-cyan-300 border border-cyan-500/30">Recommandé HA : 120s</span>
+                                                <label for="cluster-blf-expiry" class="text-xs font-bold text-white cursor-pointer">Intervalle de réenregistrement des Postes (REGISTER)</label>
+                                                <span class="px-2 py-0.5 rounded text-[10px] font-bold bg-cyan-500/20 text-cyan-300 border border-cyan-500/30">Recommandé HA : 120s</span>
                                             </div>
-                                            <p class="text-[11px] text-slate-400">Plafond d'expiration imposé aux téléphones pour forcer le rafraîchissement rapide des voyants BLF après bascule HA (par défaut 1800s sans HA, 120s avec HA).</p>
+                                            <p class="text-[11px] text-slate-400 leading-relaxed">
+                                                Plafond d'expiration imposé aux téléphones pour le renouvellement de leur enregistrement SIP (<code class="text-cyan-300 font-mono text-[10px]">REGISTER</code>). En cas de bascule HA, ce délai force les postes à se réenregistrer rapidement sur le serveur actif (ex. toutes les 60s pour un plafond de 120s) afin de rétablir les appels entrants et sortants sans attendre (par défaut 1800s sans HA).
+                                            </p>
+                                            <p class="text-[10px] text-amber-400/90 leading-normal flex items-start gap-1.5 pt-0.5">
+                                                <span class="text-xs">ℹ️</span>
+                                                <span><strong>Voyants BLF (<code class="text-amber-300 font-mono text-[10px]">SUBSCRIBE</code>) :</strong> Ce paramètre ne gère pas les touches BLF. La fréquence de rafraîchissement des touches de supervision est décidée directement par le téléphone lui-même (ex. paramètre Yealink <code class="text-amber-300 font-mono text-[10px]">account.X.blf.subscribe_period = 120</code>).</span>
+                                            </p>
                                         </div>
                                         <div class="flex items-center gap-2 shrink-0">
                                             <input type="number" id="cluster-blf-expiry" name="blf_expiry" value="120" min="30" max="3600"
diff --git a/src/ConfigGenerator.php b/src/ConfigGenerator.php
index a4899d2..6c95c72 100644
--- a/src/ConfigGenerator.php
+++ b/src/ConfigGenerator.php
@@ -195,8 +195,8 @@ class ConfigGenerator
             $clusterSt = $this->db->query('SELECT enabled, blf_expiry FROM cluster_settings WHERE id = 1')->fetch(PDO::FETCH_ASSOC) ?: [];
         } catch (\Throwable $e) {}
         $isHaActive    = !empty($clusterSt['enabled']);
-        // En mode Haute Disponibilité, on plafonne l'expiration des AOR/souscriptions sur la valeur configurée (par défaut 120s)
-        // afin que les téléphones se réabonnent très vite en cas de bascule. Sans HA, on conserve le standard 1800s (30 min).
+        // En mode Haute Disponibilité, on plafonne l'expiration d'enregistrement des AOR (REGISTER) sur la valeur configurée (par défaut 120s)
+        // afin que les téléphones se réenregistrent très vite en cas de bascule HA. Sans HA, on conserve le standard 1800s (30 min).
         $regExpiration = $isHaActive ? max(30, min(3600, (int)($clusterSt['blf_expiry'] ?? 120))) : 1800;
         $subMinExpiry  = $isHaActive ? 30 : 0;