Compare commits
6 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 Quentin Rouiller
|
54b8f826df | ||
 FroSteel
|
8ecf2d3df4 | ||
|
Quentin Rouiller
|
9d8d8102d7 | ||
|
Quentin Rouiller
|
48b00a8585 | ||
|
Quentin Rouiller
|
6bb97addd6 | ||
|
Quentin Rouiller
|
05275a3be5 |
@@ -44,11 +44,6 @@ _archives/
|
||||
Old.zip
|
||||
Old/
|
||||
|
||||
# Mémoire / config Claude Code (ne jamais commit, contient potentiellement
|
||||
# des tokens, des notes user, etc.)
|
||||
.claude/
|
||||
CLAUDE.local.md
|
||||
|
||||
# Variables d'environnement / secrets
|
||||
.env
|
||||
.env.*
|
||||
|
||||
+7
-6
@@ -1,11 +1,11 @@
|
||||
# CHANGELOG — Extension Planification EasyVista Canton de Vaud
|
||||
|
||||
> Ce changelog documente l'évolution de l'extension Chrome/Firefox "Planification"
|
||||
> développée par Quentin Rouiller pour les techniciens DGNSI (Canton de Vaud).
|
||||
> développée par Quentin Rouiller pour les coordinateurs DGNSI (Canton de Vaud).
|
||||
>
|
||||
> Les versions documentées ci-dessous sont celles dont les détails sont connus.
|
||||
> Pour les versions plus anciennes, Claude Code se basera sur l'analyse du code
|
||||
> source pour déterminer un message de commit pertinent.
|
||||
> Pour les versions plus anciennes, l'analyse du code source permet de
|
||||
> reconstituer un message de version pertinent.
|
||||
|
||||
---
|
||||
|
||||
@@ -340,8 +340,9 @@
|
||||
|
||||
## Versions antérieures (v5.x et v4.x)
|
||||
|
||||
> Ces versions sont à analyser par Claude Code à partir des fichiers source.
|
||||
> Indices clés à chercher dans le viewer.js :
|
||||
> Ces versions ne sont pas documentées en détail. Pour les analyser à partir
|
||||
> des fichiers source historiques (consultables via les tags git), voici les
|
||||
> indices clés à chercher dans `viewer.js` :
|
||||
>
|
||||
> - Présence de `pinTooltip` → version >= v4.x
|
||||
> - Présence de `_softUnpinPopup` → version >= v4.3.3
|
||||
@@ -369,7 +370,7 @@
|
||||
- v4.3.3 : _softUnpinPopup (désépinglage mou)
|
||||
|
||||
### v3.x et antérieures — Versions de base
|
||||
- À analyser par Claude Code
|
||||
- Code historique consultable via les tags git correspondants.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,192 +0,0 @@
|
||||
# CLAUDE.md — Workflow de développement Planification
|
||||
|
||||
> **À lire avant toute modification.** Ce fichier décrit le processus complet
|
||||
> que Claude doit suivre quand Quentin demande une modification de l'extension.
|
||||
|
||||
---
|
||||
|
||||
## Stack du projet
|
||||
|
||||
- **Type** : extension navigateur Manifest V3 (Chrome / Edge / Firefox 140+)
|
||||
- **Fonction** : viewer du planning des techniciens DGNSI dans EasyVista
|
||||
- **Cible utilisateurs** : techniciens DGNSI (Canton de Vaud)
|
||||
- **Auteur** : Quentin Rouiller (email dans la mémoire Claude `user_role.md`)
|
||||
- **Repo Gitea** : https://gitea.netaplaid.ch/FroSteel/Planification
|
||||
- **Config runtime** : `chrome.storage.local["admin_config"]` (persiste entre updates)
|
||||
|
||||
## Structure du repo
|
||||
|
||||
```
|
||||
src/ # Sources de l'extension (chargées par le navigateur)
|
||||
├── manifest.json # Manifest V3 — version YYYY.M.PATCH
|
||||
├── background.js # Service worker
|
||||
├── viewer.{html,js,css}
|
||||
└── icons/
|
||||
|
||||
Autres/ # Méta + build
|
||||
├── build.sh # Génère dist/{chromium,firefox}/, .zip, .xpi, met à jour firefox-updates.json
|
||||
├── CHANGELOG.md # Synchronisé avec le CHANGELOG.md à la racine
|
||||
├── README.md # Synchronisé avec le README.md à la racine
|
||||
└── LICENSE
|
||||
|
||||
Builds/ # Artefacts distribués (Chromium/, Firefox/, .zip, .xpi)
|
||||
dist/ # Sortie de build (gitignoré)
|
||||
firefox-updates.json # Manifest d'auto-update Firefox (servi via update_url)
|
||||
CLAUDE.md # Ce fichier
|
||||
CHANGELOG.md # Source de vérité du changelog (lu par AMO + GitHub-style)
|
||||
README.md # Source de vérité du README
|
||||
```
|
||||
|
||||
> **NB** : le repo Gitea utilise un **layout flat à la racine** pour le code
|
||||
> source historique (`build.sh`, `README.md`, `CHANGELOG.md`, `LICENSE`,
|
||||
> `firefox-updates.json` à la racine, et `src/` pour le code). En local,
|
||||
> le dossier `Autres/` contient une copie de ces fichiers — tu peux éditer
|
||||
> l'un ou l'autre, mais quand tu pousses sur Gitea c'est la racine qui doit
|
||||
> être mise à jour.
|
||||
|
||||
---
|
||||
|
||||
## Workflow standard d'une demande de modification
|
||||
|
||||
Quand Quentin demande une nouvelle fonctionnalité ou un bugfix :
|
||||
|
||||
### Phase 1 — Code + build local (toi seul, pas encore de push)
|
||||
|
||||
1. **Comprendre la demande**, poser des questions si nécessaire avant d'écrire du code.
|
||||
2. **Coder les modifications** dans `src/` (jamais directement dans `dist/` ou `Builds/`).
|
||||
3. **Bumper la version** : incrémenter le 3e chiffre dans `src/manifest.json`
|
||||
(ex: `2026.5.41` → `2026.5.42`). Bump majeur (2e chiffre) seulement pour
|
||||
les refontes ; année (1er chiffre) au passage à 2027.
|
||||
4. **Mettre à jour le CHANGELOG** (`Autres/CHANGELOG.md` ET la copie racine
|
||||
`CHANGELOG.md`) en ajoutant une nouvelle entrée en haut.
|
||||
5. **Mettre à jour le README** (`Autres/README.md` ET racine `README.md`)
|
||||
si la nouvelle version touche aux fonctionnalités principales.
|
||||
6. **Builder** : `./Autres/build.sh` — ça produit `dist/chromium/`,
|
||||
`dist/firefox/`, le `.zip` et le `.xpi` avec la nouvelle version.
|
||||
7. **Annoncer à Quentin** : "v2026.5.X buildée, recharge l'extension dans
|
||||
ton navigateur et teste". Décrire brièvement ce qui a changé visuellement.
|
||||
8. **Attendre son retour**. Tant qu'il n'a pas dit "OK", ne pas pousser sur
|
||||
Gitea. Si correction demandée, retourner à l'étape 2.
|
||||
|
||||
### Phase 2 — Push sur Gitea (uniquement après validation explicite)
|
||||
|
||||
Quand Quentin dit "OK push" / "valide" / équivalent :
|
||||
|
||||
1. **Préparer un clone Gitea à jour** dans `/tmp/planif-push/` (clone si pas
|
||||
présent, sinon `git fetch origin && git reset --hard origin/main`).
|
||||
2. **Synchroniser** :
|
||||
- `rsync -a --delete /Users/quentin/Documents/Planning/src/ /tmp/planif-push/src/`
|
||||
- Copier les versions racine de `CHANGELOG.md`, `README.md`, `LICENSE`,
|
||||
`build.sh` (les versions racine sur Gitea, pas celles de `Autres/`)
|
||||
3. **Régénérer `firefox-updates.json`** à la racine du repo : ajouter
|
||||
l'entrée de la nouvelle version en haut de la liste `updates` (les
|
||||
anciennes entrées restent — Firefox prend la version la plus haute
|
||||
parmi celles listées). Le `update_link` pointe vers la release Gitea :
|
||||
`https://gitea.netaplaid.ch/FroSteel/Planification/releases/download/vYYYY.M.PATCH/planification-vYYYY.M.PATCH-firefox.xpi`.
|
||||
Le `update_hash` est calculé après signature AMO (cf. Phase 3).
|
||||
|
||||
Le repo Gitea est **public**, donc l'URL fixe `update_url` =
|
||||
`https://gitea.netaplaid.ch/FroSteel/Planification/raw/branch/main/firefox-updates.json`
|
||||
est accessible sans auth → Firefox peut le fetcher directement.
|
||||
`build.sh` maintient automatiquement ce JSON à chaque build (ajoute /
|
||||
met à jour l'entrée de la version courante).
|
||||
4. **Commit + push** :
|
||||
```bash
|
||||
cd /tmp/planif-push
|
||||
git add -A
|
||||
git commit -m "vYYYY.M.PATCH — <description courte>"
|
||||
git push origin main
|
||||
git tag -a vYYYY.M.PATCH -m "vYYYY.M.PATCH"
|
||||
git push origin vYYYY.M.PATCH
|
||||
```
|
||||
5. **Créer la release Gitea** via l'API (POST
|
||||
`/repos/FroSteel/Planification/releases`) avec :
|
||||
- `tag_name`: `vYYYY.M.PATCH`
|
||||
- `name`: `vYYYY.M.PATCH`
|
||||
- `body`: extrait du CHANGELOG (la section de cette version)
|
||||
6. **Uploader les binaires** comme assets de la release :
|
||||
- `dist/planification-vYYYY.M.PATCH-chromium.zip`
|
||||
- `dist/planification-vYYYY.M.PATCH-firefox.xpi` (NON signé pour le moment)
|
||||
7. **Mettre à jour le wiki Gitea** :
|
||||
- Page **Versions** : ajouter une entrée détaillée en haut (dérivée du CHANGELOG)
|
||||
- Page **Utilisation** : si le changement modifie l'UX (ajout d'un bouton,
|
||||
d'une section admin, d'un comportement) → documenter
|
||||
- Page **Architecture** : si nouvelles fonctions clés / nouvelle config
|
||||
persistée → documenter
|
||||
|
||||
### Phase 3 — Signature Firefox (manuel, fait par Quentin)
|
||||
|
||||
C'est la seule étape que Claude ne peut pas automatiser :
|
||||
|
||||
1. Quentin va sur https://addons.mozilla.org/developers/
|
||||
2. Submit New Version → uploade le `.xpi` non signé de la release Gitea
|
||||
3. Choisit **"On your own"** (Unlisted, self-distributed)
|
||||
4. Mozilla signe → Quentin télécharge le `.xpi` signé
|
||||
|
||||
Quentin revient ensuite avec le `.xpi` signé et demande "remplace par le signé".
|
||||
À ce moment Claude fait :
|
||||
1. Remplacer l'asset `.xpi` de la release Gitea (delete + upload)
|
||||
2. Calculer le `sha256` du `.xpi` signé
|
||||
3. Mettre à jour `firefox-updates.json` : ajouter `"update_hash": "sha256:<hash>"`
|
||||
4. Commit + push le JSON mis à jour
|
||||
|
||||
À partir de ce moment, l'auto-update Firefox fonctionne pour cette version.
|
||||
|
||||
---
|
||||
|
||||
## Token Gitea
|
||||
|
||||
⚠️ **Le token API Gitea ne doit JAMAIS apparaître dans ce fichier ni dans le
|
||||
repo Gitea**. Il est stocké uniquement dans la mémoire Claude locale
|
||||
(`~/.claude/projects/-Users-quentin-Documents-Planning/memory/gitea_token.md`,
|
||||
hors repo). Si Claude perd la mémoire (nouvelle session non héritée),
|
||||
demander à Quentin de redonner le token.
|
||||
|
||||
Header API à utiliser : `Authorization: token <TOKEN>` + `User-Agent: curl/8.4.0`
|
||||
(le User-Agent évite que Cloudflare bloque les requêtes Python urllib).
|
||||
|
||||
---
|
||||
|
||||
## Règles importantes
|
||||
|
||||
- **Ne jamais hardcoder** dans `src/` : groupe EV, équipe, domaines, absences
|
||||
récurrentes. Tout passe par `admin_config`. Les seuls hardcodes acceptables
|
||||
sont les **filets de sécurité** (DEFAULT_GROUP_ID, DEFAULT_EV_ORIGINS pour
|
||||
le 1er install). Cf. v2026.5.41 pour la migration complète.
|
||||
- **Ne jamais pousser sur Gitea sans validation explicite** de Quentin.
|
||||
- **Toujours bumper la version** avant un push qui modifie le code.
|
||||
- **Toujours mettre à jour le CHANGELOG** avant un push.
|
||||
- **Tags non touchés** sur Gitea : `v1.0.0`-`v3.3.0`, `v4.1.x`-`v4.3.0`,
|
||||
`v5.0.0`, `v2026.5.27`-`v2026.5.32` (ceux-là pointent vers du code
|
||||
reconstitué historique, ne jamais les bouger).
|
||||
- **Force-push uniquement si Quentin le demande explicitement.**
|
||||
- **L'email de l'auteur** ne doit apparaître nulle part dans `src/` ni dans
|
||||
les fichiers Markdown du repo (CLAUDE.md, README.md inclus). Il est stocké
|
||||
uniquement en mémoire Claude (`user_role.md` / `gitea_token.md`) et exposé
|
||||
obfusqué (entités HTML) sur la page wiki Contact.
|
||||
|
||||
---
|
||||
|
||||
## Pages wiki Gitea
|
||||
|
||||
| Page | Contenu | Quand mettre à jour |
|
||||
|---|---|---|
|
||||
| **Home** | Pitch, contexte, démarrage rapide | Rarement |
|
||||
| **Utilisation** | Guide complet pour l'utilisateur | À chaque changement UX |
|
||||
| **Versions** | Historique détaillé des versions | À chaque release |
|
||||
| **Architecture** | Doc technique (fonctions, config, structure) | À chaque ajout d'helper / changement structurel |
|
||||
| **Contact** | Email obfusqué + lien Issue Gitea | Rarement |
|
||||
|
||||
URL de base wiki : `https://gitea.netaplaid.ch/FroSteel/Planification/wiki/<NOM>`
|
||||
Endpoint API : `/api/v1/repos/FroSteel/Planification/wiki/page/<NOM>` (PATCH avec
|
||||
`content_base64`).
|
||||
|
||||
---
|
||||
|
||||
## Pour résumer ton rôle, Claude
|
||||
|
||||
Quentin demande une modif → tu codes → tu builds → il teste → il valide →
|
||||
tu push tout (Gitea + wiki + firefox-updates.json). Plus tard il revient avec
|
||||
le `.xpi` signé d'AMO → tu mets à jour la release et le `update_hash` du JSON.
|
||||
|
||||
Si tu hésites sur quoi faire à un moment, **demande**. Ne suppose pas.
|
||||
@@ -1,16 +1,39 @@
|
||||
# Planification — Extension EasyVista Canton de Vaud
|
||||
|
||||
Extension Chrome / Firefox pour visualiser de manière claire et rapide le planning des techniciens DGNSI (Canton de Vaud) dans EasyVista.
|
||||
Extension Chrome / Firefox pour visualiser de manière claire et rapide le planning EasyVista de l'équipe technicienne DGNSI (Canton de Vaud).
|
||||
|
||||
> 📖 **Documentation utilisateur complète** : [wiki](https://gitea.netaplaid.ch/FroSteel/Planification/wiki) ([Home](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Home) · [Utilisation](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Utilisation) · [Versions](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Versions) · [Architecture](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Architecture) · [Dépannage](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/D%C3%A9pannage) · [Contact](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Contact))
|
||||
|
||||
## Aperçu rapide
|
||||
|
||||
- **Auteur** : Quentin Rouiller (QRO)
|
||||
- **Cible** : techniciens DGNSI (Canton de Vaud), EasyVista (`itsma.etat-de-vaud.ch` / `itsma.vd.ch`)
|
||||
- **Auteur** : Quentin Rouiller (QRO), Technicien DGNSI — Canton de Vaud
|
||||
- **Public cible** : coordinateurs DGNSI qui pilotent dans EasyVista (`itsma.etat-de-vaud.ch` / `itsma.vd.ch`) le planning de l'équipe technicienne
|
||||
- **Démarrage projet** : jeudi 16 avril 2026
|
||||
- **Version actuelle** : `v2026.5.43`
|
||||
- **Contact** : voir [page wiki Contact](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Contact)
|
||||
- **Manifest** : V3 (Chrome/Edge/Firefox)
|
||||
- **Format** : `.zip` (Chromium) + `.xpi` signé (Firefox)
|
||||
- **Version actuelle** : [`v2026.5.43`](https://gitea.netaplaid.ch/FroSteel/Planification/releases/tag/v2026.5.43) (latest)
|
||||
- **Contact** : voir [page wiki Contact](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Contact) ou [ouvrir une issue](https://gitea.netaplaid.ch/FroSteel/Planification/issues/new)
|
||||
- **Manifest** : V3 (Chrome/Edge/Firefox 140+)
|
||||
- **Format** : `.zip` (Chromium) + `.xpi` signé Mozilla (Firefox)
|
||||
- **Distribution** : auto-update natif Firefox via `firefox-updates.json`
|
||||
|
||||
## Installation rapide
|
||||
|
||||
### 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 dans `about:addons` de Firefox.
|
||||
3. Cliquer "Ajouter".
|
||||
|
||||
À partir de là, l'extension se met à jour **automatiquement** à chaque nouvelle version (vérification toutes les ~24 h via `firefox-updates.json`).
|
||||
|
||||
### 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" → sélectionner le dossier décompressé.
|
||||
|
||||
Les mises à jour sont **manuelles** : à chaque nouvelle release, retélécharger le `.zip`, écraser le dossier, puis cliquer ⟳ (Recharger) sur la carte de l'extension.
|
||||
|
||||
➡ Pour le détail complet (stockage, désinstallation, comparatif), voir [wiki Utilisation → Installation et navigateurs](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Utilisation#installation-et-navigateurs).
|
||||
|
||||
## Fonctionnalités principales
|
||||
|
||||
@@ -115,7 +138,6 @@ Le numéro de **majeure** n'est **pas** un mois et **pas** un chiffre lié au ca
|
||||
|
||||
### `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`).
|
||||
- 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.
|
||||
@@ -128,110 +150,29 @@ Le numéro de **majeure** n'est **pas** un mois et **pas** un chiffre lié au ca
|
||||
### `v2026.5.39` — Séparation Matin / Après-midi + Apparence
|
||||
- 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 (sidebar complète)
|
||||
- Topbar entièrement déplacée en sidebar verticale
|
||||
|
||||
### `v2026.5.36` — Sidebar verticale en vue horizontale
|
||||
- Wrapper flex-row `#horizontal-wrapper` [sidebar 200px] + [main]
|
||||
|
||||
### `v2026.5.32` — Vue horizontale togglable
|
||||
- Bouton ⊞ "Vue" dans popup user-badge
|
||||
|
||||
### `v2026.5.27` — Classification absences
|
||||
- Maladie indigo, Congé cyan, Pompier rouge
|
||||
|
||||
### `v4.2.3` — Grande popup timeline persistante
|
||||
- Clic segment timeline = popup persistante
|
||||
|
||||
### `v4.1.3` — Tooltips épinglables
|
||||
- Introduction de `pinTooltip`
|
||||
|
||||
### `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).
|
||||
➡ Pour l'historique complet (40+ versions depuis le 16 avril 2026), voir le **[CHANGELOG.md](CHANGELOG.md)** ou la **[page wiki Versions](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Versions)**.
|
||||
|
||||
## Architecture technique
|
||||
|
||||
```
|
||||
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é)
|
||||
Planification/ # Layout du repo Gitea (public)
|
||||
├── src/ # Sources de l'extension (chargées par le navigateur)
|
||||
│ ├── manifest.json # Manifest V3 (Chrome) + browser_specific_settings (Firefox)
|
||||
│ ├── background.js # Service worker (~1 600 lignes)
|
||||
│ ├── viewer.html # Interface principale
|
||||
│ ├── viewer.js # Logique UI (~10 700 lignes)
|
||||
│ ├── viewer.css # Styles + thèmes clair/sombre (~4 800 lignes)
|
||||
│ └── icons/ # icon16, icon48, icon128
|
||||
├── build.sh # Génère dist/chromium/, dist/firefox/, .zip, .xpi, met à jour firefox-updates.json
|
||||
├── firefox-updates.json # Manifest auto-update Firefox (servi via update_url)
|
||||
├── README.md
|
||||
├── CHANGELOG.md
|
||||
├── LICENSE # MIT
|
||||
└── .gitignore
|
||||
```
|
||||
|
||||
### `viewer.js` — fonctions clés
|
||||
|
||||
| Fonction | Introduite | Rôle |
|
||||
|---|---|---|
|
||||
| `loadForDate` | v1.0.0 | Fetch + parse planning pour une date donnée |
|
||||
| `buildTooltipHTML` | v1.0.0 | Construction HTML du tooltip d'intervention |
|
||||
| `pinTooltip` | v4.1.3 | Épingler un tooltip (le rendre permanent) |
|
||||
| `bindTimelinePopover` | v4.2.3 | Lier popover timeline aux segments |
|
||||
| `showTimelinePopover` | v4.2.3 | Afficher popover persistante |
|
||||
| `openPersistentTimelinePopup` | v4.2.3 | Grande popup détaillée |
|
||||
| `setTooltipViewportPosition` | v4.2.4 | Détection auto fixed/abs |
|
||||
| `_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) |
|
||||
| `_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) |
|
||||
|
||||
### `background.js` — fonctions clés
|
||||
|
||||
| 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
|
||||
- Absences récurrentes par tech : configurables via Paramètres → Équipe (depuis v2026.5.41)
|
||||
- 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`
|
||||
- Domaines : `itsma.etat-de-vaud.ch` (interne), `itsma.vd.ch` (externe)
|
||||
|
||||
## Installation
|
||||
|
||||
### Firefox
|
||||
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 `Builds/planification-vYYYY.M.PATCH-chromium.zip` (ou utiliser directement `dist/chromium/`) et charger en tant qu'extension non empaquetée.
|
||||
➡ Pour le détail des composants, fonctions clés et flux de données, voir la **[page wiki Architecture](https://gitea.netaplaid.ch/FroSteel/Planification/wiki/Architecture)**.
|
||||
|
||||
## Développement
|
||||
|
||||
@@ -240,23 +181,21 @@ git clone https://gitea.netaplaid.ch/FroSteel/Planification.git
|
||||
cd Planification
|
||||
|
||||
# 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/
|
||||
# Bumper src/manifest.json + entrée CHANGELOG.md
|
||||
./build.sh
|
||||
# → dist/chromium/, dist/firefox/, dist/*.zip, dist/*.xpi
|
||||
# → firefox-updates.json mis à jour (sha256 .xpi NON SIGNÉ)
|
||||
|
||||
git add -A
|
||||
git commit -m "vYYYY.M.PATCH — description"
|
||||
git tag vYYYY.M.PATCH
|
||||
git push origin main
|
||||
git push --tags
|
||||
git push origin main vYYYY.M.PATCH
|
||||
```
|
||||
|
||||
Pour Firefox : signer le `.xpi` sur AMO en mode "On your own" (Unlisted),
|
||||
remplacer l'asset `.xpi` de la release Gitea, puis mettre à jour le sha256
|
||||
de cette version dans `firefox-updates.json`.
|
||||
|
||||
## Licence
|
||||
|
||||
[MIT License](LICENSE) — Copyright (c) 2026 Quentin Rouiller
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
{
|
||||
"version": "2026.5.43",
|
||||
"update_link": "https://gitea.netaplaid.ch/FroSteel/Planification/releases/download/v2026.5.43/planification-v2026.5.43-firefox.xpi",
|
||||
"update_hash": "sha256:9d1f0cb49b98cdb46a0e022dc53c77c98fde380590e72036e188c128d6b19965"
|
||||
"update_hash": "sha256:2bdf1b0a781080f4a86600579eb8c2049e060b9e8a0439212f3f29d280d5b93e"
|
||||
},
|
||||
{
|
||||
"version": "2026.5.42",
|
||||
|
||||
Reference in New Issue
Block a user