ajoute section Installation et navigateurs (Firefox vs Chromium : install, mises à jour, stockage)

2026-04-27 05:18:05 +02:00
parent a2e72a7cfd
commit 7b76a99fd1
+74 -2
@@ -4,6 +4,7 @@ Ce guide couvre toutes les fonctionnalités de l'extension **Planification** au
## Sommaire ## Sommaire
- [Installation et navigateurs](#installation-et-navigateurs)
- [Premier lancement](#premier-lancement) - [Premier lancement](#premier-lancement)
- [La topbar (vue classique)](#la-topbar-vue-classique) - [La topbar (vue classique)](#la-topbar-vue-classique)
- [Les cartes des techniciens](#les-cartes-des-techniciens) - [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/<profile>/storage/default/moz-extension+++<extension-uuid>/`
- **Windows** : `%APPDATA%\Mozilla\Firefox\Profiles\<profile>\storage\default\moz-extension+++<extension-uuid>\`
- **Linux** : `~/.mozilla/firefox/<profile>/storage/default/moz-extension+++<extension-uuid>/`
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/<extension-id>/` (code) + `~/Library/Application Support/Google/Chrome/Default/Local Extension Settings/<extension-id>/` (données `chrome.storage.local`)
- **Windows** : `%LOCALAPPDATA%\Google\Chrome\User Data\Default\Extensions\<extension-id>\`
- **Linux** : `~/.config/google-chrome/Default/Extensions/<extension-id>/`
(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 ## 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 : Si aucune session n'est détectée :
- Un message **"Session EasyVista expirée"** apparaît - 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**. 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. 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. 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. 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. Tes choix sont **persistés dans `chrome.storage.local`** et survivent aux mises à jour d'extension — pas besoin de reconfigurer à chaque nouvelle version.