Analyse POS mobile

Lien isolé Accueil docs Formation
Mobile POS

Analyse technique et fonctionnelle de l'application POS mobile.

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

  1. Choisir le SDK : Sunmi SDK, PAX SDK, etc., selon le modèle choisi.
  2. Créer un module natif : react-native-sunmi-inner-printer ou équivalent.
  3. Adapter le format : receiptHtml.ts produit déjà du HTML 58 mm ; à convertir en commandes ESC/POS.
  4. 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)

  1. Remplacer ton-domaine.com par l’URL de production.
  2. Générer un APK de test : eas build --platform android (ou expo build).
  3. Tester sur un vrai terminal Android (Expo Go ou APK).

Phase 2 — Moyen terme (3–6 semaines)

  1. Acquérir et configurer un terminal (Sunmi ou PAX).
  2. Intégrer le SDK correspondant.
  3. Implémenter l’impression thermique pour les reçus et le ticket général.
  4. Ajouter le cache produits pour le mode hors ligne.

Phase 3 — Long terme (2–3 mois)

  1. Implémenter le QR Code DGI (SFN) si exigé.
  2. Enrichir les méthodes de paiement (carte, mobile money).
  3. 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.