Réorganisation : Démarrage rapide en haut, contexte plus bas, audience clarifiée, line counts à jour

2026-04-27 05:31:57 +02:00
parent 7b76a99fd1
commit 4a7cc57a9c
+71 -67
@@ -1,63 +1,36 @@
# Planification — Extension EasyVista
> Extension Chrome / Firefox utilisée par les **coordinateurs DGNSI** pour piloter le planning des techniciens dans **EasyVista** (Canton de Vaud).
> Extension Chrome / Firefox pour visualiser de manière claire et rapide
> le planning EasyVista de l'équipe technicienne **DGNSI (Canton de Vaud)**.
>
> Développée par **Quentin Rouiller**, Technicien DGNSI — Canton de Vaud.
---
## Le contexte
Au sein de la DGNSI, deux rôles travaillent main dans la main sur les interventions du jour :
- Les **coordinateurs** affectent les interventions aux techniciens dans EasyVista — ils choisissent qui fait quoi, où, à quelle heure, en arbitrant en permanence entre les disponibilités, les compétences et les priorités.
- Les **techniciens** consultent leur planning du jour sur leur **douchette** une fois sur le terrain.
C'est donc côté coordinateur que se joue toute l'organisation de la journée. Et c'est précisément là qu'EasyVista pose problème.
## Le problème de départ
Depuis toujours, le planning natif d'EasyVista n'a jamais été l'outil idéal pour ce travail de coordination :
- **Lisibilité faible** : tous les tickets sont mélangés dans la même grille tabulaire, sans distinction visuelle immédiate entre interventions, réservations, absences, statuts pompiers ou conflits d'horaire.
- **Peu intuitif** : pour avoir une vue d'ensemble de l'équipe sur la journée, il faut multiplier les clics et naviguer ticket par ticket. Aucun aperçu synthétique par technicien.
- **Lourd à l'usage** : chaque action prend plusieurs étapes là où on aimerait un simple coup d'œil, ce qui ralentit le rythme d'un coordinateur qui doit ajuster le planning en continu.
Et depuis quelque temps, **la situation s'est encore dégradée** : plusieurs fonctionnalités utiles ont disparu au fil des mises à jour de la plateforme (filtres rapides, raccourcis vers les fiches, vues compactes, etc.). Ce qui prenait quelques secondes auparavant se transforme aujourd'hui en parcours laborieux.
Concrètement, pour un coordinateur, ces régressions se traduisent par :
- Un travail **plus difficile et moins agréable** au quotidien
- Une **charge mentale** accrue pour reconstituer mentalement la vue d'ensemble
- Des **erreurs** plus fréquentes
- Une **mauvaise optimisation** du planning
## La réponse
**Planification** transforme les données déjà présentes dans EasyVista en une vue immédiatement lisible, pensée pour l'usage opérationnel d'un coordinateur :
- Chaque tech sur **sa propre carte** (ou sa propre ligne) avec une **timeline horaire** complète, qui rend les disponibilités évidentes au premier coup d'œil
- Les **catégories d'absence** distinguées par couleur (Maladie / Congé / Pompier) avec badge et code visuel cohérent
- Les **infos clés** (référence, contact, lieu, catégorie, statut) accessibles **au survol sans clic**
- Les **conflits d'horaire** et chevauchements détectés automatiquement et signalés visuellement
- Une **bascule rapide** entre vue cards (détail par tech) et vue horizontale (planning d'équipe pleine largeur)
- Les **interventions cliquables** ouvrent directement la fiche EasyVista correspondante dans un nouvel onglet, sans casser la navigation
Le tout fonctionne en **lecture seule** sur EasyVista : aucune modification n'est faite côté serveur. L'extension récupère les données existantes et les présente autrement, pour soulager les coordinateurs et limiter les erreurs d'affectation.
---
## Démarrage rapide
1. **Installer l'extension** :
- **Chrome / Edge** : télécharger le `.zip` depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases), décompresser, puis `chrome://extensions/` → Mode développeur → "Charger l'extension non empaquetée" → sélectionner le dossier décompressé.
- **Firefox** : télécharger le `.xpi` signé Mozilla depuis la [release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases), drag-and-drop dans `about:addons`. Ensuite l'extension se met à jour **automatiquement** à chaque nouvelle version (auto-update natif Firefox via `update_url`).
2. **Ouvrir EasyVista** dans un onglet (interne `itsma.etat-de-vaud.ch` ou externe `itsma.vd.ch` avec SSO).
3. **Cliquer sur l'icône** de l'extension dans la barre d'outils → la fenêtre Planification s'ouvre.
### Installation
L'extension détecte automatiquement votre session EasyVista et charge le planning du jour.
**Firefox 🦊 (recommandé — auto-update)**
1. Télécharger le `.xpi` signé depuis la **[release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases/latest)**.
2. Drag-and-drop le `.xpi` dans `about:addons`.
3. Cliquer "Ajouter".
→ L'extension se met à jour **automatiquement** à chaque nouvelle version (auto-update natif Firefox toutes les ~24 h via `update_url`).
📖 Voir le **[Guide d'utilisation](Utilisation)** pour le détail complet (navigation, popups, modes d'affichage, paramètres).
**Chrome / Edge / Brave 🌐 (manuel)**
1. Télécharger le `.zip` depuis la **[release courante](https://gitea.netaplaid.ch/FroSteel/Planification/releases/latest)**.
2. Décompresser dans un dossier permanent.
3. `chrome://extensions/` (ou `edge://extensions/`) → activer **Mode développeur** → "Charger l'extension non empaquetée" → choisir le dossier.
### Premiers pas
1. **Ouvrir EasyVista** dans un onglet (interne `itsma.etat-de-vaud.ch` ou externe `itsma.vd.ch` avec SSO Canton).
2. **Cliquer sur l'icône** Planification dans la barre d'outils.
3. **Configurer ton équipe** : pastille initiales (haut gauche) → ⚙ Paramètres → Équipe → choisir le groupe EasyVista (SI-CSS / SI-EXT / …) → cocher les techniciens à afficher → 💾 Enregistrer.
L'extension détecte automatiquement ta session EasyVista et charge le planning du jour.
📖 Détail complet : **[Guide d'utilisation](Utilisation)** — navigation, popups, modes d'affichage, paramètres, dépannage.
---
@@ -65,10 +38,45 @@ L'extension détecte automatiquement votre session EasyVista et charge le planni
| Page | Contenu |
|---|---|
| **[Utilisation](Utilisation)** | Guide complet : navigation, raccourcis, modes d'affichage, paramètres |
| **[Versions](Versions)** | Historique des versions et système de versionning |
| **[Architecture](Architecture)** | Structure du projet, composants, fonctions clés (technique) |
| **[Contact](Contact)** | Demandes d'accès, reporting bugs, suggestions |
| **[Utilisation](Utilisation)** | Guide complet : installation par navigateur, navigation, raccourcis, modes d'affichage, paramètres |
| **[Versions](Versions)** | Historique des versions et système de versionning `YYYY.M.PATCH` |
| **[Architecture](Architecture)** | Structure du projet, composants, fonctions clés, helpers de config (technique) |
| **[Dépannage](D%C3%A9pannage)** | Erreurs courantes et leurs solutions |
| **[Contact](Contact)** | Reporting bugs, suggestions, demandes diverses |
---
## Le contexte
À la DGNSI, deux rôles travaillent main dans la main sur les interventions du jour :
- Les **coordinateurs** affectent les interventions aux techniciens dans EasyVista — ils choisissent qui fait quoi, où, à quelle heure, en arbitrant entre disponibilités, compétences et priorités.
- Les **techniciens** consultent leur planning du jour sur leur **douchette** une fois sur le terrain.
C'est côté coordinateur que se joue toute l'organisation de la journée — et c'est précisément là qu'EasyVista pose problème.
### Le problème de départ
Le planning natif d'EasyVista n'a jamais été l'outil idéal pour ce travail :
- **Lisibilité faible** : tickets mélangés dans une grille tabulaire, sans distinction visuelle immédiate entre interventions, réservations, absences, statuts pompiers ou conflits d'horaire.
- **Peu intuitif** : pour avoir une vue d'ensemble de l'équipe, il faut multiplier les clics et naviguer ticket par ticket.
- **Lourd à l'usage** : chaque action prend plusieurs étapes là où on aimerait un simple coup d'œil.
Et au fil des mises à jour, plusieurs fonctionnalités utiles ont disparu (filtres rapides, raccourcis vers les fiches, vues compactes). Concrètement pour un coordinateur : travail plus pénible, charge mentale accrue, plus d'erreurs, mauvaise optimisation du planning.
### La réponse
**Planification** transforme les données déjà présentes dans EasyVista en une vue immédiatement lisible :
- Chaque tech sur **sa propre carte** (ou ligne en vue horizontale) avec une **timeline horaire** complète qui rend les disponibilités évidentes au premier coup d'œil.
- **Catégories d'absence** distinguées par couleur (Maladie / Congé / Pompier).
- **Infos clés** (référence, contact, lieu, catégorie, statut) accessibles **au survol sans clic**.
- **Conflits d'horaire** détectés automatiquement et signalés en rouge plein.
- **Bascule rapide** entre vue cards (détail) et vue horizontale (équipe pleine largeur).
- **Interventions cliquables** : ouverture directe de la fiche EasyVista dans un nouvel onglet.
Le tout fonctionne en **lecture seule** sur EasyVista (sauf création d'absence et envoi sur douchette) : aucune perturbation des données serveur, juste une présentation différente.
---
@@ -76,25 +84,21 @@ L'extension détecte automatiquement votre session EasyVista et charge le planni
| Élément | Valeur |
|---|---|
| Manifest | V3 (Chrome / Edge / Firefox) |
| Architecture | Service worker + viewer (HTML/CSS/JS) |
| Lignes de code | ~9 300 (viewer.js) + ~1 350 (background.js) |
| Manifest | V3 (Chrome / Edge / Firefox 140+) |
| Architecture | Service worker + viewer (HTML/CSS/JS vanilla) |
| Lignes de code | ~10 700 (viewer.js) + ~1 600 (background.js) + ~4 800 (viewer.css) |
| Domaines cibles | `itsma.etat-de-vaud.ch` (interne), `itsma.vd.ch` (externe SSO) |
| SSO | Canton ForgeRock OpenAM |
| Stockage | `chrome.storage.local` (cache + config) |
| Stockage | `chrome.storage.local` (cache + `admin_config`) + `localStorage` (`view_mode`) |
| Auto-update Firefox | `firefox-updates.json` à la racine, `.xpi` signé Mozilla |
| Licence | MIT |
➡ Détail technique : **[Architecture](Architecture)**.
---
## Auteur
## Auteur & Licence
**Quentin Rouiller** (QRO) — Technicien DGNSI, Canton de Vaud
Pour toute demande, voir la page **[Contact](Contact)**.
## Licence
[MIT License](https://opensource.org/licenses/MIT) — © 2026 Quentin Rouiller
Le code source de cette extension est privé. Pour toute demande d'accès ou collaboration, voir la page Contact.
**Quentin Rouiller** (QRO) — Technicien DGNSI, Canton de Vaud — voir page **[Contact](Contact)**.
Code et documentation publiés sous **[MIT License](https://opensource.org/licenses/MIT)** — © 2026.