Analyse professionnelle — POS Mobile ShopManager Pro
Date : Février 2026
Version : 1.0
Objectif : Bilan des réalisations et feuille de route pour la suite du projet.
1. Résumé exécutif
L’application POS mobile (Expo/React Native) est opérationnelle pour les cas d’usage principaux : authentification, gestion de caisse, ventes, rapports et impression. La base est solide. Les prochaines étapes concernent surtout l’impression thermique native sur terminaux Android (Sunmi, PAX, etc.) et quelques améliorations fonctionnelles.
2. Réalisé
2.1 Authentification et configuration
| Fonctionnalité |
Statut |
Détails |
| Login par code boutique + email + mot de passe |
✅ |
API /auth/login |
| Code boutique auto-généré à la création |
✅ |
Format type B0001, B0002… |
| Stockage sécurisé du token (SecureStore) |
✅ |
|
| Affichage du mot de passe (œil) |
✅ |
|
| Nom de la boutique sur l’écran d’accueil |
✅ |
Sous « Bienvenue » |
2.2 Gestion de caisse
| Fonctionnalité |
Statut |
Détails |
| Ouverture / fermeture de session |
✅ |
API /cash/open, /cash/close |
| Session partagée multi-terminaux |
✅ |
Web + mobile, même boutique |
| Blocage des ventes si caisse fermée |
✅ |
Alerte + empêche ajout au panier |
| Statut en temps réel |
✅ |
getCashStatus() |
2.3 Point de vente
| Fonctionnalité |
Statut |
Détails |
| Grille produits avec recherche |
✅ |
Debounce 400 ms |
| Panier professionnel |
✅ |
Modal, qté, suppression |
| Finalisation de vente |
✅ |
API completeSale |
| Message hors ligne (remplacement Network Error) |
✅ |
« Vente enregistrée, synchronisation à la reconnexion » |
| File d’attente hors ligne |
✅ |
offlineQueue.ts, sync auto |
2.4 Factures et reçus (DGI)
| Fonctionnalité |
Statut |
Détails |
| Format facture aligné web |
✅ |
receiptHtml.ts conforme à receipt-thermal.blade.php |
| Mentions DGI (RCCM, NIF) |
✅ |
Paramètres boutique, API receipt |
| Impression reçu après vente |
✅ |
Option dans l’alerte de succès |
| Impression reçu depuis historique |
✅ |
Modal Imprimer / Exporter PDF |
| Export PDF reçu |
✅ |
expo-print + expo-sharing |
2.5 Ticket général
| Fonctionnalité |
Statut |
Détails |
| Sélecteur de dates (date picker) |
✅ |
Correction décalage fuseau (06 → 05) |
| Rapport par période |
✅ |
Chiffre d’affaires, tickets, articles |
| Liste des utilisateurs ayant travaillé |
✅ |
API users_worked |
| Impression ticket général |
✅ |
Bouton « Imprimer » |
| Export PDF ticket général |
✅ |
Bouton « Exporter PDF » |
2.6 Interface et UX
| Fonctionnalité |
Statut |
Détails |
| Design professionnel |
✅ |
Login, Home, POS, Caisse |
| Bouton Retour visible |
✅ |
SafeAreaView, hitSlop (Caisse, POS, Ticket) |
| Historique des ventes |
✅ |
Liste récente, pull-to-refresh |
3. Partiel / À compléter
| Élément |
État |
Action requise |
| Mode hors ligne |
✅ Complet |
Cache produits (AsyncStorage), sync auto au retour réseau, pull-to-refresh, AppState |
| Configuration API production |
Placeholder |
Remplacer ton-domaine.com dans api.ts par l’URL réelle |
4. À faire (priorisé)
Priorité haute
| # |
Tâche |
Complexité |
Impact |
| 1 |
Impression thermique native |
Élevée |
Essentiel pour terminaux type Sunmi/PAX |
| 2 |
Intégration SDK terminal |
Élevée |
Sunmi, PAX ou autre selon le matériel |
| 3 |
Build APK Android |
Moyenne |
Déploiement sur terminaux physiques |
Priorité moyenne
| # |
Tâche |
Complexité |
Impact |
| 4 |
Cache produits hors ligne |
✅ Fait |
Ventes sans connexion |
| 5 |
QR Code DGI |
Moyenne |
Conformité SFN/DGI |
| 6 |
Méthodes de paiement multiples |
Moyenne |
Carte, mobile money |
Priorité basse
| # |
Tâche |
Complexité |
Impact |
| 7 |
Mode sombre |
Faible |
Confort |
| 8 |
Statistiques en temps réel |
Moyenne |
Tableau de bord |
| 9 |
Notifications push |
Moyenne |
Alertes stock, sessions |
5. Impression thermique — détail technique
Situation actuelle
- Imprimantes classiques / PDF :
expo-print + Print.printAsync() → dialogue système.
- Imprimantes thermiques intégrées : non gérées nativement.
Pour les terminaux Sunmi / PAX
- Choisir le SDK : Sunmi SDK, PAX SDK, etc., selon le modèle choisi.
- Créer un module natif :
react-native-sunmi-inner-printer ou équivalent.
- Adapter le format :
receiptHtml.ts produit déjà du HTML 58 mm ; à convertir en commandes ESC/POS.
- Détection du terminal : détecter Sunmi/PAX pour activer l’impression native, sinon garder
expo-print.
Options possibles
| Option |
Avantages |
Inconvénients |
| A. Module natif dédié |
Contrôle total, performance |
Développement spécifique |
| B. react-native-pos-printer |
Communauté |
Support limité |
| C. Expo dev client + module natif |
Flexibilité |
Expo Go ne suffit pas |
6. Roadmap recommandée
Phase 1 — Court terme (1–2 semaines)
- Remplacer
ton-domaine.com par l’URL de production.
- Générer un APK de test :
eas build --platform android (ou expo build).
- Tester sur un vrai terminal Android (Expo Go ou APK).
Phase 2 — Moyen terme (3–6 semaines)
- Acquérir et configurer un terminal (Sunmi ou PAX).
- Intégrer le SDK correspondant.
- Implémenter l’impression thermique pour les reçus et le ticket général.
- Ajouter le cache produits pour le mode hors ligne.
Phase 3 — Long terme (2–3 mois)
- Implémenter le QR Code DGI (SFN) si exigé.
- Enrichir les méthodes de paiement (carte, mobile money).
- Ajouter des statistiques et rapports avancés.
7. Structure actuelle du projet mobile
pos-mobile/
├── src/
│ ├── config/
│ │ └── api.ts # URL API (à adapter en prod)
│ ├── screens/
│ │ ├── LoginScreen.tsx
│ │ ├── HomeScreen.tsx
│ │ ├── PosScreen.tsx
│ │ ├── CashScreen.tsx
│ │ ├── TicketScreen.tsx
│ │ └── SalesHistoryScreen.tsx
│ ├── services/
│ │ ├── api.ts
│ │ └── offlineQueue.ts
│ └── utils/
│ └── receiptHtml.ts # Génération HTML reçu DGI
├── App.tsx
└── package.json
8. Conclusion
Ce qui est prêt : authentification, caisse, ventes, rapports, impression via le système (PDF, imprimantes classiques). L’application est utilisable pour une exploitation quotidienne sur smartphone ou tablette.
Ce qui manque pour un déploiement complet sur terminaux : impression thermique native via SDK (Sunmi, PAX, etc.) et build APK.
Prochaine étape : choisir le modèle de terminal (Sunmi, PAX, autre) et intégrer le SDK correspondant pour l’impression thermique.