v2026.5.38 — Attribution auteur + nettoyage + observabilité (LOG unifié, handlers globaux d'erreur, toggle logs verbeux dans admin)

viewer.js

@@ -1,3 +1,17 @@
+/**
+ * Planification — Extension navigateur EasyVista (Canton de Vaud / DGNSI)
+ *
+ * Vue claire et rapide du planning des techniciens : interventions,
+ * réservations, absences, statut pompier, etc. Regroupé par tech avec
+ * timelines visuelles et popups détaillés.
+ *
+ * Copyright (c) 2026 Quentin Rouiller
+ * Licensed under the MIT License — see LICENSE file in the project root.
+ *
+ * @author Quentin Rouiller
+ * @repository https://gitea.netaplaid.ch/FroSteel/Planification
+ */
+
 // ============================================================================
 // viewer.js — vue claire du planning techniciens
 // ============================================================================
@@ -16,6 +30,121 @@
 // pas perdu.
 // ============================================================================
 
+// ============================================================================
+// v2026.5.38 : Observabilité — logger unifié + handlers globaux
+// ============================================================================
+// Toutes les erreurs runtime (uncaught + unhandled rejection) sont attrapées
+// par les listeners ci-dessous et loggées avec un préfix clair, un timestamp,
+// et la stack trace si dispo. L'idée : qd l'user lance F12 et copie la console,
+// on a tout pour reproduire et corriger.
+//
+// Format des logs : [PREFIX][LEVEL] message {context}
+//   - LEVEL : INFO / WARN / ERROR
+//   - PREFIX : module qui logue (load, currentUser, session, viewMode, ...)
+//   - message : un truc lisible humain
+//   - context : objet sérialisable avec les vars utiles au debug
+// ============================================================================
+
+// Clef localStorage pour le mode debug — exposé dans le panel admin.
+// Quand activé : LOG.info() devient visible. Sinon : muet.
+// LOG.warn et LOG.error sont TOUJOURS visibles, peu importe le flag.
+const DEBUG_LOGS_KEY = "debug_logs";
+
+const LOG = (() => {
+  // On capture la version du manifest une fois, pour la mettre dans les logs
+  // d'erreur (utile qd l'user nous envoie un screenshot console).
+  let _version = "?";
+  try {
+    if (chrome && chrome.runtime && chrome.runtime.getManifest) {
+      _version = chrome.runtime.getManifest().version || "?";
+    }
+  } catch (e) {
+    // chrome.runtime peut ne pas être dispo dans certains contextes
+  }
+
+  // État debug — relu depuis localStorage. Peut être toggle à la volée
+  // depuis le panel admin sans reload.
+  let _debug = false;
+  try {
+    _debug = localStorage.getItem(DEBUG_LOGS_KEY) === "1";
+  } catch (e) {
+    // localStorage peut être bloqué (mode privé) — on reste en mode normal
+  }
+
+  const _stamp = () => new Date().toISOString().substring(11, 23); // HH:MM:SS.mmm
+
+  const _format = (level, prefix, msg, ctx) => {
+    const head = `[${_stamp()}][v${_version}][${prefix}][${level}]`;
+    if (ctx !== undefined) return [head, msg, ctx];
+    return [head, msg];
+  };
+
+  return {
+    // info() : visible UNIQUEMENT si debug activé. Pour les étapes verbose.
+    info: (prefix, msg, ctx) => {
+      if (!_debug) return;
+      console.log(..._format("INFO", prefix, msg, ctx));
+    },
+    // warn / error : toujours visibles
+    warn: (prefix, msg, ctx)  => console.warn (..._format("WARN",  prefix, msg, ctx)),
+    error:(prefix, msg, ctx)  => console.error(..._format("ERROR", prefix, msg, ctx)),
+    // Erreur "interne" — affiche stack + serialize l'objet erreur
+    exception: (prefix, msg, err, extra) => {
+      const ctx = {
+        name:    err && err.name,
+        message: err && err.message,
+        stack:   err && err.stack,
+        extra:   extra
+      };
+      console.error(..._format("ERROR", prefix, msg, ctx));
+    },
+    // Toggle à la volée depuis le panel admin
+    setDebug: (on) => {
+      _debug = !!on;
+      try { localStorage.setItem(DEBUG_LOGS_KEY, _debug ? "1" : "0"); } catch (e) {}
+      // Synchroniser avec le service worker (qui a son propre flag)
+      try {
+        chrome.runtime.sendMessage({ type: "setDebugLogs", on: _debug }, () => {
+          // on ignore lastError volontairement : le SW peut être en sommeil
+          if (chrome.runtime.lastError) { /* ok */ }
+        });
+      } catch (e) {}
+      console.log(..._format("INFO", "logger", `mode debug = ${_debug ? "ON" : "OFF"}`));
+    },
+    isDebug: () => _debug,
+    version: () => _version
+  };
+})();
+
+// Global error handler : attrape les exceptions qui passent à travers tous les
+// try/catch. L'user voit un toast, on logue tout en console.
+window.addEventListener("error", (event) => {
+  LOG.exception("global", "uncaught error",
+    event.error || new Error(event.message || "unknown"),
+    { filename: event.filename, lineno: event.lineno, colno: event.colno });
+  // Toast non-bloquant — on suppose que showToast est dispo (init en haut)
+  try {
+    if (typeof showToast === "function") {
+      showToast("Erreur inattendue", "Voir la console (F12) pour le détail");
+    }
+  } catch (e) { /* showToast peut ne pas être init au tout début */ }
+});
+
+// Promesses rejetées sans .catch() — typiquement des async/await sans try
+window.addEventListener("unhandledrejection", (event) => {
+  const reason = event.reason;
+  LOG.exception("global", "unhandled promise rejection",
+    reason instanceof Error ? reason : new Error(String(reason)),
+    { promise: "unhandled" });
+  try {
+    if (typeof showToast === "function") {
+      showToast("Erreur asynchrone", "Voir la console (F12) pour le détail");
+    }
+  } catch (e) { /* idem */ }
+});
+
+LOG.info("boot", "viewer.js chargé", { version: LOG.version() });
+
 // ============================================================================
 // Configuration
 // ============================================================================
@@ -241,7 +370,6 @@ async function init() {
   initAppFooter();        // v4.2.9 : pied de page discret bas-droite
   initAppClock();         // v5.0.0 : horloge HH:MM au milieu topbar
   _applyViewMode();       // v2026.5.32 : appliquer la vue sauvegardée
-  initAdminMenu();        // v5.0.0 : menu admin caché (5 clics sur titre)
   initSessionTimer();     // v5.0.9 : compteur de session EV (tick 1s)
   initDateCustomPicker(); // v2026.5.17 : faux input date avec jour
 
@@ -341,6 +469,11 @@ let _currentUserRetryCount = 0;
 const _CURRENT_USER_MAX_RETRIES = 10;
 const _CURRENT_USER_RETRY_DELAY_MS = 60 * 1000;
 
+/**
+ * Récupère le nom de l'utilisateur EasyVista connecté et l'affiche dans le badge.
+ *
+ * @author Quentin Rouiller
+ */
 async function fetchAndShowCurrentUser() {
   const attemptId = _currentUserRetryCount + 1;
   console.log(`[currentUser] tentative ${attemptId}/${_CURRENT_USER_MAX_RETRIES + 1} de fetchCurrentUser`);
@@ -425,6 +558,8 @@ async function fetchAndShowCurrentUser() {
  *  - un retry est déjà en cours (évite les doublons)
  *
  * @param {string} reason - contexte pour les logs (ex: "after_load_success")
+ *
+ * @author Quentin Rouiller
  */
 function _maybeRetryFetchUser(reason) {
   if (state.currentUser && state.currentUser.name) {
@@ -547,6 +682,15 @@ function toggleUserNamePopup() {
   });
   popup.appendChild(settingsBtn);
 
+  // v2026.5.38 : signature auteur en bas du popup user-badge
+  // Style : même look que le footer "QRO/vX.Y.Z" en bas à droite — petit,
+  // gris atténué, séparé par une fine ligne supérieure.
+  const authorLine = document.createElement("div");
+  authorLine.className = "user-name-popup-author";
+  authorLine.textContent = "Développé par Quentin Rouiller";
+  authorLine.title = "Auteur de l'extension";
+  popup.appendChild(authorLine);
+
   popup.classList.remove("hidden");
   badge.classList.add("open");
   // Positionne juste en dessous de la pastille
@@ -1006,6 +1150,11 @@ function initModalScrollLock() {
 
 // v4.2.9 : pied de page discret "QRO / vX.X.X" en bas à droite.
 // La version est lue depuis le manifest (source unique de vérité).
+/**
+ * Pied de page discret bas-droite avec QRO et numéro de version.
+ *
+ * @author Quentin Rouiller
+ */
 function initAppFooter() {
   if (document.querySelector(".app-footer")) return;
   let version = "";
@@ -1013,7 +1162,9 @@ function initAppFooter() {
     const manifest = chrome && chrome.runtime && chrome.runtime.getManifest
       ? chrome.runtime.getManifest() : null;
     if (manifest && manifest.version) version = "v" + manifest.version;
-  } catch (e) {}
+  } catch (e) {
+    LOG.warn("footer", "getManifest indispo (mode dégradé sans version)", { err: e && e.message });
+  }
   const el = document.createElement("div");
   el.className = "app-footer";
   el.textContent = `QRO${version ? " / " + version : ""}`;
@@ -1036,7 +1187,10 @@ function _getCurrentView() {
 function _setCurrentView(mode) {
   try {
     localStorage.setItem(VIEW_MODE_KEY, mode === "horizontal" ? "horizontal" : "classic");
-  } catch (e) {}
+  } catch (e) {
+    // localStorage peut être bloqué (mode privé Firefox, quota plein)
+    LOG.warn("viewMode", "localStorage indispo, vue non persistée", { err: e && e.message });
+  }
   _applyViewMode();
 }
 
@@ -1066,11 +1220,14 @@ function _toggleView() {
  * On mémorise les parents d'origine sur chaque élément (data-orig-parent)
  * pour restaurer proprement en vue classique.
  *
- * Logs [viewMode] pour debug.
+ * v2026.5.38 : on ne log plus que les warnings (parent absent etc.) — les
+ * logs verbeux étape par étape ont été retirés, ils polluaient la console
+ * à chaque toggle.
+ *
+ * @author Quentin Rouiller
  */
 function _applyViewMode() {
   const mode = _getCurrentView();
-  console.log(`[viewMode] application de la vue : ${mode}`);
 
   // Mettre à jour la classe sur <html> pour les règles CSS
   document.documentElement.classList.remove("view-classic", "view-horizontal");
@@ -1102,12 +1259,13 @@ function _applyViewMode() {
     _restoreElementsToTopbar(ELEMENTS_TO_RELOCATE);
   }
 
-  console.log(`[viewMode] application terminée (mode=${mode})`);
 }
 
 /**
  * v2026.5.36 : crée ou retrouve la sidebar, et y déplace les éléments listés.
  * Les éléments sont déplacés dans l'ordre du tableau.
+ *
+ * @author Quentin Rouiller
  */
 function _moveElementsToSidebar(ids) {
   // Créer (ou retrouver) le wrapper qui contiendra sidebar + main côte à côte
@@ -1121,7 +1279,6 @@ function _moveElementsToSidebar(ids) {
     if (mainEl && mainEl.parentNode) {
       mainEl.parentNode.insertBefore(wrapper, mainEl);
       wrapper.appendChild(mainEl);
-      console.log("[viewMode] wrapper créé, <main> encapsulé");
     } else {
       console.warn("[viewMode] <main> introuvable, wrapper ajouté à <body>");
       document.body.appendChild(wrapper);
@@ -1135,7 +1292,6 @@ function _moveElementsToSidebar(ids) {
     sidebar.id = "horizontal-sidebar";
     sidebar.className = "horizontal-sidebar";
     wrapper.insertBefore(sidebar, wrapper.firstChild);
-    console.log("[viewMode] sidebar créée et insérée en tête du wrapper");
   } else if (sidebar.parentNode !== wrapper) {
     // Sidebar existe ailleurs, on la remet dans le wrapper
     wrapper.insertBefore(sidebar, wrapper.firstChild);
@@ -1151,7 +1307,6 @@ function _moveElementsToSidebar(ids) {
   if (dateNav) {
     _memorizeOriginalParent(dateNav);
     sidebar.appendChild(dateNav);
-    console.log("[viewMode] déplacé dans sidebar : .date-nav");
 
     // Créer le wrapper des flèches si pas déjà fait, et y mettre prev + next
     let arrowsWrap = document.getElementById("sidebar-arrows");
@@ -1159,7 +1314,6 @@ function _moveElementsToSidebar(ids) {
       arrowsWrap = document.createElement("div");
       arrowsWrap.id = "sidebar-arrows";
       sidebar.appendChild(arrowsWrap);
-      console.log("[viewMode] wrapper flèches #sidebar-arrows créé");
     }
     const prevBtn = document.getElementById("nav-prev");
     const nextBtn = document.getElementById("nav-next");
@@ -1178,18 +1332,18 @@ function _moveElementsToSidebar(ids) {
     if (id === "date-nav") continue; // déjà traité
     const el = document.getElementById(id);
     if (!el) {
-      console.log(`[viewMode] élément #${id} introuvable (optionnel) — skip`);
       continue;
     }
     _memorizeOriginalParent(el);
     sidebar.appendChild(el);
-    console.log(`[viewMode] déplacé dans sidebar : #${id}`);
   }
 }
 
 /**
  * v2026.5.36 : restaure chaque élément à son parent d'origine (mémorisé dans
  * data-orig-parent). Utilisé quand on revient en vue classique.
+ *
+ * @author Quentin Rouiller
  */
 function _restoreElementsToTopbar(ids) {
   // v2026.5.37 : d'abord remettre les flèches dans .date-nav (avant de
@@ -1216,7 +1370,6 @@ function _restoreElementsToTopbar(ids) {
   const arrowsWrap = document.getElementById("sidebar-arrows");
   if (arrowsWrap) {
     arrowsWrap.remove();
-    console.log("[viewMode] wrapper #sidebar-arrows supprimé");
   }
 
   // Restaurer .date-nav à son parent d'origine
@@ -1233,7 +1386,6 @@ function _restoreElementsToTopbar(ids) {
   const sidebar = document.getElementById("horizontal-sidebar");
   if (sidebar && sidebar.children.length === 0) {
     sidebar.remove();
-    console.log("[viewMode] sidebar supprimée (vide)");
   }
 
   // Sortir <main> du wrapper et supprimer le wrapper
@@ -1242,10 +1394,8 @@ function _restoreElementsToTopbar(ids) {
     const mainEl = wrapper.querySelector("#main");
     if (mainEl && wrapper.parentNode) {
       wrapper.parentNode.insertBefore(mainEl, wrapper);
-      console.log("[viewMode] <main> restauré hors du wrapper");
     }
     wrapper.remove();
-    console.log("[viewMode] wrapper supprimé");
   }
 }
 
@@ -1271,7 +1421,6 @@ function _memorizeOriginalParent(el) {
 function _restoreToOriginalParent(el, label) {
   const orig = el.dataset.origParent;
   if (!orig) {
-    console.log(`[viewMode] ${label} n'a pas de parent d'origine mémorisé — skip`);
     return;
   }
   let parent = null;
@@ -1292,13 +1441,17 @@ function _restoreToOriginalParent(el, label) {
   } else {
     parent.appendChild(el);
   }
-  console.log(`[viewMode] restauré à ${orig} : ${label}`);
 }
 
 // v5.0.0 : horloge HH:MM au milieu de la topbar. Mise à jour toutes les 30s
 // (les secondes ne sont pas affichées donc pas besoin d'un tick plus rapide).
 // v2026.5.27 : date courte "Jeudi 23.04.26" sur la même ligne que l'heure,
 // séparées par un gros point "•", même taille que l'heure.
+/**
+ * Horloge HH:MM au milieu de la topbar, mise à jour chaque minute (depuis v5.0.0).
+ *
+ * @author Quentin Rouiller
+ */
 function initAppClock() {
   const el = document.getElementById("app-clock");
   if (!el) return;
@@ -1406,14 +1559,8 @@ function updateNowLine() {
 }
 
 // v5.0.0 : menu admin caché via 5 clics sur le titre "Planification".
-// v2026.5.25 : SUPPRIMÉ — l'accès au panneau admin se fait désormais via le
+// v2026.5.38 : initAdminMenu() retiré — l'accès admin passe maintenant par le
 // bouton "⚙ Paramètres" du popup user-badge (clic sur les initiales).
-function initAdminMenu() {
-  const title = document.getElementById("app-title");
-  if (!title) return;
-  title.style.cursor = "default";
-  // Plus de handler de clic : les 5 clics n'ouvrent plus rien.
-}
 
 // ============================================================================
 // v5.0.9 : Surveillance du timeout de session EasyVista
@@ -1515,7 +1662,7 @@ function updateSessionIndicator() {
         state.sessionExpireAt = Date.now() + resp.remainingMs;
         updateSessionIndicator();
       }
-    }).catch(() => {});
+    }).catch(e => LOG.warn("session", "getSessionRemaining a échoué (silencieux)", { err: e && e.message }));
     // En attendant, on continue avec l'estimation locale
   }
 
@@ -1542,7 +1689,9 @@ function updateSessionIndicator() {
   `;
   const extendBtn = el.querySelector(".session-extend-btn");
   if (extendBtn) {
-    extendBtn.onclick = async () => {
+    // v2026.5.38 : addEventListener plutôt que .onclick — meilleur tracage
+    // si plus tard on veut detach le handler proprement.
+    extendBtn.addEventListener("click", async () => {
       extendBtn.disabled = true;
       extendBtn.textContent = "…";
       try {
@@ -1563,7 +1712,7 @@ function updateSessionIndicator() {
           handleSessionExpired();
         }
       }
-    };
+    });
   }
 
   // v2026.5.17 : si le popup user-badge est ouvert, rafraîchir la ligne "Session : MM:SS"
@@ -2230,8 +2379,8 @@ function renderAdminSectionDiagnostics(container, cfg, saveFn) {
   h.className = "admin-section-title";
   container.appendChild(h);
 
-  const version = (chrome && chrome.runtime && chrome.runtime.getManifest)
-    ? chrome.runtime.getManifest().version : "?";
+  // v2026.5.38 : on passe par LOG.version() qui a déjà gardé une copie au boot
+  const version = LOG.version();
 
   const info = document.createElement("div");
   info.className = "admin-diag-grid";
@@ -2244,6 +2393,27 @@ function renderAdminSectionDiagnostics(container, cfg, saveFn) {
   `;
   container.appendChild(info);
 
+  // v2026.5.38 : toggle "Logs verbeux (debug)" — par défaut OFF.
+  // Quand activé : LOG.info() devient visible dans la console (étapes
+  // détaillées loadForDate, fetch, render, etc.). LOG.warn et LOG.error
+  // restent toujours visibles peu importe ce flag.
+  const debugRow = document.createElement("label");
+  debugRow.className = "admin-debug-row";
+  debugRow.style.cssText = "display:flex; align-items:center; gap:10px; margin-top:16px; padding:10px; background:var(--bg-muted); border-radius:6px; cursor:pointer;";
+  const debugCheckbox = document.createElement("input");
+  debugCheckbox.type = "checkbox";
+  debugCheckbox.checked = LOG.isDebug();
+  const debugText = document.createElement("div");
+  debugText.style.cssText = "flex:1;";
+  debugText.innerHTML = `<strong>Logs verbeux (debug)</strong><div style="font-size:12px; color:var(--text-faint); margin-top:2px;">Affiche les étapes détaillées dans la console (F12). À activer si tu veux signaler un bug avec un max de contexte.</div>`;
+  debugRow.appendChild(debugCheckbox);
+  debugRow.appendChild(debugText);
+  debugCheckbox.addEventListener("change", () => {
+    LOG.setDebug(debugCheckbox.checked);
+    showToast("Debug logs", debugCheckbox.checked ? "ACTIVÉ — voir console F12" : "désactivé");
+  });
+  container.appendChild(debugRow);
+
   // Bouton reset
   const resetBtn = document.createElement("button");
   resetBtn.type = "button";
@@ -2797,15 +2967,46 @@ function isoToUnixDate(iso) {
 // Messages → background
 // ============================================================================
 
+// v2026.5.38 : timeout sur sendMessage. En MV3 le service worker peut être
+// endormi/relancé : si un handler async oublie d'appeller sendResponse, le
+// port reste ouvert et notre Promise pend pour toujours. On force un timeout
+// (defaut 15s) qui rejette proprement avec un message clair.
+const _SENDMESSAGE_TIMEOUT_MS = 15000;
+
 function sendMessage(msg) {
   return new Promise((resolve, reject) => {
-    chrome.runtime.sendMessage(msg, (response) => {
-      if (chrome.runtime.lastError) {
-        reject(new Error(chrome.runtime.lastError.message));
-        return;
-      }
-      resolve(response || {});
-    });
+    let settled = false;
+    const t0 = performance.now();
+
+    const timer = setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      const dur = Math.round(performance.now() - t0);
+      LOG.error("sendMessage", `timeout après ${dur}ms (background ne répond pas)`, { type: msg && msg.type });
+      reject(new Error(`sendMessage timeout (${msg && msg.type || "?"})`));
+    }, _SENDMESSAGE_TIMEOUT_MS);
+
+    try {
+      chrome.runtime.sendMessage(msg, (response) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        if (chrome.runtime.lastError) {
+          const dur = Math.round(performance.now() - t0);
+          LOG.warn("sendMessage", "lastError", { type: msg && msg.type, err: chrome.runtime.lastError.message, durMs: dur });
+          reject(new Error(chrome.runtime.lastError.message));
+          return;
+        }
+        resolve(response || {});
+      });
+    } catch (e) {
+      // chrome.runtime.sendMessage peut throw direct si extension contexte invalide
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      LOG.exception("sendMessage", "throw synchrone", e, { type: msg && msg.type });
+      reject(e);
+    }
   });
 }
 
@@ -2819,16 +3020,68 @@ async function readCache(isoDate) {
   return obj[key] || null;
 }
 
+// v2026.5.38 : on attrape spécifiquement les QUOTA_BYTES dépassés. Quand le
+// cache local explose (~10 Mo), Chrome rejette le set avec un message qui
+// contient "QUOTA". On essaie alors de purger les vieilles entrées et on
+// re-tente une fois.
 async function writeCache(isoDate, data) {
   const key = CACHE_PREFIX + isoDate;
-  await chrome.storage.local.set({ [key]: { ...data, savedAt: Date.now() } });
+  const payload = { ...data, savedAt: Date.now() };
+  try {
+    await chrome.storage.local.set({ [key]: payload });
+  } catch (e) {
+    const msg = (e && e.message) || String(e);
+    if (msg.toUpperCase().includes("QUOTA")) {
+      LOG.warn("cache", "quota dépassé, tentative de purge des vieilles entrées", { key });
+      try {
+        await _purgeOldCacheEntries();
+        await chrome.storage.local.set({ [key]: payload });
+        LOG.info("cache", "écriture OK après purge", { key });
+        return;
+      } catch (e2) {
+        LOG.exception("cache", "écriture échouée même après purge", e2, { key });
+        if (typeof showToast === "function") {
+          showToast("Cache plein", "Les données ne sont pas mises en cache");
+        }
+        return;
+      }
+    }
+    LOG.exception("cache", "écriture échouée", e, { key });
+  }
+}
+
+// Purge les entrées de cache plus vielles que 7 jours (best-effort).
+async function _purgeOldCacheEntries() {
+  const all = await chrome.storage.local.get(null);
+  const now = Date.now();
+  const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
+  const toRemove = [];
+  for (const k of Object.keys(all)) {
+    if (!k.startsWith(CACHE_PREFIX)) continue;
+    const v = all[k];
+    if (v && typeof v.savedAt === "number" && (now - v.savedAt) > SEVEN_DAYS_MS) {
+      toRemove.push(k);
+    }
+  }
+  if (toRemove.length > 0) {
+    await chrome.storage.local.remove(toRemove);
+    LOG.info("cache", `purgé ${toRemove.length} entrée(s) > 7 jours`, { keys: toRemove });
+  }
 }
 
 // ============================================================================
 // Flux principal : charger une date
 // ============================================================================
 
+/**
+ * Charge le planning pour la date donnée (fetch XML EasyVista + cache).
+ *
+ * @author Quentin Rouiller
+ */
 async function loadForDate(isoDate, opts = {}) {
+  LOG.info("load", `début pour ${isoDate}`, { opts, hasSession: !!state.session });
+  const _t0 = performance.now();
+
   // v4.3.1 : changer de date fermait tous les popups épinglés.
   // v2026.5.17 : les popups épinglés restent maintenant ouverts entre dates,
   //              avec les données qu'ils avaient au moment de l'épinglage.
@@ -2965,7 +3218,8 @@ async function loadForDate(isoDate, opts = {}) {
               source: "fresh",
               lastRefreshKind: activeRefreshButton
             });
-            writeCache(isoDate, { techs: merged.techs }).catch(() => {});
+            writeCache(isoDate, { techs: merged.techs })
+              .catch(e => LOG.warn("cache", "writeCache fail (disappear-analysis)", { err: e && e.message }));
           }
         })
         .catch(err => console.error("[disappear-analysis]", err));
@@ -3885,7 +4139,8 @@ async function refreshStatuses(techs, isoDate, opts = {}) {
     // Si annulé : on laisse les résultats partiels dans le DOM et on sauve
     // quand même ce qu'on a déjà récupéré (cache incrémental).
     if (isRefreshAborted(myToken)) {
-      try { await writeCache(isoDate, { techs }); } catch {}
+      try { await writeCache(isoDate, { techs }); }
+      catch (e) { LOG.warn("cache", "writeCache fail (after abort)", { err: e && e.message }); }
       return;
     }
 
@@ -4360,7 +4615,11 @@ function parseTimelineJsonForAction(jsonText, actionId) {
     let extra;
     try {
       extra = JSON.parse(extraRaw);
-    } catch {
+    } catch (e) {
+      // v2026.5.38 : on logue le contenu (tronqué) pour pouvoir reproduire
+      // qd le serveur EV renvoie du JSON cassé (ça arrive après MAJ EV).
+      LOG.warn("timeline", "JSON.parse failed sur extraRaw",
+        { snippet: extraRaw.substring(0, 120), err: e && e.message });
       continue;
     }
 
@@ -4700,21 +4959,48 @@ function showAbortToast() {
 }
 
 function renderFromData(data) {
-  state.currentData = data;
-  document.getElementById("loading").classList.add("hidden");
-  document.getElementById("error-box").classList.add("hidden");
-  document.getElementById("session-needed").classList.add("hidden");
-  document.getElementById("cards").classList.remove("hidden");
+  // v2026.5.38 : on wrappe tout le rendu dans un try/catch global. Si l'une
+  // des étapes plante (ex: tech sans interventions, données XML cassées),
+  // on logue tout et on affiche un message à l'user au lieu de laisser un
+  // écran blanc.
+  const _tStart = performance.now();
+  LOG.info("render", "renderFromData début",
+    { date: data && data.targetDate, source: data && data.source, techsCount: data && data.techs && data.techs.length });
+  try {
+    state.currentData = data;
 
-  // v4.3.0 : détecter les conflits d'horaire entre interventions d'un même
-  // tech (même heure de début OU chevauchement).
-  detectOverlaps(data.techs);
+    // Null checks défensifs sur les éléments UI critiques
+    const elLoading       = document.getElementById("loading");
+    const elErrorBox      = document.getElementById("error-box");
+    const elSessionNeeded = document.getElementById("session-needed");
+    const elCards         = document.getElementById("cards");
+    if (!elLoading || !elErrorBox || !elSessionNeeded || !elCards) {
+      LOG.error("render", "éléments DOM manquants",
+        { loading: !!elLoading, errorBox: !!elErrorBox, sessionNeeded: !!elSessionNeeded, cards: !!elCards });
+      return;
+    }
+    elLoading.classList.add("hidden");
+    elErrorBox.classList.add("hidden");
+    elSessionNeeded.classList.add("hidden");
+    elCards.classList.remove("hidden");
 
-  // Calculer les stats
-  const stats = computeStats(data.techs, data.targetDate);
-  renderCaptureInfo(data, stats);
-  renderStats(stats);
-  renderCards(data);
+    // v4.3.0 : détecter les conflits d'horaire entre interventions d'un même
+    // tech (même heure de début OU chevauchement).
+    detectOverlaps(data.techs);
+
+    // Calculer les stats
+    const stats = computeStats(data.techs, data.targetDate);
+    renderCaptureInfo(data, stats);
+    renderStats(stats);
+    renderCards(data);
+    LOG.info("render", "renderFromData OK", { ms: Math.round(performance.now() - _tStart) });
+  } catch (err) {
+    LOG.exception("render", "renderFromData a planté",
+      err, { date: data && data.targetDate, techsCount: data && data.techs && data.techs.length });
+    if (typeof showError === "function") {
+      showError("Erreur d'affichage : " + (err.message || "voir console F12"));
+    }
+  }
 }
 
 // v4.3.0 : détection des conflits d'horaire entre interventions d'un même tech.
@@ -4943,6 +5229,11 @@ function isPillonelAbsentFriday(tech, isoDate) {
   return d.getDay() === 5;
 }
 
+/**
+ * Construit la card HTML d'un technicien (header, timeline, interventions, absences).
+ *
+ * @author Quentin Rouiller
+ */
 function buildCard(tech, isoDate) {
   const card = document.createElement("section");
   card.className = "card";
@@ -5358,6 +5649,11 @@ function getStatusClass(iv) {
   return null;
 }
 
+/**
+ * Lie les segments timeline à un popover persistant au clic (depuis v4.2.3).
+ *
+ * @author Quentin Rouiller
+ */
 function bindTimelinePopover(el) {
   // v2026.5.33 : en vue horizontale, les interactions sont différentes :
   //   - hover   : ouvre directement la GRANDE popup (pas la petite)
@@ -5512,6 +5808,11 @@ function findIvByActionId(actionId) {
 //
 // v2026.5.34 : utilise positionTooltipAnchored() unifié au lieu de recalculer
 // sa propre position. Plus de code dupliqué.
+/**
+ * Ouvre une grande popup détaillée pour un segment timeline.
+ *
+ * @author Quentin Rouiller
+ */
 function openPersistentTimelinePopup(el) {
   if (!el) {
     console.warn("[persistentTimeline] segment el null — abandon");
@@ -6739,6 +7040,11 @@ let bulleState = {
   hideTimer: null
 };
 
+/**
+ * Affiche un tooltip au survol d'une intervention/réservation.
+ *
+ * @author Quentin Rouiller
+ */
 function showTooltip(e, iv, rowEl) {
   // v2026.5.19 : pendant qu'un popup épinglé est en cours de drag, on ignore
   // les mouseenter sur les cartes — sinon en survolant une carte on déclenche
@@ -6973,6 +7279,8 @@ function reapplyTooltipPosition() {
  *
  * @param {HTMLElement} sourceEl - l'élément déclencheur (row, card, segment)
  * @param {object} opts - options { anchorBelow: true pour préférer dessous }
+ *
+ * @author Quentin Rouiller
  */
 function positionTooltipAnchored(sourceEl, opts) {
   opts = opts || {};
@@ -7110,6 +7418,8 @@ function _rectsOverlap(a, b) {
  * Cherche une position libre pour un popup de dimensions {w, h} près de la
  * ligne source `rowEl`. Essaie dans l'ordre : droite, gauche, dessous, dessus.
  * Retourne {x, y} en coordonnées document, ou null si aucune position libre.
+ *
+ * @author Quentin Rouiller
  */
 function _findFreePopupPosition(rowEl, w, h) {
   const pad = 14;
@@ -7215,6 +7525,8 @@ function _findFreePopupPosition(rowEl, w, h) {
 /**
  * v4.3.0 : épingle la bulle courante en la clonant dans un popup détaché
  * ancré au contenu. Le tooltip live redevient disponible.
+ *
+ * @author Quentin Rouiller
  */
 function pinTooltip() {
   if (!state.currentTooltipIv) return;
@@ -7567,6 +7879,8 @@ async function _refreshPinnedPopupIv(popup, iv) {
  * ré-épingler, ou cliquer ailleurs pour s'en débarrasser normalement.
  *
  * @param {HTMLElement} el - le popup à désépingler
+ *
+ * @author Quentin Rouiller
  */
 function _softUnpinPopup(el) {
   if (!el) {
@@ -8048,6 +8362,8 @@ function _getPopupSafeArea() {
  * v2026.5.20 : contraint un popup flottant (en coords document via style.left/top)
  * dans la safe area. Appelé à l'épinglage, pendant le drag, et quand le dock
  * apparaît/disparaît.
+ *
+ * @author Quentin Rouiller
  */
 function _clampPopupInSafeArea(popup) {
   if (!popup) return;
@@ -8840,7 +9156,7 @@ function bindTooltipInteractions() {
             btn.classList.remove("copied");
             btn.textContent = original;
           }, 1200);
-        }).catch(() => {});
+        }).catch(e => LOG.warn("clipboard", "copie ref échouée (permission ?)", { ref, err: e && e.message }));
       }
     } else if (action === "delete-item") {
       // v5.0.0 : supprimer absence/réservation (depuis tooltip)
@@ -8866,6 +9182,11 @@ function bindTooltipInteractions() {
   });
 }
 
+/**
+ * Construit le HTML du tooltip détaillé pour une intervention/réservation.
+ *
+ * @author Quentin Rouiller
+ */
 function buildTooltipHTML(iv) {
   if (!iv) return '<dl><dt>Info</dt><dd>—</dd></dl>';
   const i = iv.infobulle || {};