title: "Addendum 14 — Application Mobile PWA + Capacitor (WS11)" date: "2026-08-31" author: "Équipe Plateforme GoWeBa" tags: ["pwa", "mobile", "capacitor", "service-worker", "offline", "natif"]
Addendum 14 — Application Mobile PWA + Capacitor
Vue d'ensemble
GoWeBa est désormais une Progressive Web App (PWA) complète, installable sur n'importe quel appareil mobile ou ordinateur. Grâce à l'intégration de Capacitor, l'application peut également être compilée en application native iOS et Android pour distribution via l'App Store et Google Play.
Service Worker
Un Service Worker intelligent gère la mise en cache et le fonctionnement hors ligne :
| Stratégie | Ressources | Comportement |
|---|---|---|
| Cache-first | CSS, JS, images, polices | Chargement instantané depuis le cache, mise à jour en arrière-plan |
| Network-first | Appels API (/api/) | Données fraîches, fallback cache si hors ligne |
| Offline fallback | Pages HTML | Page hors ligne dédiée si ni réseau ni cache |
Pré-cache (App Shell)
Les ressources critiques sont pré-cachées à l'installation :
- Page d'accueil (
/) - Tableau de bord (
/dashboard) - Page hors ligne (
/offline) - Icônes et manifest
Mode hors ligne
Quand l'utilisateur perd la connexion :
- Les pages déjà visitées restent accessibles depuis le cache
- Les données API récemment consultées sont servies depuis le cache
- Si aucun cache n'est disponible, une page hors ligne dédiée s'affiche avec un bouton « Réessayer »
Installation PWA
L'application peut être installée directement depuis le navigateur :
- Mobile : Bannière « Ajouter à l'écran d'accueil » ou via le menu du navigateur
- Desktop : Bouton d'installation dans la barre d'adresse (Chrome, Edge)
Raccourcis rapides
Une fois installée, l'application propose des raccourcis :
- 📊 Tableau de bord — Accès direct
- 👥 Contacts — Gestion des contacts
- 💬 Conversations — Messagerie unifiée
Notifications push
Le Service Worker prend en charge les notifications push :
- Réception en arrière-plan même quand l'app est fermée
- Clic sur notification → ouvre la page concernée
- Icône et branding GoWeBa
Capacitor — Applications natives
Grâce à Capacitor (Ionic), GoWeBa peut être compilée en application native :
| Plateforme | App ID | Status |
|---|---|---|
| iOS | com.goweba.app | Prêt à compiler |
| Android | com.goweba.app | Prêt à compiler |
Fonctionnalités natives accessibles
- Notifications push natives (APNs / FCM)
- Splash screen personnalisé
- Barre de statut intégrée
- Accès caméra, géolocalisation, stockage
- Retour haptique
Configuration technique
Manifest : /manifest.json
Service Worker : /sw.js (scope: /)
Capacitor Config : capacitor.config.ts
Page offline : /offline
Prérequis pour compilation native
- Installer Capacitor CLI :
npm install @capacitor/cli @capacitor/core - Ajouter les plateformes :
npx cap add ios/npx cap add android - Synchroniser :
npx cap sync - Ouvrir dans l'IDE natif :
npx cap open ios/npx cap open android
Addendum 14 — Août 2026 — Workstream 11 (Mobile PWA + Capacitor)