v2026.5.38 — Attribution auteur + nettoyage + observabilité

ATTRIBUTION
- En-têtes copyright dans tous les fichiers source (viewer.js, viewer.html,
  viewer.css, background.js)
- @author Quentin Rouiller sur 22 fonctions clés
- Signature "Développé par Quentin Rouiller" en bas du popup user-badge
- description manifest mentionnant DGNSI

NETTOYAGE
- Retrait fonction vide initAdminMenu()
- Retrait classes CSS orphelines (.date-picker-day, .intervention v1)
- Retrait 14× console.log [viewMode] verbeux + 5× console.log [bg]
- extendBtn.onclick → addEventListener (cohérence + cleanup possible)

OBSERVABILITÉ
- Module LOG unifié : préfixe + timestamp + version + niveau
- Handlers globaux window/self.error + unhandledrejection (viewer + bg)
- Toggle "Logs verbeux (debug)" dans le panel admin (Diagnostics)
- Synchronisation viewer ↔ background via chrome.storage.onChanged
- LOG.info muet par défaut, visible quand debug ON

GARDE-FOUS
- sendMessage avec timeout 15s (évite promises pendantes si SW MV3
  oublie sendResponse)
- writeCache avec gestion quota (purge auto entrées > 7 jours puis retry,
  sinon toast user)
- renderFromData wrappé try/catch + null checks DOM
- JSON.parse [timeline] : log warn avec snippet du contenu fautif
- .catch(() => {}) swallowed remplacés par log warn (clipboard, session,
  cache)
- getManifest centralisé dans LOG.version()

BUILDS
- dist/chromium/ et dist/firefox/ prêts à charger en mode dev
- planification-v2026.5.38-chromium.zip (~152 Ko)
- planification-v2026.5.38-firefox.xpi (~152 Ko, à signer sur AMO)

background.js

@@ -1,3 +1,16 @@
+/**
+ * Planification — Extension navigateur EasyVista (Canton de Vaud / DGNSI)
+ *
+ * Service worker (Manifest V3) : récupération session EV, fetch planning XML,
+ * fetch fiches détaillées, gestion cache.
+ *
+ * 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
+ */
+
 // background.js — Service worker (Manifest V3) — v4
 //
 // Rôles :
@@ -14,6 +27,94 @@
 // directement ref/contact/lieu/catégorie dans ses attributs attr1/attr2/attr3,
 // donc on n'a plus besoin ni de xhr2 en masse, ni de l'API timeline.
 
