PWA (Progressive Web App)
Type : fiche technologie Statut : validée (implémentation retenue) Décision : 2026-03-11
Résumé
Une PWA est un site web amélioré qui se comporte comme une application : installation possible, accès plus stable et lecture même quand la connexion est faible.
Ce que c'est, en clair
Une PWA reste du web : elle s'ouvre dans le navigateur et bénéficie des atouts du web (liens, référencement, accessibilité). Elle ajoute deux capacités clés : l'installation sur l'écran d'accueil et un fonctionnement partiel hors ligne grâce à une mise en cache maîtrisée.
Intérêt pour Codexia
- Lecture de la documentation en mobilité, même sans réseau fiable.
- Accès direct depuis une icône, sans passer par le navigateur.
- Expérience plus fluide pour les contenus consultés régulièrement.
- Signal visible de qualité web et de soin apporté aux usages.
Cas d'usage cibles
- Consultation en déplacement, en audit ou en rendez-vous client.
- Démonstration hors connexion des guides clés.
- Accès rapide aux procédures d'exploitation.
Impacts et contraintes
- Gestion des contenus mis en cache pour Ă©viter l'obsolescence.
- Besoin d'un message clair quand le contenu est hors ligne.
- Tests spécifiques : première visite, mode avion, mise à jour.
Implémentation (vue d'ensemble)
- Phase 1 : identité de l'application (nom, icônes, écran d'installation).
- Phase 2 : accès hors ligne simple pour les pages clés.
- Phase 3 : mise à jour maîtrisée et communication à l'utilisateur.
Périmètre minimal (MVP)
- Fichier de description de l'application (manifest).
- Cache des pages de documentation les plus consultées.
- Page de secours hors ligne, claire et accessible.
Non objectifs
- Notifications push.
- Publication sur un store.
Critères de réussite
- Gain d'usage observé (installation, accès hors ligne).
- Coût de maintenance raisonnable.
- Aucune dégradation SEO ou accessibilité.
Documents associés
- Panorama des options
- PWA - Implémentation
- Apps natives (iOS/Android)
- Cross-platform natif
- Hybrid WebView
- Desktop wrapper
Prochaine Ă©tape
- Démarrer la phase 1 et valider le périmètre des pages clés.
Implémentation
| Aspect | Localisation |
|---|---|
| Statut | Conceptuel — implémentation à démarrer (cf. pwa-implementation.md) |
| Manifest | public/manifest.webmanifest dans telaria-app (à créer) |
| Service Worker | public/sw.js dans telaria-app (à créer) |
| Intégration | templates/base.html.twig dans telaria-app |
Historique des décisions
| Version | Date | DĂ©cision |
|---|---|---|
| 1.0 | 2026-06-14 | Version initiale — première formalisation du versioning des specs. |
| — | 2026-03-11 | PWA retenue comme technologie cible (cf. pwa-panorama.md). Statut : validée, implémentation à venir. |