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_NAMEdanspublic/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.