+// ============================================================================
+// v2026.5.38 : Observabilité — logger unifié + handlers globaux SW
+// ============================================================================
+// Le service worker MV3 est endormi/relancé fréquemment, donc important d'avoir
+// un format de log compact et reproductible. Les handlers `error` et
+// `unhandledrejection` sur `self` capturent ce qui passe à travers les
+// try/catch (ex: une promise oubliée dans un setTimeout).
+// ============================================================================
+
+// Clef chrome.storage.local pour le mode debug — toggle depuis le panel admin
+// du viewer. Le viewer envoie un message {type:"setDebugLogs"} qu'on traite
+// plus bas pour sync, et on lit aussi au boot.
+const DEBUG_LOGS_KEY = "debug_logs";
+
+const LOG = (() => {
+  let _version = "?";
+  try {
+    if (chrome && chrome.runtime && chrome.runtime.getManifest) {
+      _version = chrome.runtime.getManifest().version || "?";
+    }
+  } catch (e) {}
+
+  let _debug = false;
+  // Lecture initiale (asynchrone, mais on s'en fout : on commence muet
+  // et qd la valeur arrive on update). Le SW peut être tué/relancé donc
+  // on relit à chaque démarrage.
+  try {
+    chrome.storage.local.get([DEBUG_LOGS_KEY]).then(obj => {
+      _debug = !!obj[DEBUG_LOGS_KEY];
+    }).catch(() => {});
+  } catch (e) {}
+
+  const _stamp  = () => new Date().toISOString().substring(11, 23);
+  const _format = (level, prefix, msg, ctx) => {
+    const head = `[${_stamp()}][v${_version}][bg/${prefix}][${level}]`;
+    if (ctx !== undefined) return [head, msg, ctx];
+    return [head, msg];
+  };
+
+  return {
+    info: (prefix, msg, ctx) => {
+      if (!_debug) return;
+      console.log(..._format("INFO", prefix, msg, ctx));
+    },
+    warn: (prefix, msg, ctx) => console.warn (..._format("WARN",  prefix, msg, ctx)),
+    error:(prefix, msg, ctx) => console.error(..._format("ERROR", prefix, msg, ctx)),
+    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));
+    },
+    setDebug: (on) => {
+      _debug = !!on;
+      try { chrome.storage.local.set({ [DEBUG_LOGS_KEY]: _debug }); } catch (e) {}
+      console.log(..._format("INFO", "logger", `mode debug = ${_debug ? "ON" : "OFF"}`));
+    },
+    isDebug: () => _debug,
+    version: () => _version
+  };
+})();
+
+// Si le viewer toggle pendant qu'on est endormi/relancé, on capte le
+// changement chrome.storage et on update le flag local.
+chrome.storage.onChanged.addListener((changes, area) => {
+  if (area === "local" && changes[DEBUG_LOGS_KEY]) {
+    const newVal = !!changes[DEBUG_LOGS_KEY].newValue;
+    LOG.setDebug(newVal);
+  }
+});
+
+self.addEventListener("error", (event) => {
+  LOG.exception("global", "uncaught error in service worker",
+    event.error || new Error(event.message || "unknown"),
+    { filename: event.filename, lineno: event.lineno, colno: event.colno });
+});
+
+self.addEventListener("unhandledrejection", (event) => {
+  const reason = event.reason;
+  LOG.exception("global", "unhandled promise rejection in service worker",
+    reason instanceof Error ? reason : new Error(String(reason)));
+});
+
+LOG.info("boot", "service worker démarré", { version: LOG.version() });
+
 // Domaines EasyVista reconnus (interne d'abord, externe en fallback)
 const EV_ORIGINS = [
   "https://itsma.etat-de-vaud.ch",
@@ -40,6 +141,11 @@ chrome.action.onClicked.addListener(async () => {
 // Trouver l'onglet EasyVista actif et en extraire le PHPSESSID
 // ============================================================================
 
+/**
+ * Trouve l'onglet EasyVista ouvert et récupère phpsessid + origin.
+ *
+ * @author Quentin Rouiller
+ */
 async function findEasyVistaSession() {
   // Chercher tous les onglets sur un domaine EasyVista
   for (const origin of EV_ORIGINS) {
@@ -65,6 +171,8 @@ async function findEasyVistaSession() {
  *
  * Ce n'est PAS le HTML de la page Planning — le serveur ne rend pas les données
  * dans le HTML, elles arrivent via cet endpoint AJAX.
+ *
+ * @author Quentin Rouiller
  */
 async function fetchPlanningXml(origin, phpsessid, unixDate) {
   const techIds = "76272,83725,66635,92235,90070,40944,72485,86874";
@@ -84,9 +192,9 @@ async function fetchPlanningXml(origin, phpsessid, unixDate) {
     `&mail_title=mail` +
     `&day_start_hour=8` +
     `&day_end_hour=19`;
-  console.log("[bg] fetchPlanningXml →", url.substring(0, 140));
+  // v2026.5.38 : on retire les logs verbose à chaque fetch (URL/status/taille).
+  // En cas de souci, le throw plus bas porte assez d'info pour debug.
   const r = await evFetch(url, origin);
-  console.log("[bg]   status =", r.status);
   if (!r.ok) {
     // v4.2 : classifier l'erreur HTTP pour que le viewer affiche le bon
     // écran (session expirée vs EV inaccessible).
@@ -95,9 +203,7 @@ async function fetchPlanningXml(origin, phpsessid, unixDate) {
     err.status = r.status;
     throw err;
   }
-  const xml = await r.text();
-  console.log("[bg]   taille XML =", xml.length);
-  return xml;
+  return await r.text();
 }
 
 /**
@@ -156,7 +262,6 @@ async function fetchXhr2(origin, phpsessid, actionId) {
 
 async function fetchFicheHtml(origin, phpsessid, formLink) {
   const url = `${origin}/index.php?${formLink}&PHPSESSID=${encodeURIComponent(phpsessid)}`;
-  console.log("[bg] fetchFicheHtml →", url.substring(0, 120));
 
   // v2026.5.16 : juste après une reconnexion SSO, EasyVista retourne parfois
   // une page intermédiaire tronquée (~8 Ko au lieu de ~250 Ko), le temps que
@@ -175,7 +280,11 @@ async function fetchFicheHtml(origin, phpsessid, formLink) {
       throw err;
     }
     const html = await r.text();
-    console.log(`[bg]   fiche status = ${r.status} | taille = ${html.length}${attempt > 1 ? ` (tentative ${attempt}/${MAX_RETRIES})` : ""}`);
+    // v2026.5.38 : on log seulement les retries (utile en cas de pb SSO),
+    // pas chaque tentative normale qui réussit du premier coup.
+    if (attempt > 1) {
+      console.log(`[bg]   fiche tentative ${attempt}/${MAX_RETRIES} (taille = ${html.length})`);
+    }
 
     // Si réponse clairement une redirection courte → login expiré, inutile de retry
     if (html.length < 500) {
@@ -273,7 +382,7 @@ async function fetchSessionTimeRemaining(origin, phpsessid) {
   const url = `${origin}/timeout_ajax.php`
     + `?PHPSESSID=${encodeURIComponent(phpsessid)}`
     + `&__AJAX_TIMEOUT_FCT__=session_time`;
-  console.log("[bg] fetchSessionTimeRemaining →", url.substring(0, 120));
+  // v2026.5.38 : log retiré (appelé toutes les minutes, polluait la console).
   const r = await evFetch(url, origin);
   if (!r.ok) {
     throw new Error("HTTP " + r.status);
@@ -288,9 +397,7 @@ async function fetchSessionTimeRemaining(origin, phpsessid) {
     }
     throw new Error("invalid_response");
   }
-  const ms = parseInt(body, 10);
-  console.log(`[bg]   session_time = ${ms} ms = ${Math.round(ms/60000)} min`);
-  return ms;
+  return parseInt(body, 10);
 }
 
 /**
@@ -302,7 +409,7 @@ async function extendSessionKeepAlive(origin, phpsessid) {
   const url = `${origin}/timeout_ajax.php`
     + `?PHPSESSID=${encodeURIComponent(phpsessid)}`
     + `&__AJAX_TIMEOUT_FCT__=keep_connection`;
-  console.log("[bg] extendSessionKeepAlive →", url.substring(0, 120));
+  // v2026.5.38 : log retiré (déclenché par bouton "prolonger", l'UI affiche déjà un toast).
   const r = await evFetch(url, origin);
   if (!r.ok) {
     throw new Error("HTTP " + r.status);
@@ -312,9 +419,7 @@ async function extendSessionKeepAlive(origin, phpsessid) {
     if (looksLikeLoginPage(body)) throw new Error("session_expired");
     throw new Error("invalid_response");
   }
-  const ms = parseInt(body, 10);
-  console.log(`[bg]   keep_connection → session prolongée à ${ms} ms`);
-  return ms;
+  return parseInt(body, 10);
 }
 
 // ============================================================================
@@ -337,6 +442,8 @@ async function extendSessionKeepAlive(origin, phpsessid) {
  *
  * @param {boolean} force - si true, ignore le cache et refait le test
  * @returns {Promise<"internal"|"external">}
+ *
+ * @author Quentin Rouiller
  */
 async function detectNetworkContext(force = false) {
   const CACHE_KEY = "network_context_v2";  // v5.0.12 : nouvelle clé pour invalider le cache fautif v5.0.11
@@ -475,6 +582,8 @@ function watchReconnectTabForIamLogin(tabId) {
  *   - champ "Bienvenue Nom Prénom"
  * Retourne { name: "Nom Prénom" | null, login: "..." | null } ou null si
  * tout a échoué.
+ *
+ * @author Quentin Rouiller
  */
 async function fetchCurrentUser(origin, phpsessid) {
   const url = `${origin}/index.php?PHPSESSID=${encodeURIComponent(phpsessid)}`;
@@ -1213,6 +1322,13 @@ chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
         return;
       }
 
+      // v2026.5.38 : toggle debug logs (depuis le panel admin du viewer)
+      if (msg.type === "setDebugLogs") {
+        LOG.setDebug(!!msg.on);
+        sendResponse({ ok: true, debug: LOG.isDebug() });
+        return;
+      }
+
       sendResponse({ ok: false, error: "unknown_message" });
     } catch (err) {
       console.error("background error:", err);