forked from FroSteel/Planification
v2026.5.41 — Suppression des hardcodes runtime + UX admin + thème unifié
This commit is contained in:
@@ -7,7 +7,8 @@ Extension Chrome / Firefox pour visualiser de manière claire et rapide le plann
|
||||
- **Auteur** : Quentin Rouiller (QRO)
|
||||
- **Cible** : techniciens DGNSI (Canton de Vaud), EasyVista (`itsma.etat-de-vaud.ch` / `itsma.vd.ch`)
|
||||
- **Démarrage projet** : jeudi 16 avril 2026
|
||||
- **Version actuelle** : `v2026.5.40`
|
||||
- **Version actuelle** : `v2026.5.41`
|
||||
- **Contact** : `quentin.rouiller@vd.ch`
|
||||
- **Manifest** : V3 (Chrome/Edge/Firefox)
|
||||
- **Format** : `.zip` (Chromium) + `.xpi` signé (Firefox)
|
||||
|
||||
@@ -16,12 +17,13 @@ Extension Chrome / Firefox pour visualiser de manière claire et rapide le plann
|
||||
### Vue planning
|
||||
- Affichage des interventions et réservations groupées par technicien
|
||||
- Horaires, contact, lieu, catégorie, statut visibles d'un coup d'œil
|
||||
- 8 techniciens hardcodés (équipe IT canton)
|
||||
- Équipe configurable depuis le panel admin (détection automatique via EasyVista)
|
||||
- Cache local pour réduire les requêtes serveur
|
||||
|
||||
### Modes d'affichage
|
||||
- **Vue classique** (depuis v1.0.0) : cards en grille, mode compact écran 24" (depuis v2026.5.30)
|
||||
- **Vue horizontale** (depuis v2026.5.32) : timeline par tech, sidebar verticale (depuis v2026.5.36)
|
||||
- Depuis v2026.5.40 : barre couleur catégorie + référence + ville sur chaque segment timeline
|
||||
- Toggle Vue classique ↔ Vue horizontale via bouton ⊞ dans popup user-badge
|
||||
- Persistance localStorage (`view_mode`)
|
||||
|
||||
@@ -48,9 +50,11 @@ Extension Chrome / Firefox pour visualiser de manière claire et rapide le plann
|
||||
- Reconnexion automatique
|
||||
|
||||
### Admin et configuration
|
||||
- Mode admin caché : bouton ⚙ Paramètres dans popup user-badge (depuis v2026.5.25, remplace les 5 clics secrets sur le titre)
|
||||
- Configuration persistée dans `localStorage` (`admin_config`)
|
||||
- Catégories interventions personnalisables (livraison/recup/remplacement/incident/rollout/reservation/autre)
|
||||
- Mode admin : bouton ⚙ Paramètres dans popup user-badge (depuis v2026.5.25)
|
||||
- Configuration persistée dans `chrome.storage.local` (`admin_config`)
|
||||
- Sélecteur de groupe EasyVista (SI-CSS, SI-EXT, …) en tête de l'onglet Équipe (depuis v2026.5.40) — détection automatique via le `<select id="plan_group_id">` de la page Planning EV, robuste aux ajouts/renommages côté EV
|
||||
- Édition manuelle des domaines EasyVista interne / externe (depuis v2026.5.40)
|
||||
- Tri des techniciens : actifs d'abord, puis exclus, alphabétique dans chaque groupe (depuis v2026.5.40)
|
||||
|
||||
## Versionning — historique et conventions
|
||||
|
||||
@@ -60,7 +64,7 @@ L'extension a connu **3 systèmes de versionning successifs** :
|
||||
|---|---|---|
|
||||
| 16-17 avril 2026 | Versions de base | `1.0.0`, `2.0.0`, `3.0.0` |
|
||||
| 18-20 avril 2026 | SemVer classique | `4.1.3`, `4.2.8`, `5.0.12` |
|
||||
| 21 avril 2026 → maintenant | **`ANNÉE.MAJEURE.PATCH`** | `2026.5.16` → `2026.5.37` |
|
||||
| 21 avril 2026 → maintenant | **`ANNÉE.MAJEURE.PATCH`** | `2026.5.16` → `2026.5.40` |
|
||||
|
||||
### Format actuel : `ANNÉE.MAJEURE.PATCH`
|
||||
|
||||
@@ -70,11 +74,11 @@ L'extension a connu **3 systèmes de versionning successifs** :
|
||||
|---|---|---|
|
||||
| `2026` | **Année** | À chaque nouvelle année calendaire |
|
||||
| `5` | **Majeure** | À chaque **gros changement / ajout important** (refonte, nouvelle feature majeure, bump volontaire) |
|
||||
| `37` | **Patch** | À **chaque livraison** dans la majeure courante (corrections, ajustements, petites features) |
|
||||
| `40` | **Patch** | À **chaque livraison** dans la majeure courante (corrections, ajustements, petites features) |
|
||||
|
||||
Exemples :
|
||||
- `2026.5.16` → `2026.5.17` : petite correction ou ajustement (patch)
|
||||
- `2026.5.37` → `2026.6.0` : refonte majeure (par exemple nouvelle vue, nouvelle architecture)
|
||||
- `2026.5.40` → `2026.6.0` : refonte majeure (par exemple nouvelle vue, nouvelle architecture)
|
||||
- `2026.x.y` → `2027.0.0` : passage à la nouvelle année
|
||||
|
||||
Le numéro de **majeure** n'est **pas** un mois et **pas** un chiffre lié au calendrier — c'est un compteur de versions importantes propre au projet (la `5` actuelle continue le `5.x` qui précédait, repris tel quel lors du passage au format annuel).
|
||||
@@ -83,49 +87,57 @@ Le numéro de **majeure** n'est **pas** un mois et **pas** un chiffre lié au ca
|
||||
|
||||
## Versions notables
|
||||
|
||||
### `v2026.5.40` (latest, 27 avril 2026) — Sélection groupe EV + édition domaines + tri équipe + vue horizontale enrichie
|
||||
- **Onglet Équipe** : sélecteur de groupe EasyVista (SI-CSS, SI-EXT, …) en tête de section, détecté automatiquement via le `<select id="plan_group_id">` de la page Planning EV. Robuste aux ajouts/renommages côté EV.
|
||||
### `v2026.5.41` (latest, 27 avril 2026) — Suppression des hardcodes + UX admin + thème unifié
|
||||
- **Plus aucun hardcode runtime** pour le groupe EV, les domaines, la liste de techniciens ou les absences récurrentes. Tout est piloté par `admin_config` (chrome.storage.local), persisté entre les mises à jour.
|
||||
- **Au 1er install** : aucun tech sélectionné, aucune absence récurrente. Le viewer affiche un message *"Aucun technicien sélectionné"* tant que l'utilisateur n'a rien configuré dans Paramètres → Équipe.
|
||||
- **Édition des domaines** : `chrome.permissions.request()` au save quand l'utilisateur saisit un domaine custom (au-delà des 2 défauts). Manifest `optional_host_permissions: ["https://*/*"]` pour accepter n'importe quel domaine HTTPS après accord du navigateur.
|
||||
- **Heures de la journée** : bouton ✓ Appliquer explicite (au lieu de save direct), toast de confirmation, refetch automatique du planning. Synchronisation effective avec les requêtes EV (`day_start_hour` / `day_end_hour` / `begin_hour` / `end_hour`) — avant, l'affichage changeait mais les requêtes restaient sur 8h-19h hardcodés.
|
||||
- **Thème unifié** : le toggle 🌙 de la topbar et le sélecteur Apparence du panel admin écrivent dans la même clé (`cfg.theme`). Le mode "Automatique" est résolu en JS via `prefers-color-scheme` (le CSS n'avait pas de bloc `@media`, ce qui faisait retomber sur le clair même quand l'OS était en sombre). Listener `matchMedia` pour bascule live en mode auto.
|
||||
- **Conflit absence/réservation × intervention** : si une intervention est planifiée pendant qu'un tech a une absence (toute la journée ou demi-journée) ou une réservation au même créneau, sa carte est peinte en **rouge plein** (intervention conflictuelle). Logique : full-day → toutes en rouge ; partiel → seules celles en chevauchement.
|
||||
- **Pillonel & Cie** : suppression de la fonction hardcodée `isPillonelAbsentFriday()`. L'absence récurrente est désormais générique : `RECURRING_ABSENCES[tech.id]` lit `cfg.recurringAbsences` et le label "Absent le X" est calculé dynamiquement depuis le jour de la semaine.
|
||||
- **Notifications au-dessus du flou** : z-index `.toast-stack` relevé à 11000 (le panel admin est à 10000) pour que les toasts de feedback restent visibles quand l'admin est ouvert.
|
||||
- **Vue horizontale** : popups au survol/clic limités aux candidats `dessous`/`dessus` (la sidebar à gauche et la timeline pleine largeur rendent gauche/droite peu praticables).
|
||||
- **Tri équipe** : inclus d'abord, puis exclus, alphabétique dans chaque sous-groupe (ne saute plus quand on coche/décoche).
|
||||
- **Auto-refresh à l'enregistrement** : ajouter/retirer un tech, changer de groupe, modifier les domaines → le planning se met à jour immédiatement (plus besoin de recharger l'extension manuellement).
|
||||
- **Onglet Statuts retiré** (placeholder lecture-seule, jamais utilisé).
|
||||
- **Ménage de code** : suppression de `CACHE_DAYS` (inutilisée), `LS_THEME` (clé localStorage obsolète), commentaire historique sur `initAdminMenu()`. Aucun symbole orphelin restant.
|
||||
|
||||
### `v2026.5.40` — Sélection groupe EV + édition domaines + tri équipe + vue horizontale enrichie
|
||||
- **Onglet Équipe** : sélecteur de groupe EasyVista (SI-CSS, SI-EXT, …) en tête de section, détecté automatiquement à l'ouverture du panel via le `<select id="plan_group_id">` de la page Planning EV. Robuste aux ajouts/renommages côté EV.
|
||||
- **Onglet Équipe** : sélecteur de groupe EasyVista (SI-CSS, SI-EXT, …) en tête de section, détecté automatiquement à l'ouverture du panel via le `<select id="plan_group_id">` de la page Planning EV. Robuste aux ajouts/renommages côté EV.
|
||||
- ID groupe affiché en italique (ex: `ID groupe : 191`).
|
||||
- Refresh auto de la liste d'équipe au changement de groupe.
|
||||
- Plus de bouton "Détecter" (tout est auto à l'ouverture).
|
||||
- Tri double : inclus d'abord, puis exclus, alphabétique dans chaque sous-groupe.
|
||||
- **Onglet EasyVista** : édition manuelle des deux domaines (interne / externe), bouton Réinitialiser, normalisation auto des URLs.
|
||||
- **Onglet Statuts retiré** (placeholder lecture seule).
|
||||
- **Vue horizontale enrichie** : barre verticale couleur catégorie, référence en gras, ville en gris muted, hauteur 22→32px.
|
||||
- Coulisses : nouveau message `detectGroups`, fonction `detectGroupsFromEV()` côté `background.js`. `detectTeamFromEV()` accepte un groupId en argument.
|
||||
- Quand on change de groupe, la liste d'équipe se rafraîchit automatiquement avec les membres du nouveau groupe.
|
||||
- Plus de bouton "Détecter" : tout est auto à l'ouverture.
|
||||
- Tri double des techniciens : inclus d'abord, puis exclus, alphabétique dans chaque sous-groupe.
|
||||
- **Onglet EasyVista** : édition manuelle des deux domaines (interne DGNSI / externe Internet), bouton Réinitialiser, normalisation auto des URLs.
|
||||
- **Onglet Statuts retiré** (placeholder lecture-seule).
|
||||
- **Vue horizontale enrichie** : chaque segment timeline contient désormais une barre verticale couleur catégorie à gauche, la référence (ex: `SYYMMDD_NNNNN`) en gras, et la ville en gris muted. Hauteur passée de 22px à 32px.
|
||||
- **Réorganisation interne du repo** : `src/` pour les sources, `dist/` généré, `Autres/` pour build.sh + meta files (LICENSE, README, CHANGELOG), `Builds/` pour les artefacts distribués.
|
||||
|
||||
### `v2026.5.39` — Séparation Matin / Après-midi + Apparence
|
||||
- Pills "MATIN" / "APRÈS-MIDI" entre les interventions
|
||||
- Section Apparence (thème, taille du texte, cache, heures de la journée)
|
||||
- Section À propos (version, auteur, licence)
|
||||
- Pills "MATIN" / "APRÈS-MIDI" entre les interventions de chaque tech
|
||||
- Section **Apparence** dans les paramètres : thème, taille du texte, durée du cache, heures de la journée
|
||||
- Section **À propos** (version, auteur, licence)
|
||||
|
||||
### `v2026.5.38` — Attribution auteur + nettoyage + observabilité
|
||||
- Module `LOG` unifié + handlers globaux d'erreur
|
||||
- Toggle "Logs verbeux (debug)" dans le panel admin
|
||||
- En-têtes copyright dans tous les fichiers source
|
||||
|
||||
### `v2026.5.37` — Refonte vue horizontale
|
||||
- Topbar supprimée en vue horizontale, tout passe en sidebar
|
||||
- User-badge + titre + bouton "Aujourd'hui" + date/heure + sélecteur + flèches + stats dans sidebar
|
||||
- Banderole pompier masquée (badge + barre rouge gauche conservés)
|
||||
### `v2026.5.37` — Refonte vue horizontale (sidebar complète)
|
||||
- Topbar entièrement déplacée en sidebar verticale
|
||||
|
||||
### `v2026.5.36` — Sidebar verticale
|
||||
### `v2026.5.36` — Sidebar verticale en vue horizontale
|
||||
- Wrapper flex-row `#horizontal-wrapper` [sidebar 200px] + [main]
|
||||
- Déplacement physique des éléments via `ELEMENTS_TO_RELOCATE`
|
||||
- Restauration propre en vue classique
|
||||
|
||||
### `v2026.5.32` — Vue horizontale togglable
|
||||
- Bouton ⊞ "Vue" dans popup user-badge
|
||||
- Chaque tech = 1 ligne horizontale compacte
|
||||
- localStorage `view_mode`
|
||||
|
||||
### `v2026.5.27` — Classification absences
|
||||
- ABSENCE_LABELS : `^(cong[ée]s|maladie|pompier)$`
|
||||
- Couleurs catégories
|
||||
- Topbar une ligne : "Jeudi 23.04.26 • 21:55"
|
||||
- Maladie indigo, Congé cyan, Pompier rouge
|
||||
|
||||
### `v4.2.3` — Grande popup timeline persistante
|
||||
- Clic segment timeline = popup persistante
|
||||
- Hover = popup qui suit la souris
|
||||
|
||||
### `v4.1.3` — Tooltips épinglables
|
||||
- Introduction de `pinTooltip`
|
||||
@@ -133,17 +145,30 @@ Le numéro de **majeure** n'est **pas** un mois et **pas** un chiffre lié au ca
|
||||
### `v1.0.0` (16 avril 2026) — Initiale
|
||||
- Premier viewer EasyVista pour le canton
|
||||
|
||||
Voir [CHANGELOG.md](CHANGELOG.md) pour l'historique complet (40 versions taggées).
|
||||
Voir [CHANGELOG.md](CHANGELOG.md) pour l'historique complet (40+ versions taggées).
|
||||
|
||||
## Architecture technique
|
||||
|
||||
```
|
||||
manifest.json # Manifest V3 (Chrome) + gecko_settings (Firefox)
|
||||
background.js # Worker fond : fetch planning XML, gestion session, fetch fiches
|
||||
viewer.html # Interface principale
|
||||
viewer.js # Logique (~9000 lignes) — voir détail ci-dessous
|
||||
viewer.css # Styles + thèmes clair/sombre
|
||||
icons/ # icon16, icon48, icon128
|
||||
Planning/
|
||||
├── src/ # Sources de l'extension (chargées par le navigateur)
|
||||
│ ├── manifest.json # Manifest V3 (Chrome) + gecko_settings (Firefox)
|
||||
│ ├── background.js # Service worker : fetch planning XML, gestion session, fetch fiches
|
||||
│ ├── viewer.html # Interface principale
|
||||
│ ├── viewer.js # Logique (~9 500 lignes)
|
||||
│ ├── viewer.css # Styles + thèmes clair/sombre
|
||||
│ └── icons/ # icon16, icon48, icon128
|
||||
├── Autres/ # Méta : build script + docs (depuis v2026.5.40)
|
||||
│ ├── build.sh # Génère dist/chromium/, dist/firefox/, .zip, .xpi
|
||||
│ ├── CHANGELOG.md
|
||||
│ ├── LICENSE
|
||||
│ └── README.md
|
||||
├── Builds/ # Artefacts distribués aux techniciens
|
||||
│ ├── Chromium/
|
||||
│ ├── Firefox/
|
||||
│ ├── planification-vYYYY.M.PATCH-chromium.zip
|
||||
│ └── planification-vYYYY.M.PATCH-firefox.xpi
|
||||
└── dist/ # Sortie de build (gitignoré)
|
||||
```
|
||||
|
||||
### `viewer.js` — fonctions clés
|
||||
@@ -160,30 +185,42 @@ icons/ # icon16, icon48, icon128
|
||||
| `_softUnpinPopup` | v4.3.3 | Désépinglage mou (popup reste visible) |
|
||||
| `initAppClock` | v5.0.0 | Horloge HH:MM topbar |
|
||||
| `initSessionTimer` | v5.0.0 | Compteur session EV (tick 1s) |
|
||||
| `initAdminMenu` | v5.0.0 | Menu admin (5 clics titre) |
|
||||
| `_applyViewMode` | v2026.5.32 | Toggle vue classique/horizontale |
|
||||
| `_maybeRetryFetchUser` | v2026.5.34 | Relance opportuniste fetch user |
|
||||
| `positionTooltipAnchored` | v2026.5.34 | Positionnement unifié (4 candidats) |
|
||||
| `renderAdminSectionTeam` | v5.0.0 | Onglet admin Équipe (sélecteur groupe EV depuis v2026.5.40) |
|
||||
| `renderAdminSectionEV` | v5.0.0 | Onglet admin EasyVista (édition domaines depuis v2026.5.40) |
|
||||
|
||||
### Constantes persistantes (toutes versions)
|
||||
### `background.js` — fonctions clés
|
||||
|
||||
- 8 techs hardcodés : `76272,83725,66635,92235,90070,40944,72485,86874`
|
||||
- Pillonel Olivier (ID 40944) : absent tous les vendredis (hardcodé)
|
||||
- Group ID EasyVista : `191`
|
||||
| Fonction | Rôle |
|
||||
|---|---|
|
||||
| `findEasyVistaSession` | Trouve l'onglet EV ouvert + extrait PHPSESSID |
|
||||
| `fetchPlanningXml` | Fetch XML calendar_block du planning |
|
||||
| `fetchFicheHtml` | Fetch HTML d'une fiche EV (avec retry SSO) |
|
||||
| `fetchCurrentUser` | Identifie l'user EV connecté |
|
||||
| `detectGroupsFromEV` (v2026.5.40) | Parse le `<select id="plan_group_id">` → liste des groupes EV |
|
||||
| `detectTeamFromEV` | Liste les membres d'un groupe (paramétrable depuis v2026.5.40) |
|
||||
| `evFetch` | Wrapper fetch avec headers EV (Referer, X-Requested-With) |
|
||||
|
||||
### Constantes / valeurs hardcodées (toutes versions)
|
||||
|
||||
- Group ID EV par défaut : `191` (SI-CSS) — surchargeable via le sélecteur depuis v2026.5.40
|
||||
- Pillonel Olivier (ID 40944) : absent tous les vendredis (récurrent)
|
||||
- GUIDs forms EV :
|
||||
- Demande : `S={C99ECD05-3D48-4C62-ABF0-66292053AED6}`
|
||||
- Incident : `I={07ED9C68-6172-48EA-8A58-90912B0A283E}`
|
||||
- SSO : Canton ForgeRock OpenAM
|
||||
- Storage keys : `admin_config`, `view_mode` (depuis v2026.5.32)
|
||||
- Domaines : `itsma.etat-de-vaud.ch` (interne), `itsma.vd.ch` (externe SSO)
|
||||
- Storage keys : `admin_config`, `view_mode`
|
||||
- Domaines : `itsma.etat-de-vaud.ch` (interne), `itsma.vd.ch` (externe)
|
||||
|
||||
## Installation
|
||||
|
||||
### Firefox
|
||||
Télécharger le `.xpi` signé depuis le serveur de mises à jour interne, ou drag-and-drop dans `about:addons`.
|
||||
Télécharger le `.xpi` depuis `Builds/` ou le serveur de mises à jour interne, puis drag-and-drop dans `about:addons`.
|
||||
|
||||
### Chrome / Edge
|
||||
Mode développeur : décompresser le ZIP et charger en tant qu'extension non empaquetée.
|
||||
Mode développeur : décompresser `Builds/planification-vYYYY.M.PATCH-chromium.zip` (ou utiliser directement `dist/chromium/`) et charger en tant qu'extension non empaquetée.
|
||||
|
||||
## Développement
|
||||
|
||||
@@ -191,12 +228,19 @@ Mode développeur : décompresser le ZIP et charger en tant qu'extension non emp
|
||||
git clone https://gitea.netaplaid.ch/FroSteel/Planification.git
|
||||
cd Planification
|
||||
|
||||
# Pour packager une nouvelle version :
|
||||
# 1. modifier le code
|
||||
# 2. bump version dans manifest.json
|
||||
# 3. zip + xpi
|
||||
# Modifier les sources dans src/
|
||||
# Bumper la version dans src/manifest.json + ajouter une entrée dans Autres/CHANGELOG.md
|
||||
# Builder :
|
||||
./Autres/build.sh
|
||||
# → produit dist/chromium/, dist/firefox/, dist/*.zip, dist/*.xpi
|
||||
|
||||
# Copier dans Builds/ pour distribution :
|
||||
cp -r dist/chromium Builds/Chromium
|
||||
cp -r dist/firefox Builds/Firefox
|
||||
cp dist/*.zip dist/*.xpi Builds/
|
||||
|
||||
git add -A
|
||||
git commit -m "Version YYYY.M.PATCH — description"
|
||||
git commit -m "vYYYY.M.PATCH — description"
|
||||
git tag vYYYY.M.PATCH
|
||||
git push origin main
|
||||
git push --tags
|
||||
@@ -210,3 +254,4 @@ git push --tags
|
||||
|
||||
**Quentin Rouiller** (QRO)
|
||||
Technicien DGNSI — Canton de Vaud
|
||||
Contact : `quentin.rouiller@vd.ch`
|
||||
|
||||
Reference in New Issue
Block a user