PWA - Implémentation (plan d'action)

Statut : à implémenter Décision : 2026-03-11 Périmètre : telaria (application web)

Objectif

Mettre en place une PWA utile dès le premier usage, sans complexité inutile, en privilégiant l'accès hors ligne aux pages les plus consultées.

Principes de mise en œuvre

• Simplicité : commencer petit et étendre ensuite.
• Transparence : l'utilisateur sait quand il est hors ligne.
• Qualité : aucune régression de référencement ni d'accessibilité.

Étapes proposées

1. Définir les pages clés à rendre disponibles hors ligne (accueil, guides prioritaires, glossaire).
2. Créer l'identité de l'application : nom, icônes, couleurs, écran d'installation.
3. Ajouter le fichier de description de l'application et les liens dans le gabarit principal.
4. Activer le script de gestion du cache (service worker) pour les pages clés.
5. Prévoir une page hors ligne simple, claire et accessible.
6. Mettre en place une mise à jour contrôlée : nettoyage de l'ancien cache et message utilisateur.
7. Valider la qualité par un audit PWA et des scénarios hors ligne.

Livrables

• public/manifest.webmanifest : description lisible par le navigateur.
• Icônes aux formats requis (mobile et bureau).
• public/sw.js : script qui gère le cache local.
• public/offline.html : page de secours.
• Intégration dans base.html.twig.

Règles de cache (exprimées simplement)

• Priorité au contenu local pour les pages de documentation, avec vérification en arrière-plan.
• Priorité au réseau pour la recherche et les pages dynamiques.
• Mise en cache systématique des fichiers statiques versionnés.

Tests attendus

• Première visite en ligne.
• Bascule en mode avion.
• Mise à jour après une nouvelle version.

Risques connus

• Contenu obsolète si le cache n'est pas rafraîchi.
• Stockage local limité sur mobile.

Prochaine étape

• Cadrer la liste des pages clés et valider les icônes.

Implémentation

Historique des décisions