Index documentation offline

Lien isolé Accueil docs Formation
Mobile POS

Index central des documents mode hors ligne (V1–V5, périmètres).

Index — documentation mode hors ligne (ShopManager Pro)

Point d’entrée unique pour naviguer entre les documents offline (terrain, sync, PWA).


Parcours de lecture recommandé

  1. Vision globale & périmètre réel → OFFLINE_V1_PERIMETER.md
  2. Plan briques & parcours métier → PLAN_PERIMETRES_OFFLINE.md
  3. Ventes / historique / UX sync (v3 — clos) → OFFLINE_V3_PERIMETER.md
  4. Clôture qualité + Service Worker (v4 / v5) → OFFLINE_V4_V5_PERIMETER.md
  5. POS mobile (local-first, SQLite) → OFFLINE_POS_MOBILE_LOCAL_FIRST.md

Fichiers par thème

Sujet Fichier
Cadre v1, v2 achats, lien v3 docs/OFFLINE_V1_PERIMETER.md
POS mobile : actions locales visibles sans sync (SQLite / file) docs/OFFLINE_POS_MOBILE_LOCAL_FIRST.md
Tableau de suivi plan 5 briques docs/PLAN_PERIMETRES_OFFLINE.md
Phases A–E v3 + clôture (liste/détail ventes, toasts, extensions dettes/fournisseurs) docs/OFFLINE_V3_PERIMETER.md
Jalons v4 / v5, checklist release SW docs/OFFLINE_V4_V5_PERIMETER.md
Routes JS « capables hors ligne » resources/js/offline/offlineV1Routes.js
Sync API app/Http/Controllers/Api/SyncController.php
Service Worker public/sw.js (cache HTML ciblé : ventes, dettes, achats, fournisseurs, ticket POS — après visite en ligne ; voir OFFLINE_V3_PERIMETER.md)

Tests automatisés (extraits)

Fichier Rôle
tests/Feature/SyncControllerPullTest.php Pull incrémental
tests/Feature/SyncControllerPushEmptyTest.php Push avec ops: [] (file vide)
tests/Feature/OfflineSyncStatusPageTest.php Page /offline/sync-status
tests/Feature/SyncControllerPurchasesSuppliersTest.php Sync achats / fournisseurs
tests/Unit/ServiceWorkerCacheVersionTest.php Constantes CACHE_NAME / RUNTIME_CACHE

Scripts utiles

Commande Rôle
npm run build Build Vite (/build/* pour PWA)
npm run bump:sw Incrémente vN dans public/sw.js (après build, avant déploiement)

Dernière mise à jour : v1–v3 fonctionnels clos ; v4 (qualité) et v5 (Service Worker / PWA) documentés comme clos dans OFFLINE_V4_V5_PERIMETER.md. Évolutions hors périmètre : recette terrain récurrente, cas limites POS, SFN / export lourd hors ligne — voir PLAN_PERIMETRES_OFFLINE.md.


MVP hors-ligne web avancé (POS + caisse) — livré

Alignement du POS web et de la session caisse locale sur les patterns déjà éprouvés (Dexie + sync_queue + SyncController, inspiré pos-mobile).

Ce qui fonctionne hors ligne (feature offline_mode)

Parcours Comportement
Catalogue POS Lecture depuis le cache Dexie (hydratation grille si hors ligne / grille vide) + scan code-barres local
Vente POS payée (emporté) Mise en file pos_sales + miroir local sales / sale_items + décrément stock local ; sync auto au retour réseau
Crédit / acompte File pos_sales avec payment_status unpaid/partial + client en cache Dexie (modal FR si client absent) ; gardes plan debts
À retirer / tempérament Création held en file + cache Dexie held_fulfillment_sales ; page /fulfillment/held : Remettre / Abandon en file fulfillment_hand_over / fulfillment_forfeit ; gardes plan fulfillment_held
Session caisse Ouverture / fermeture / mouvements en file (cash_session_open, cash_session_close, cash_movement) + session virtuelle localStorage
UX Pastille En ligne / Hors ligne + compteur « en attente de sync » sur le POS ; bannière AppLayout ; page /offline/sync-status
SW Cache HTML ciblé après visite (POS, caisse, fulfillment, listes terrain) + assets /build/* ; CACHE_NAME v39+

Limites restantes (hors MVP)

  • Création client, impression ticket, rapports / dashboards complets : en ligne
  • Remettre / Abandon sur ventes déjà synchronisées (id serveur) hors ligne : message clair — reconnectez-vous (MVP : actions offline sur ventes locales held)
  • Navigation Inertia XHR pure hors ligne : bascule en rechargement document (cache SW) sur les routes v1

Fichiers clés MVP

Zone Fichiers
Vente locale resources/js/offline/posOfflineSale.js
Fulfillment offline resources/js/offline/fulfillmentOffline.js, fulfillmentHeldLegacy.js
Catalogue POS resources/js/offline/posCatalogLocal.js
Coquilles SW resources/js/offline/warmOfflineShells.js, public/sw.js
UI POS resources/views/sales/pos.blade.php
UI held resources/views/sales/fulfillment-held.blade.php
Caisse resources/js/offline/cashLegacy.js, cashSessionLocal.js
Sync API app/Http/Controllers/Api/SyncController.php (pos_sales, fulfillment_*)

Recette manuelle rapide

  1. Boutique avec feature offline_mode + forfait growth+ (dettes / fulfillment) ; ouvrir le POS en ligne (sync Dexie + clients).
  2. DevTools → Network → Offline (ou pastille « forcer hors ligne »).
  3. Session caisse ouverte → vente payée emporter et crédit / à retirer / tempérament (client en cache).
  4. Page À retirer / Tempérament : Remettre ou Abandon sur une ligne locale « en attente de sync ».
  5. Repasser Online → sync → vérifier vente, dette, statut handed/forfeited côté serveur.