diff --git a/D%C3%A9pannage.md b/D%C3%A9pannage.md new file mode 100644 index 0000000..e928260 --- /dev/null +++ b/D%C3%A9pannage.md @@ -0,0 +1,166 @@ +# Dépannage + +Cette page liste les erreurs courantes rencontrées avec l'extension Planification et leur solution. Si ton problème n'est pas ici, voir [Contact](Contact) pour ouvrir une issue. + +## Sommaire + +- [« Aucun technicien sélectionné »](#aucun-technicien-selectionne) +- [« Session EasyVista expirée »](#session-easyvista-expiree) +- [« EasyVista est inaccessible »](#easyvista-est-inaccessible) +- [Auto-update Firefox ne fonctionne pas](#auto-update-firefox-ne-fonctionne-pas) +- [Popups épinglés disparus après reload](#popups-epingles-disparus-apres-reload) +- [Le planning charge mais reste vide](#le-planning-charge-mais-reste-vide) +- [Mauvais groupe affiché (SI-CSS au lieu de SI-EXT, etc.)](#mauvais-groupe-affiche) +- [Pastille utilisateur reste sur "?"](#pastille-utilisateur-reste-sur-) +- [Refresh de l'extension après mise à jour Chrome](#refresh-de-lextension-apres-mise-a-jour-chrome) +- [Récupérer les logs détaillés pour un rapport de bug](#recuperer-les-logs-detaillees-pour-un-rapport-de-bug) + +--- + +## « Aucun technicien sélectionné » + +**Symptôme** : message en grand au milieu de l'extension : +> *"Aucun technicien sélectionné. Ouvrez ⚙ Paramètres → Équipe pour choisir le groupe EasyVista et cocher les techniciens à afficher."* + +**Cause** : depuis v2026.5.41, l'extension ne livre plus aucun technicien hardcodé. Au 1er install (ou après "Réinitialiser la configuration"), `cfg.team` est vide → le service worker refuse de fetcher avec une équipe vide et lève l'erreur `no_team_configured`. + +**Solution** : voir [Configuration initiale (1er install)](Utilisation#configuration-initiale-1er-install) sur le guide Utilisation. En 30 secondes : pastille initiales → ⚙ Paramètres → Équipe → choisir groupe → cocher les techs → 💾 Enregistrer. + +--- + +## « Session EasyVista expirée » + +**Symptôme** : bannière en haut ou écran plein indiquant que la session a expiré, parfois suivi d'un compteur MM:SS qui passe en rouge. + +**Cause** : EasyVista déconnecte automatiquement les sessions inactives après ~30 minutes. L'extension détecte ça quand un fetch retourne 401/403 ou une page de login. + +**Solutions** (par ordre rapide) : +1. Cliquer **🔄 Prolonger** dans la pastille utilisateur (popup haut gauche) — envoie un keep-alive et remet le compteur à 30 min. +2. Si déjà expirée : cliquer **Ouvrir EasyVista** dans la bannière → te reconnecter via SSO Canton → revenir sur l'onglet Planification → l'extension détecte la nouvelle session automatiquement. +3. En télétravail externe : faut passer par `itsma.vd.ch` avec ton compte ForgeRock OpenAM (le SSO Kerberos interne ne fonctionne que sur le LAN DGNSI). + +--- + +## « EasyVista est inaccessible » + +**Symptôme** : bannière orange "EasyVista est inaccessible. Données affichées depuis le cache." + +**Causes possibles** : +- Maintenance EasyVista côté Canton (rare mais arrive). +- Réseau coupé / VPN tombé pour les techs en télétravail. +- Bug temporaire EV (timeout, erreur 500). + +**Solutions** : +1. Cliquer **Réessayer** dans la bannière (réessaye le fetch sans recharger toute l'extension). +2. Vérifier dans un autre onglet que `https://itsma.etat-de-vaud.ch/` ou `https://itsma.vd.ch/` répond. +3. Si EV répond : peut-être un problème de session — voir [Session EasyVista expirée](#session-easyvista-expiree). +4. Si EV ne répond pas : attendre, c'est probablement temporaire. L'extension continue d'afficher le cache local pendant ce temps. + +--- + +## Auto-update Firefox ne fonctionne pas + +**Symptôme** : tu sais qu'une nouvelle version est sortie (collègue qui l'a, mention dans un message), mais ton extension reste sur l'ancienne version même après plusieurs jours. + +**Cause** : Firefox vérifie `firefox-updates.json` toutes les ~24 h. Plusieurs raisons peuvent empêcher la détection : +- Tu as installé un `.xpi` **non signé** (mode développeur) — ces extensions ne s'auto-updatent pas. +- Le navigateur n'a pas eu de fenêtre temporelle pour faire le check (Firefox fermé pendant des jours). +- Le proxy / pare-feu bloque les requêtes vers `gitea.netaplaid.ch`. + +**Solutions** : +1. Vérifier la version installée : `about:addons` → cliquer sur "Planification" → onglet "Détails" → numéro de version. +2. Forcer la vérification : `about:addons` → menu ⚙ (en haut à droite) → "Vérifier les mises à jour". +3. Si pas de mise à jour proposée : vérifier que l'extension est bien signée Mozilla (`about:addons` doit afficher un badge bleu de vérification, pas un avertissement). +4. En dernier recours : retélécharger manuellement le `.xpi` signé depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases/latest), drag-and-drop dans `about:addons`. + +➡ **Chrome / Edge** : il n'y a **PAS d'auto-update**. Tu dois toujours retélécharger le `.zip` manuellement à chaque nouvelle version, écraser ton dossier d'install, puis cliquer ⟳ (Recharger) dans `chrome://extensions/`. + +--- + +## Popups épinglés disparus après reload + +**Symptôme** : tu avais épinglé une ou plusieurs popups d'intervention (📌), tu rafraîchis le planning ou tu changes de date, et les popups épinglés ont disparu. + +**Cause** : les popups épinglés ne sont **pas persistés entre les rafraîchissements** ni entre les changements de date. C'est un comportement voulu (un popup épinglé est lié à une intervention spécifique d'un jour donné). + +**Solutions** : +- Pour garder une vue détaillée d'une intervention : utiliser plutôt le bouton **"Ouvrir"** du popup pour ouvrir la fiche EasyVista dans un nouvel onglet, qui survit aux rafraîchissements. +- Pour avoir plusieurs interventions visibles en même temps : utiliser la **vue horizontale** (toggle ⊞ Vue dans la pastille utilisateur), qui montre plus d'infos à la fois. + +--- + +## Le planning charge mais reste vide + +**Symptôme** : pas d'erreur, pas de bannière, l'icône de chargement se finit, mais aucune carte de tech n'apparaît. + +**Causes possibles** : +1. **Aucun tech coché** dans Paramètres → Équipe → voir [« Aucun technicien sélectionné »](#aucun-technicien-selectionne). +2. **Mauvais groupe** sélectionné — voir [Mauvais groupe affiché](#mauvais-groupe-affiche). +3. **Date sans planning** : aucun tech n'a d'intervention ni d'absence ce jour-là (rare mais possible un jour férié). +4. **Filtre absences** : si tu as la vue horizontale et tous les techs sont absents (vacances scolaires…), ils peuvent être visuellement très condensés. + +**Diagnostic** : ouvre **⚙ Paramètres → Diagnostics** et regarde : +- "Date courante" / "Aujourd'hui" +- "Session EasyVista" — doit afficher "✓ connecté" +- Active **"Logs verbeux"** et regarde la console (F12) pour voir si les fetches passent. + +--- + +## Mauvais groupe affiché + +**Symptôme** : tu vois SI-CSS alors que tu travailles dans SI-EXT (ou inverse). + +**Cause** : depuis v2026.5.40 le groupe est configurable. Si tu n'as rien changé depuis le 1er install, tu es sur le défaut SI-CSS (id `191`). + +**Solution** : pastille initiales → ⚙ Paramètres → onglet **Équipe** → sélecteur **"Groupe EasyVista"** en tête → choisir SI-EXT (ou autre). La liste des techs en dessous se rafraîchit automatiquement avec les membres du nouveau groupe. Coche ceux à afficher → 💾 Enregistrer. + +--- + +## Pastille utilisateur reste sur "?" + +**Symptôme** : la pastille en haut à gauche affiche "?" au lieu de tes initiales, même après quelques minutes. + +**Cause** : l'extension n'arrive pas à identifier ton utilisateur EasyVista (échec du parsing de la page d'accueil EV après login). + +**Solutions** : +1. Vérifier que tu es bien connecté à EV dans un autre onglet. +2. Recharger l'extension : `about:addons` ou `chrome://extensions` → ⟳. +3. Si le problème persiste : ouvrir une [issue](https://gitea.netaplaid.ch/FroSteel/Planification/issues/new) avec les logs verbeux activés (Diagnostics → Logs verbeux). + +L'extension retente automatiquement la détection toutes les 60 s (max 10 essais), mais une fois échouée, elle abandonne et la pastille reste "?". + +--- + +## Refresh de l'extension après mise à jour Chrome + +**Symptôme** : tu as téléchargé une nouvelle version `.zip` Chromium et écrasé ton dossier d'install, mais Chrome affiche toujours l'ancienne version. + +**Cause** : Chrome ne détecte pas automatiquement le changement de fichiers dans un dossier "non empaquetée". + +**Solution** : +1. `chrome://extensions/` (ou `edge://extensions/`). +2. Trouver la carte "Planification". +3. Cliquer le bouton **⟳ (Recharger)** sur la carte (icône circulaire). +4. La version affichée doit maintenant correspondre à la nouvelle. + +Si toujours l'ancienne : redémarrer entièrement Chrome après le ⟳. + +--- + +## Récupérer les logs détaillés pour un rapport de bug + +Si tu rencontres un bug et que tu veux en faire un rapport propre : + +1. **Activer les logs verbeux** : pastille initiales → ⚙ Paramètres → onglet **Diagnostics** → toggle **"Logs verbeux (debug)"** sur ON. +2. **Reproduire** le bug. +3. **Ouvrir DevTools** : `F12` (ou clic droit dans la fenêtre extension → Inspecter). +4. **Onglet Console** : sélectionner tous les logs (`Cmd+A` ou `Ctrl+A`), copier (`Cmd+C` / `Ctrl+C`). +5. **[Ouvrir une issue](https://gitea.netaplaid.ch/FroSteel/Planification/issues/new)** avec : + - Description courte du bug + - Étapes pour reproduire + - Capture d'écran de ce qui pose problème + - Logs console copiés (entre triple backticks ``` pour le formatage) + - Version de l'extension (visible dans Paramètres → À propos) + - Navigateur + OS + +Les logs sont préfixés `[HH:MM:SS.mmm][vX.Y.Z][module][LEVEL]` ce qui permet à l'auteur de retrouver rapidement la cause sans devoir reproduire localement.