Périmètres v4 & v5 — clôture mode hors ligne (ShopManager Pro)
Ce document fixe le sens des jalons v4 / v5 par rapport au plan initial (docs/PLAN_PERIMETRES_OFFLINE.md) et aux versions v1 → v3 déjà décrites ailleurs.
Cartographie des jalons (vue d’ensemble)
| Jalon | Contenu principal | Document de référence |
|---|---|---|
| v1 | Noyau terrain : sync unique, routes offlineV1Routes.js, bannière, file locale |
docs/OFFLINE_V1_PERIMETER.md |
| v2 | Achats / fournisseurs (pull/push + UI legacy) | Section v2 dans OFFLINE_V1_PERIMETER.md |
| v3 | Ventes liste & détail hors ligne, UX sync (toasts, compteurs), cache SW ventes | docs/OFFLINE_V3_PERIMETER.md |
| v4 | Qualité & traçabilité : tests ciblés supplémentaires, alignement des docs, recette structurée | Ce document (section v4) |
| v5 | Périmètre technique n°5 (plan initial) : Service Worker & déploiement PWA — politique de version, vérifications automatisables | Ce document (section v5) |
Les 5 briques techniques listées dans PLAN_PERIMETRES_OFFLINE.md (routes, UI, tests, page état sync, SW) restent la base ; la 5ᵉ (SW) est fermée par le périmètre v5 ci‑dessous.
v4 — Qualité, tests, documentation
| Livrable | Statut |
|---|---|
| Documentation unique reliant v1 → v5 | Ce fichier + mises à jour PLAN_PERIMETRES_OFFLINE.md |
Tests Feature : page /offline/sync-status accessible (auth + abonnement actif) |
tests/Feature/OfflineSyncStatusPageTest.php |
Tests Feature : POST /api/sync/push avec ops: [] (contrat file vide) |
tests/Feature/SyncControllerPushEmptyTest.php |
Tests Feature : push sans droit offline → 403 |
OfflineModeAccessTest::test_sync_push_returns_403_without_entitlement |
Tests : cohérence minimale de public/sw.js (constantes de cache versionnées) |
tests/Unit/ServiceWorkerCacheVersionTest.php |
| Index navigation doc offline | docs/OFFLINE_MASTER_INDEX.md |
Script npm run bump:sw |
scripts/bump-sw-cache.mjs |
| Recette terrain (manuelle) : liste ventes, fiche vente, sync, toasts | Checklist récurrente OFFLINE_V3_PERIMETER phase E |
Hors v4 : duplication complète du SaaS hors ligne, SFN offline, gros exports PDF.
v5 — Service Worker & déploiement PWA (brique 5)
| Règle | Détail |
|---|---|
| Source de vérité | public/sw.js : CACHE_NAME et RUNTIME_CACHE doivent partager le même indice de version (vN). |
| Quand bump | Après npm run build ou toute livraison qui modifie les assets PWA (/build/*) ou la logique SW. |
| Vérification CI | ServiceWorkerCacheVersionTest garantit la présence et le format des constantes. |
| Fallback hors ligne | offline.html / stratégie réseau inchangés sauf décision produit. |
| Sync & Inertia | Ne pas envelopper GET /api/sync/* (pull) ni les requêtes avec X-Inertia : évite une 504 factice « Hors ligne » côté SW — aligné avec la sync Dexie après connexion (app.js + sync.js). |
Checklist release (récurrent) :
npm run build- Incrémenter
vN:npm run bump:sw(ou éditer manuellement les deux constantes danspublic/sw.js) - Déployer ; les clients PWA récupèrent le nouveau SW au prochain chargement (ou après « Mettre à jour »)
État : périmètre v5 « complet »
- Politique documentée (ce fichier).
- Garde-fous automatisés sur
sw.js. - Page État synchronisation couverte par un test d’accès.
- Les jalons v1–v3 restent la référence fonctionnelle ; v4–v5 closent qualité + SW.
Dernière mise à jour : clôture v4/v5 (tests + doc).