From 4a7cc57a9cbbc0990e7ebc10e5d89bb100b1d53f Mon Sep 17 00:00:00 2001 From: Quentin Rouiller Date: Mon, 27 Apr 2026 05:31:57 +0200 Subject: [PATCH] =?UTF-8?q?R=C3=A9organisation=20:=20D=C3=A9marrage=20rapi?= =?UTF-8?q?de=20en=20haut,=20contexte=20plus=20bas,=20audience=20clarifi?= =?UTF-8?q?=C3=A9e,=20line=20counts=20=C3=A0=20jour?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Home.md | 138 +++++++++++++++++++++++++++++--------------------------- 1 file changed, 71 insertions(+), 67 deletions(-) diff --git a/Home.md b/Home.md index acd3c97..7653139 100644 --- a/Home.md +++ b/Home.md @@ -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.