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é
- Vision globale & périmètre réel →
OFFLINE_V1_PERIMETER.md
- Plan briques & parcours métier →
PLAN_PERIMETRES_OFFLINE.md
- Ventes / historique / UX sync (v3 — clos) →
OFFLINE_V3_PERIMETER.md
- Clôture qualité + Service Worker (v4 / v5) →
OFFLINE_V4_V5_PERIMETER.md
- 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
- Boutique avec feature
offline_mode + forfait growth+ (dettes / fulfillment) ; ouvrir le POS en ligne (sync Dexie + clients).
- DevTools → Network → Offline (ou pastille « forcer hors ligne »).
- Session caisse ouverte → vente payée emporter et crédit / à retirer / tempérament (client en cache).
- Page À retirer / Tempérament : Remettre ou Abandon sur une ligne locale « en attente de sync ».
- Repasser Online → sync → vérifier vente, dette, statut handed/forfeited côté serveur.