Résumé de l’état du projet et suite à prévoir
Document de synthèse : ce qui est déjà fait et ce qui reste à faire selon l’analyse du projet Shop Manager Pro V2 (boutique-app_v2).
Ce qui est déjà fait
1. Version 2 et base de données
- Projet V2 séparé avec préfixe de tables
v2_. - Migrations, modèles, seeders en place.
- Documentation : checklist démarrage, migration V1→V2, scripts de vérification.
2. Interface et menus
- Menu Factures SFN visible (SFN / Factures normalisées).
- Menus principaux collapsibles (groupes repliables).
- En cas de doute d’affichage : rechargement forcé (Ctrl+F5) pour vider le cache navigateur.
3. Configuration réseau et déploiement
- Documentation sous-domaines (
CONFIGURATION_RESEAU.md) : domaine de base, sous-domaines par boutique, DNS, SSL, Apache/Nginx. - Support app.shopmanagerpro.net (ou équivalent) documenté / pris en compte dans la config.
- Optimisation production documentée (
OPTIMISATION_PRODUCTION.md) : cache config/routes/vues, Vite chunks,composer --optimize-autoloader, commandes à lancer avant mise en prod.
4. Mode hors ligne (web + POS mobile)
- Web : fonctionnalité « Mode hors-ligne (POS et Produits) » par boutique ; IndexedDB, API sync (
/api/sync/pull,/api/sync/push), file d’attente et synchronisation au retour de la connexion (MODE_HORS_LIGNE.md). - POS mobile : produits/caisse/ventes en cache ; ventes en attente (
offlineQueue), synchronisation au retour réseau ; impression de facture hors ligne (reçu construit depuis le panier, mis en cache, imprimable sans API). - Sync offline différée au chargement pour ne pas bloquer l’affichage.
5. Produits et import
- Produits alimentaires par défaut : import en un clic + template CSV (
grocery_import_template.csv,IMPORT_PRODUITS_ALIMENTAIRES.md). - Import CSV : colonnes
categorie,nom,prix,unite(alias acceptés) ; création de catégories si besoin. - Champ Unité : option « Autre » avec champ libre pour les boutiques non pharmacie.
- Boutons « Importer produit » / « Importer CSV » : design corrigé (lisibilité, mise en page).
6. Multi-boutiques (jusqu’à 1 000)
- MAX_SHOPS configurable (défaut 1 000) dans
config/app.phpet.env. - Liste des boutiques avec sélecteur « Par page » (20, 50, 100).
- Texte explicatif mis à jour (ex. « 1 000 boutiques »).
ARCHITECTURE_BASE_DONNEES.mdaligné avec cette limite.
7. Exports / modèles Excel
- Modèles d’export documentés (
MODELE_EXPORT_EXCEL.md) : ventes, rapport produits, stock, rapport caisse, format d’import produits. - Templates CSV dans
database/data/export_templates/(ventes, produits, stock, rapport caisse) pour Excel. - Exports CSV existants (rapports) avec BOM UTF-8 pour Excel.
8. Factures conformes DGI (SFN)
- Structure facture : en-tête (RCCM, NIF, adresse, etc.), corps (FACTURE, lignes, totaux), bloc DGI (code fiscal + QR), paiement, pied de page (
FACTURE_DGI.md,SFN_DGI_INTEGRATION.md). - SFN en simulation : création automatique de factures SFN depuis les ventes (POS + API), brouillon → verrouiller → envoyer → job → provider NullSfnProvider (code fiscal + QR simulés) → statut accepté → impression et archivage.
- Reçus web :
receipt-thermal.blade.phpetreceipt.blade.phpreçoivent code fiscal et QR depuis la facture SFN acceptée liée à la vente (variablesdgiFiscalCode,dgiQrData). - API mobile :
GET /pos/sales/{id}/receiptrenvoiefiscal_codeetqr_payloadquand une facture SFN acceptée existe pour la vente. - POS mobile : reçu HTML affiche code fiscal et QR (via
fiscal_code/qr_payload) ; ventes hors ligne affichent le libellé « QR DGI (SFN) — à intégrer » tant qu’il n’y a pas de facture SFN.
9. Performance et cache
- Cache des fonctionnalités activées par boutique (middleware Inertia), invalidé à la modification des features.
- Vite : découpage des chunks (
vue-vendor,ui-vendor), minification, pas de source maps en prod. - Sync hors ligne différée (après rendu) pour un chargement perçu plus rapide.
10. API mobile POS
- Authentification (login/logout, token Bearer), produits, catégories, caisse (statut, ouverture, fermeture), ventes (création, récentes, reçu).
- Gestion des erreurs réseau et repli sur cache (produits, ventes, ticket, reçu).
- Documentation détaillée dans
API_MOBILE_POS.md.
Ce qui reste à faire (analyse)
1. Intégration SFN réelle DGI
- À faire : implémenter DgiSfnProvider (ou équivalent) qui appelle l’API réelle de la DGI (URL, auth, format requête/réponse selon leur doc).
- À faire : configurer en prod (
SFN_PROVIDER=dgi,DGI_SFN_BASE_URL, clés, etc.) et basculer le binding du provider dansAppServiceProvider. - Déjà prêt : contrat
SfnProvider, jobSendSfnInvoiceJob, payload et flux métier (brouillon → envoi → code fiscal + QR) ; il reste le branchement HTTP vers la DGI.
2. Ventes hors ligne et SFN
- Optionnel / à préciser : après synchronisation des ventes hors ligne, générer (ou lier) les factures SFN pour ces ventes (création brouillon, puis verrouillage/envoi comme en ligne). Dépend de la règle métier (facturation à la sync vs à la vente).
3. Tests et qualité
- Recommandé : tests automatisés (PHPUnit/Feature) pour les parcours critiques : login, ventes, sync offline, SFN (simulation), exports.
- Recommandé : tests E2E ou manuels du POS mobile (hors ligne, impression, historique, reçu DGI).
4. Déploiement et infra
- À faire : déploiement effectif (serveur, domaine, SSL,
php artisanoptimisations,npm run build, file d’attente des jobs, cron pour scheduler). - À faire : configuration réelle des sous-domaines / DNS si multi-boutiques par sous-domaine.
- À faire : sauvegardes BDD et fichiers, politique de rétention des logs.
5. Sécurité et conformité
- Vérifier : politique de mots de passe, durée de validité des tokens, éventuelle 2FA si exigée.
- Vérifier : conformité RGPD / locale pour données clients et logs (anonymisation, droit à l’oubli si applicable).
6. Documentation utilisateur
- Optionnel : mettre à jour le guide utilisateur / captures d’écran pour V2 (SFN, mode hors ligne, import produits, limite 1 000 boutiques).
- Optionnel : courte FAQ « Démarrage V2 » à partir de la checklist existante.
7. Améliorations possibles (non bloquantes)
- QR DGI : si la DGI impose une URL ou un format de QR précis, adapter la génération (service externe vs librairie) côté web et mobile.
- Imprimantes thermiques : tester et documenter la configuration (pilotes, largeur 58mm/80mm) en conditions réelles.
- Notifications : alertes stock bas, échecs de sync, ou rappels (email/push) selon besoins métier.
Synthèse
| Domaine | État actuel | Prochaine étape prioritaire |
|---|---|---|
| V2 / BDD | En place | - |
| Menus / UI | OK | - |
| Réseau / sous-domaines | Documenté | Config réelle serveur/DNS |
| Mode hors ligne | Web + mobile opérationnels | Tests E2E / scénarios réels |
| Produits / import | Alimentaire + CSV + Unité « Autre » | - |
| Multi-boutiques | Jusqu’à 1 000, pagination | - |
| Exports / Excel | Modèles doc + templates CSV | - |
| Factures DGI | Structure + SFN simulation | Provider DGI réel + config prod |
| Performance | Cache + Vite + sync différée | - |
| API mobile POS | Complète + cache + reçu DGI | Tests offline / impression |
| Production | Doc optimisations | Déploiement + backups + monitoring |
En résumé : le socle V2, le mode hors ligne, les factures conformes DGI (structure + simulation SFN) et le POS mobile (y compris impression hors ligne) sont en place. Les prochaines priorités sont l’intégration du provider SFN réel DGI, le déploiement et la configuration serveur, et des tests (SFN, offline, impression) pour valider la mise en production.