From 7b76a99fd12ffcb3cd8ec977aff9675102966039 Mon Sep 17 00:00:00 2001 From: Quentin Rouiller Date: Mon, 27 Apr 2026 05:18:05 +0200 Subject: [PATCH] =?UTF-8?q?ajoute=20section=20Installation=20et=20navigate?= =?UTF-8?q?urs=20(Firefox=20vs=20Chromium=20:=20install,=20mises=20=C3=A0?= =?UTF-8?q?=20jour,=20stockage)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Utilisation.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 74 insertions(+), 2 deletions(-) diff --git a/Utilisation.md b/Utilisation.md index d7cd433..095b089 100644 --- a/Utilisation.md +++ b/Utilisation.md @@ -4,6 +4,7 @@ Ce guide couvre toutes les fonctionnalités de l'extension **Planification** au ## Sommaire +- [Installation et navigateurs](#installation-et-navigateurs) - [Premier lancement](#premier-lancement) - [La topbar (vue classique)](#la-topbar-vue-classique) - [Les cartes des techniciens](#les-cartes-des-techniciens) @@ -17,9 +18,80 @@ Ce guide couvre toutes les fonctionnalités de l'extension **Planification** au --- +## Installation et navigateurs + +L'extension fonctionne sur **Firefox** et sur les navigateurs **Chromium** (Chrome, Edge, Brave). Le code et les fonctionnalités sont identiques, mais l'installation, le stockage et les mises à jour diffèrent légèrement entre les deux familles. + +### Firefox 🦊 + +**Installation** : +1. Télécharger le `.xpi` **signé Mozilla** depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases) (fichier `planification-vX.Y.Z-firefox.xpi`). +2. Drag-and-drop le fichier dans `about:addons` de Firefox. +3. Cliquer "Ajouter" — Firefox vérifie la signature Mozilla, l'installe. + +**Mises à jour** : **automatiques**. Firefox vérifie toutes les ~24 h le manifest d'update (`firefox-updates.json` à la racine du repo Gitea), détecte les nouvelles versions, télécharge le `.xpi` signé correspondant, vérifie son sha256 et l'installe silencieusement. Aucune action requise du technicien. + +**Désinstallation** : `about:addons` → cliquer sur "Planification" → "Supprimer". + +**Stockage local** : +- **Mac** : `~/Library/Application Support/Firefox/Profiles//storage/default/moz-extension+++/` +- **Windows** : `%APPDATA%\Mozilla\Firefox\Profiles\\storage\default\moz-extension+++\` +- **Linux** : `~/.mozilla/firefox//storage/default/moz-extension+++/` + +Le contenu (cache des plannings + `admin_config`) **survit aux mises à jour de l'extension**. Pour réinitialiser : Paramètres → Diagnostics → "Réinitialiser la configuration" (méthode propre), ou supprimer manuellement le dossier ci-dessus. + +### Chromium 🌐 (Chrome, Edge, Brave) + +**Installation** (mode développeur) : +1. Télécharger le `.zip` depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases) (fichier `planification-vX.Y.Z-chromium.zip`). +2. Décompresser dans un dossier permanent (ex: `~/Documents/Planification-extension/`). +3. Ouvrir `chrome://extensions/` (ou `edge://extensions/`). +4. Activer **"Mode développeur"** (toggle en haut à droite). +5. Cliquer **"Charger l'extension non empaquetée"** → sélectionner le dossier décompressé. + +**Mises à jour** : **manuelles**. Chrome ne fait pas d'auto-update pour les extensions chargées en "non empaquetées". Quand une nouvelle version sort : +1. Re-télécharger le nouveau `.zip` depuis la release Gitea. +2. Remplacer le contenu du dossier d'installation. +3. Dans `chrome://extensions/` → cliquer le bouton "Recharger" ⟳ sur la carte Planification. + +**Désinstallation** : `chrome://extensions/` → bouton "Supprimer" sur la carte Planification. + +**Stockage local** : +- **Mac** : `~/Library/Application Support/Google/Chrome/Default/Extensions//` (code) + `~/Library/Application Support/Google/Chrome/Default/Local Extension Settings//` (données `chrome.storage.local`) +- **Windows** : `%LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions\\` +- **Linux** : `~/.config/google-chrome/Default/Extensions//` + +(Pour Edge, remplacer `Google/Chrome` par `Microsoft/Edge`. Pour Brave, par `BraveSoftware/Brave-Browser`.) + +Le contenu (cache + `admin_config`) **survit aux rechargements** de l'extension par "Recharger ⟳", mais peut être perdu si tu **supprimes puis re-installes** l'extension (l'ID change). + +### Tableau comparatif + +| | **Firefox** | **Chromium** | +|---|---|---| +| Format de distribution | `.xpi` signé Mozilla | `.zip` non packagé | +| Mode d'installation | Drag-and-drop dans `about:addons` | Mode développeur + dossier décompressé | +| Signature requise | ✅ Mozilla (auto par Quentin pour chaque version) | ❌ Aucune | +| **Auto-update** | ✅ Natif (24h max) | ❌ Manuel (recharger ⟳) | +| Survit aux updates | ✅ | ✅ | +| Persistance du `admin_config` | ✅ | ✅ tant que l'extension n'est pas désinstallée | +| Compteur session EV | ✅ | ✅ | +| Auto-fetch périodique du planning | ✅ | ✅ | + +### Choix recommandé pour les techniciens DGNSI + +**Firefox est recommandé** pour la majorité des techniciens, car : +- L'auto-update évite de devoir re-télécharger à chaque correction +- Pas besoin d'activer le mode développeur (qui peut être bloqué par GPO) +- Installation 1-clic via `about:addons` + +**Chromium reste utilisable** pour les techs qui préfèrent rester sur Chrome/Edge ou ceux dont le profil Firefox n'est pas configuré pour le SSO Canton. Mais ils devront être notifiés manuellement à chaque nouvelle version. + +--- + ## Premier lancement -À l'ouverture de l'extension, la fenêtre Planification affiche le **planning du jour** des 8 techniciens DGNSI configurés. Si une session EasyVista est ouverte dans un autre onglet, les données arrivent en quelques secondes. +À l'ouverture de l'extension, la fenêtre Planification affiche le **planning du jour** des techniciens DGNSI cochés dans Paramètres → Équipe (vide au 1er install — voir [Premier lancement (v2026.5.41+)](#premier-lancement-v202654-1)). Si une session EasyVista est ouverte dans un autre onglet, les données arrivent en quelques secondes. Si aucune session n'est détectée : - Un message **"Session EasyVista expirée"** apparaît @@ -253,7 +325,7 @@ Procédure : 2. Clique sur la pastille des initiales en haut à gauche de l'extension → **⚙ Paramètres → Équipe**. 3. Le sélecteur "Groupe EasyVista" se peuple automatiquement (SI-CSS / SI-EXT / …). Choisis le tien. 4. Le tableau des techniciens du groupe se peuple automatiquement aussi. Coche ceux qui doivent apparaître dans la planification. -5. (Optionnel) Si l'un d'eux est absent récurrent un jour de la semaine (ex: Pillonel Olivier le vendredi), coche le jour dans la colonne "Absences récurrentes". +5. (Optionnel) Si l'un d'eux est absent récurrent un jour de la semaine (ex: tous les vendredis), coche le jour dans la colonne "Absences récurrentes". 6. Clique **💾 Enregistrer**. Le planning se met à jour immédiatement. Tes choix sont **persistés dans `chrome.storage.local`** et survivent aux mises à jour d'extension — pas besoin de reconfigurer à chaque nouvelle version.