📚 Documentation

📱
Documentation Mobilosoft Mobile

Bienvenue dans la documentation technique complète de l'application mobile Mobilosoft. Cette documentation couvre l'architecture, les fonctionnalités, les API et tous les aspects techniques de l'application Flutter.

📊
Vue d'ensemble du projet

81+
Écrans UI
56
Modèles de données
19
Repositories
50+
Endpoints API
14
Handlers
3
Environnements

🎯
Qu'est-ce que Mobilosoft ?

Mobilosoft est une application mobile Flutter professionnelle destinée à la gestion de présence locale et au marketing digital pour les entreprises multi-sites. Elle permet aux gérants de magasins, franchises et réseaux de points de vente de centraliser la gestion de leur présence en ligne.

💡
Cas d'usage principal

Un responsable de magasin peut, depuis son smartphone, mettre à jour ses horaires sur Google, Facebook et Apple Maps simultanément, répondre aux avis clients avec l'aide de l'IA, et publier des campagnes marketing sur les réseaux sociaux.

Fonctionnalités principales

🏪
Gestion Multi-Sites
Gérez plusieurs établissements depuis une seule application. Synchronisez automatiquement vos informations (horaires, contact, photos) sur Google Business, Facebook, Apple Maps et Bing.
📢
Marketing Omnicanal
Créez et publiez des campagnes marketing sur Facebook, Instagram, Google Business et Store Locator simultanément. Utilisez l'IA pour générer du contenu engageant.
⭐
Gestion des Avis
Centralisez tous les avis clients de vos différentes plateformes. Répondez rapidement grâce aux suggestions IA et aux réponses types pré-enregistrées.
📺
Publicité Programmatique
Lancez des campagnes LokAds pour maximiser votre visibilité locale avec un budget optimisé. Ciblez les clients autour de vos établissements.

🛠️
Stack Technologique

L'application est construite avec les technologies modernes suivantes, choisies pour leur robustesse, leur performance et leur facilité de maintenance.

💙
Flutter 3.x
Framework UI cross-platform de Google permettant de créer des applications iOS et Android avec une seule base de code Dart. Offre des performances natives et un hot reload rapide.
⚡
GetX 4.6.5
Solution tout-en-un pour la gestion d'état réactive, l'injection de dépendances et la navigation. Léger, performant et facile à utiliser avec une syntaxe minimaliste.
🔥
Firebase Suite
Analytics pour le tracking, Crashlytics pour les rapports de crash, Cloud Messaging pour les notifications push, et Firestore pour les données temps réel.
🌐
Dio 5.0
Client HTTP puissant pour Dart avec support des intercepteurs, du FormData, de l'annulation de requêtes et du téléchargement de fichiers. Utilisé avec un intercepteur custom pour le refresh automatique des tokens.

Dépendances principales

Catégorie Package Version Utilisation
State get ^4.6.5 Gestion d'état réactive, injection de dépendances, navigation
Network dio ^5.0.0 Client HTTP avec intercepteurs pour les appels API
Firebase firebase_core ^4.0.0 Initialisation et configuration Firebase
Firebase firebase_messaging ^16.0.0 Notifications push via Firebase Cloud Messaging
Firebase firebase_analytics ^12.0.0 Tracking des événements et comportements utilisateur
Firebase firebase_crashlytics ^5.0.0 Rapports de crash et monitoring des erreurs
Storage flutter_secure_storage ^9.2.4 Stockage sécurisé des tokens (Keychain iOS, EncryptedSharedPreferences Android)
Storage shared_preferences ^2.1.0 Stockage clé-valeur pour les préférences utilisateur
Auth google_sign_in ^6.1.0 Authentification Single Sign-On avec Google
Auth sign_in_with_apple ^6.1.3 Authentification Single Sign-On avec Apple (iOS)
Support intercom_flutter ^7.8.1 Chat de support client intégré via Intercom
UI lottie ^2.2.0 Animations vectorielles haute qualité

🧭
Navigation rapide

Explorez les différentes sections de la documentation pour comprendre en profondeur le fonctionnement de l'application.

🏗️
Architecture
Comprendre l'architecture Clean Architecture hybride, la structure des dossiers, les patterns utilisés et le flux de données.
🔐
Authentification
Flux d'authentification complet : login basique, SSO Google/Apple, gestion des tokens et refresh automatique.
⚡
Handlers
Documentation détaillée de chaque Handler (controller) : AuthHandler, StoresHandler, CampaignsHandler, etc.
🌐
API Endpoints
Référence complète des 50+ endpoints API avec méthodes HTTP, paramètres et exemples de réponses.
📦
Modèles de données
Structure de tous les modèles Dart : Token, Store, Campaign, Review, LokAds, etc. avec leurs propriétés.
🔑
Permissions
Système de permissions granulaire pour contrôler l'accès aux fonctionnalités selon le rôle utilisateur.

🌍
Environnements

L'application supporte trois environnements distincts grâce au système de Flavors de Flutter. Chaque environnement possède sa propre configuration (URL API, clés Firebase, etc.).

🟢
Production
Fichier : main.dart
API : https://mobilosoft-api.com/

Environnement de production utilisé par les utilisateurs finaux. Données réelles et monitoring activé.
🟡
Preprod
Fichier : main_preprod.dart
API : https://mobilosoft-api-testing.com/

Environnement de pré-production pour les tests d'intégration et la validation avant mise en production.
🔵
Development
Fichier : main_dev.dart
API : https://mobile.mobilosoft-dev.com/

Environnement de développement avec logs détaillés et données de test.

📁
Structure du projet

L'application suit une architecture en couches avec une séparation claire des responsabilités. Voici un aperçu de la structure principale :

lib/ ├── app/ # Code principal de l'application │ ├── application/ # Logique métier (Handlers, Config) │ │ ├── handlers/ # 14 controllers GetX │ │ ├── appConfig/ # Configuration des flavors │ │ └── internationalisation/ # Gestion des langues │ │ │ ├── data/ # Couche données │ │ ├── repositories/ # 19 repositories d'accès aux données │ │ └── dataLayer/ # Infrastructure (Network, Storage) │ │ │ ├── domain/ # Modèles de données (56 models) │ │ └── models/ │ │ │ ├── presentation/ # Interface utilisateur │ │ ├── screens/ # 81+ écrans │ │ └── components/ # Widgets réutilisables │ │ │ └── navigation/ # Routes et navigation │ ├── l10n/ # Traductions (EN, FR, NL) ├── main.dart # Point d'entrée Production ├── main_dev.dart # Point d'entrée Dev └── main_preprod.dart # Point d'entrée Preprod
📖
En savoir plus

Consultez la page Architecture pour une explication détaillée de chaque couche et de leurs interactions.