Plan périmètres offline

Lien isolé Accueil docs Formation
Mobile POS

Roadmap et planification des périmètres mode hors ligne.

Plan de réalisation — périmètres mode hors ligne & terrain

Référence principale : docs/OFFLINE_V1_PERIMETER.md. Index de navigation : docs/OFFLINE_MASTER_INDEX.md. Ce document résume l’état d’avancement des grands blocs (parcours métier + livrables techniques listés comme « prochaines étapes »).


1) Parcours métier (POS, inventaire, clients & dettes, caisse, liste ventes)

Priorité Parcours Déjà en place (résumé) Reste / durcissement
P0 POS / vente MVP avancé : catalogue Dexie, file pos_sales (payé + crédit + held), Remettre/Abandon locaux, UX sync POS Cas limites stock / Remettre serveur-only hors ligne
P0 Inventaire / produits Catalogue sync, formulaires legacy avec file d’attente Médias lourds, import masse restent hors périmètre v1
P1 Clients & dettes Pull clients/dettes, push debt_payment, formulaires Création dette « manuelle » offline si absent de l’API
P1 Caisse Ouverture / fermeture / mouvements offline + session virtuelle + miroir Dexie PDF rapports côté serveur uniquement (inchangé)
P2 Liste ventes Ventes récentes en cache Export compta avancé hors v1

Règle : toute page hors liste = en ligne requise ou message explicite (bannière / offlineV1Routes.js).


2) Les « 5 » briques techniques (backlog v1 dans OFFLINE_V1_PERIMETER)

# Brique Statut Détail
1 Routes v1 (offlineV1Routes.js) Fait Référence unique pour pages utilisables hors ligne
2 Messages UI (bannière AppLayout.vue) Fait Hors URLs couvertes v1
3 Tests SyncController Fait Catalogue, pull, caisse, POS, dettes (debt_payment), etc.
4 Page État sync (/offline/sync-status) Fait Lien administration / Ventes & Caisse
5 Service Worker (public/sw.js) Clôture v5 Politique documentée + tests ServiceWorkerCacheVersionTest — voir docs/OFFLINE_V4_V5_PERIMETER.md ; incrémenter CACHE_NAME / RUNTIME_CACHE à chaque livraison front

3) Périmètre v2 (achats / fournisseurs)

Implémentation prête (sync, UI purchasesLegacy.js, routes /purchases & /suppliers, tests dédiés). Clôture v2 = recette terrain + bump public/sw.js quand on livre le front — voir checklist dans docs/OFFLINE_V1_PERIMETER.md (section « Finition v2 »).

3bis) Périmètre v3

Clôturé — détail des phases A–E, extensions (fiches dette / fournisseur, cache SW associé) et critères de fin : docs/OFFLINE_V3_PERIMETER.md. La suite (v4 qualité / recette, v5 SW & PWA formalisés) relève de docs/OFFLINE_V4_V5_PERIMETER.md.


4) Suivi rapide

  • Une seule brique sync : App\Http\Controllers\Api\SyncController (pull / push).
  • Activation : feature offline_mode + plans (OfflineModeAccess, config/offline.php).
  • Prochaine action récurrente : après modification des assets front (POS, caisse, achats), bump CACHE_NAME dans public/sw.js (node scripts/bump-sw-cache.mjs) pour que les PWA reçoivent les derniers JS/CSS.
  • MVP web avancé (POS + caisse) : voir section dédiée dans docs/OFFLINE_MASTER_INDEX.md.

5) Jalons v4 & v5 (clôture)

Jalon Rôle
v4 Qualité : tests ciblés, alignement documentation, préparation recette.
v5 5ᵉ brique technique : Service Worker & déploiement PWA (politique CACHE_NAME / RUNTIME_CACHE, garde-fous).

Détail : docs/OFFLINE_V4_V5_PERIMETER.md.


Document généré pour la planification interne ; à ajuster selon les retours terrain.