diff --git a/Utilisation.md b/Utilisation.md
new file mode 100644
index 0000000..a297c9f
--- /dev/null
+++ b/Utilisation.md
@@ -0,0 +1,282 @@
+# Guide d'utilisation
+
+Ce guide couvre toutes les fonctionnalités de l'extension **Planification** au fur et à mesure de leur découverte naturelle.
+
+## Sommaire
+
+- [Premier lancement](#premier-lancement)
+- [La topbar (vue classique)](#la-topbar-vue-classique)
+- [Les cartes des techniciens](#les-cartes-des-techniciens)
+- [La timeline](#la-timeline)
+- [Les popups d'intervention](#les-popups-dintervention)
+- [Les deux modes d'affichage](#les-deux-modes-daffichage)
+- [Le badge utilisateur (initiales)](#le-badge-utilisateur-initiales)
+- [La gestion de session EasyVista](#la-gestion-de-session-easyvista)
+- [Les paramètres](#les-paramètres)
+- [Cas particuliers](#cas-particuliers)
+
+---
+
+## 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.
+
+Si aucune session n'est détectée :
+- Un message **"Session EasyVista expirée"** apparaît
+- Cliquer sur **Ouvrir EasyVista** ouvre l'onglet de connexion
+- Une fois connecté, retourner sur l'onglet Planification — la session est détectée automatiquement
+
+Si EasyVista est inaccessible (panne, maintenance) :
+- L'extension affiche les **données du cache local** avec une bannière d'avertissement
+- Cliquer **Réessayer** une fois EV rétabli
+
+---
+
+## La topbar (vue classique)
+
+De gauche à droite :
+
+| Élément | Rôle |
+|---|---|
+| **Pastille initiales** (RQ) | Votre user EasyVista. Cliquer ouvre un popup avec accès aux paramètres et au mode d'affichage |
+| **Planification** | Titre de l'app |
+| **◀ ▶** | Naviguer jour précédent / suivant |
+| **Date custom** (📅) | Affiche le jour sélectionné. Cliquer ouvre un sélecteur de date |
+| **Auj.** | Revient au jour courant |
+| **Synchronisé à HH:MM** | Heure du dernier rafraîchissement |
+| **Date + heure courantes** | Centrées dans la topbar |
+| **Compteur session** | Apparaît à moins de 5 min restantes EV (avec bouton "Prolonger") |
+| **Absence** | Créer une absence pour un ou plusieurs techs |
+| **Douchette** | Envoyer le planning sur la douchette des techs |
+| **Actualiser** | Re-fetch rapide (pas les fiches déjà connues) |
+| **Tout recharger** | Re-fetch complet (planning + fiches) |
+| **Vider cache** | Supprime le cache du jour affiché |
+| **🌙 / ☀️** | Toggle thème clair / sombre |
+
+---
+
+## Les cartes des techniciens
+
+Chaque technicien a une carte qui contient :
+
+### Header
+- **Nom** de la personne
+- **Badge** d'absence si applicable :
+  - 🔴 **Pompier** (rouge) — l'icône reste visible même en vue horizontale
+  - 🟠 **Maladie / Accident** (indigo)
+  - 🔵 **Congé / Congés** (cyan, suffixe "s" si plusieurs jours)
+
+### Body
+- **Note de statut** : "En pompier du XX au YY", "Absent toute la journée — Maladie/Accident", etc.
+- **Timeline horaire** : représentation visuelle des occupations sur la journée (8h-18h par défaut)
+- **Stats** : nombre total d'interventions, répartition matin / après-midi
+- **Liste des interventions** : référence, heure, lieu, contact, catégorie, statut
+- **Séparateur "MATIN" / "APRÈS-MIDI"** pour distinguer visuellement les périodes
+
+### Tri des cartes
+Par défaut :
+1. Pompiers en premier (ils ont la priorité visuelle)
+2. Techs actifs ensuite (ordre alphabétique nom de famille)
+3. Absents en dernier
+
+---
+
+## La timeline
+
+La timeline représente la journée du tech sur une barre horizontale entre 8h et 18h (configurable).
+
+### Lecture
+- **Segment coloré** : intervention ou réservation, la couleur indique la catégorie (livraison, récup, remplacement, incident, rollout, autre)
+- **Bande hachurée grise** : créneau libre
+- **Trait vertical à 12h** : sépare matin et après-midi (visible aussi en vue horizontale)
+- **Cercle vert ✓** sur un segment : intervention clôturée
+- **Outline coloré** : intervention en conflit avec une autre (chevauchement)
+
+### Interactions
+- **Survol d'un segment** (vue classique) : petite popup qui suit la souris avec les infos clés
+- **Clic simple sur un segment** : grande popup persistante (épinglée) avec tout le détail
+- **Double-clic / Ctrl+clic** : ouvre la fiche EasyVista dans un nouvel onglet
+- **Clic sur un trou (bande hachurée)** : popup avec la durée libre (utile pour caser une nouvelle intervention)
+
+En **vue horizontale**, le comportement change :
+- **Survol** = directement la grande popup (pas de petite popup intermédiaire)
+- **Clic** = ouvre la fiche EV (raccourci direct)
+
+---
+
+## Les popups d'intervention
+
+Au survol d'une ligne d'intervention dans la liste, ou d'un segment timeline, un popup détaillé apparaît avec :
+
+| Section | Contenu |
+|---|---|
+| Référence | `S260424_00042` ou `I260424_00042` |
+| Heure | Début → Fin |
+| Lieu | Ville + adresse |
+| Contact | Nom + téléphone (cliquable) |
+| Action | Description complète (chargée à la demande) |
+| Catégorie | Badge coloré |
+| Statut | "En cours", "Clôturé", "Résolu", etc. |
+
+### Boutons
+- **📌 Épingler** : le popup reste ouvert même si on bouge la souris. Permet de comparer plusieurs popups épinglés côte à côte.
+- **📌 Copier la référence** : copie la ref (ex: `S260424_00042`) dans le presse-papiers
+- **↻ Recharger** : re-fetch les données de cette intervention seule (utile pour voir l'évolution du statut sans re-télécharger toute la journée)
+- **Ouvrir** : ouvre la fiche EV dans un nouvel onglet
+
+### Drag-and-drop
+Un popup épinglé peut être **déplacé à la souris**. Plusieurs popups peuvent être empilés et organisés à l'écran selon le besoin du moment (par exemple, comparer 3 interventions).
+
+### Désépinglage
+- **Clic en dehors** d'un popup épinglé : le ferme proprement
+- **Clic 📌** : ré-épingle si désépinglé (mode "soft unpin")
+- **Échap** : ferme tous les popups non-épinglés
+
+---
+
+## Les deux modes d'affichage
+
+L'extension propose deux dispositions pour s'adapter au contexte d'usage :
+
+### Vue classique (cards)
+- Layout en **grille** : 4 colonnes sur écran 24" (compact mode), 3 colonnes sur écran HD
+- Idéale pour avoir le **détail complet** de chaque tech
+- Toutes les interventions listées, popups au survol
+
+### Vue horizontale (rangées)
+- Chaque tech est sur **une seule ligne** : header + timeline pleine largeur
+- Sidebar verticale à gauche (200 px) avec topbar repositionnée
+- Idéale pour avoir une **vue d'ensemble** de l'équipe sur un grand écran (planning de la journée d'un coup d'œil)
+- Les détails des interventions sont accessibles via **survol direct du segment timeline**
+
+### Comment basculer
+1. Clic sur la **pastille des initiales** (en haut à gauche)
+2. Cliquer **"Passer en vue Horizontale"** (ou "Classique" selon le mode actuel)
+
+Le mode est **persisté entre les sessions** (localStorage `view_mode`).
+
+---
+
+## Le badge utilisateur (initiales)
+
+La pastille en haut à gauche affiche les **initiales** de l'utilisateur EasyVista connecté, avec une couleur dérivée du nom (chaque user a sa couleur stable).
+
+### Cliquer dessus ouvre un popup contenant :
+- **Nom complet** de l'utilisateur
+- **Compteur de session** (MM:SS restantes avant expiration EV) avec bouton **🔄 Prolonger**
+- **⊞ Vue** : bascule entre les 2 modes d'affichage
+- **⚙ Paramètres** : ouvre le panel d'administration
+- **"Développé par Quentin Rouiller"** (signature)
+
+### Si la détection user échoue
+Une pastille **grise avec "?"** apparaît. Possible si :
+- Pas connecté à EasyVista
+- EV inaccessible
+- Page intermédiaire SSO en cours
+
+L'extension retente automatiquement toutes les 60 secondes (max 10 essais).
+
+---
+
+## La gestion de session EasyVista
+
+EasyVista expire la session après **30 minutes d'inactivité**. L'extension surveille ce timer en arrière-plan pour vous prévenir.
+
+### Affichage du temps restant
+- **Visible** dans le compteur de session topbar à partir de **5 min** restantes
+- Couleur évoluant : vert → jaune → rouge selon le seuil
+- Aussi visible dans le popup user-badge
+
+### Alertes proactives
+- **À 5 min** : alerte "glissante" douce en haut à gauche (peut être reportée à plus tard)
+- **À 2 min** : alerte urgente bloquante avec bouton **Prolonger**
+- **À 0** : popup "Session expirée — reconnectez-vous"
+
+### Prolonger la session
+- Bouton **🔄 Prolonger** (popup user-badge ou alerte) : envoie un keep-alive et remet le compteur à 30 min
+- Toute action sur EasyVista (visite d'une page, fetch) prolonge automatiquement
+
+### Reconnexion automatique
+Si la session expire et que l'utilisateur se reconnecte sur un autre onglet, l'extension détecte la nouvelle session et **reprend automatiquement** sans rien demander.
+
+---
+
+## Les paramètres
+
+Accès via le bouton **⚙ Paramètres** dans le popup user-badge (clic sur les initiales).
+
+Le panel est divisé en 6 sections :
+
+### 1. Apparence
+- **Thème** : Auto (selon l'OS) / Clair / Sombre
+- **Durée du cache** : combien de jours conserver les anciennes données (défaut 7). Au survol du champ, l'emplacement physique du cache sur le disque s'affiche en infobulle (varie selon Chrome / Firefox + Mac / Windows / Linux)
+- **Taille du texte** : slider 5 paliers (70%, 85%, 100%, 110%, 120%) — le zoom s'applique quand on relâche le curseur (pas pendant le drag, pour éviter l'effet yo-yo)
+- **Heures de la journée** : plage horaire affichée sur la timeline (défaut 8h - 18h)
+
+### 2. Équipe
+Liste des 8 techniciens hardcodés (ID EV + nom). Permet d'exclure temporairement un tech si nécessaire.
+
+### 3. EasyVista
+- Liste des origines (`itsma.etat-de-vaud.ch`, `itsma.vd.ch`)
+- Group ID
+- Configuration des absences récurrentes (ex: Pillonel le vendredi)
+
+### 4. Statuts
+Mots-clés pour identifier les tickets clos / résolus / annulés (ex: "Clôturé", "Terminé", "Résolu").
+
+### 5. Diagnostics
+- Version de l'extension
+- Date courante / Aujourd'hui
+- État de la session EV
+- Nombre de popups épinglés
+- **Logs verbeux (debug)** : toggle pour afficher dans la console (F12) toutes les étapes détaillées (utile pour reporter un bug)
+- **Réinitialiser la configuration** : remet tout aux valeurs par défaut
+
+### 6. À propos
+Version, auteur, affiliation, licence MIT, lien vers le code source (pour les personnes ayant accès).
+
+---
+
+## Cas particuliers
+
+### Pillonel Olivier — absent le vendredi
+Le tech Pillonel Olivier (ID 40944) est configuré comme **absent récurrent tous les vendredis**. Sa carte affiche "Absent le vendredi" avec un badge **cyan** (différent du rouge pompier).
+
+### Tickets fantômes (disparus du planning)
+Quand un ticket disparaît entre deux rafraîchissements (clôturé, déplacé, etc.), l'extension affiche son statut final :
+- ✓ vert simple : clôturé proprement
+- ✓✓ vert double : terminé + déplacé
+- pas d'icône : retiré sans trace claire
+
+### Conflits d'horaire
+Si un tech a 2 interventions au **même créneau** (chevauchement d'heures), un **outline rouge** apparaît sur les segments timeline concernés et un avertissement ⚠ sur les rows.
+
+### Réservations
+Une réservation (créneau bloqué sans intervention concrète) apparaît avec :
+- Couleur **orange clair** sur la timeline
+- Mention "Créé par : `nom_créateur`" dans le détail
+
+### Absences partielles (demi-journée)
+Si un tech est absent **08-12** (matin uniquement), le bloc absence apparaît dans la liste des interventions à sa place chronologique, avec un libellé adapté.
+
+### Mode debug
+Activez **Logs verbeux** dans Diagnostics pour voir dans la console (F12) :
+- Chaque chargement de date avec timing
+- Chaque fetch fiche
+- Étapes de bascule de vue
+- Tentatives de retry sur fetch user
+
+Format : `[HH:MM:SS.mmm][vX.Y.Z][module/prefix][LEVEL] message {context}`
+
+---
+
+## Raccourcis utiles
+
+| Action | Raccourci |
+|---|---|
+| Fermer un popup non-épinglé | Échap |
+| Ouvrir une fiche EV en arrière-plan | Ctrl + clic sur la référence |
+| Ouvrir une fiche EV nouvel onglet | Double-clic sur l'intervention |
+| Bascule de vue | Pastille initiales → ⊞ Vue |
+| Ouvrir paramètres | Pastille initiales → ⚙ Paramètres |
+| Activer le mode debug | Paramètres → Diagnostics → Logs verbeux |