Offline V4/V5 — périmètre

Lien isolé Accueil docs Formation
Mobile POS

Phases offline avancées V4 et V5.

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) :

  1. npm run build
  2. Incrémenter vN : npm run bump:sw (ou éditer manuellement les deux constantes dans public/sw.js)
  3. 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).