📱 Description
Application CRM complète pour la gestion de prospects avec Flutter et MySQL.
Prospectius est une solution professionnelle pour gérer vos prospects, suivre les interactions en temps réel et analyser vos statistiques de conversion. Conçue pour les équipes commerciales, elle offre une interface intuitive et performante pour optimiser votre prospection.
📦 Contenu du Package
Prospectius-1.0.0/
├── prospectius.exe ✅ Application Windows exécutable (64-bit)
├── Prospectius.sql ✅ Script de création base de données principale
├── SuppressionDB.sql ✅ Script de base de données secondaire
├── README.md 📖 Ce fichier
└── INSTALLATION.md 📖 Guide d'installation détaillé
🚀 Installation Rapide
1. Installation de la Base de Données
Vous devez d'abord installer MySQL Server sur votre ordinateur.
Étape 1 : Télécharger MySQL
- Visitez: https://dev.mysql.com/downloads/mysql/
- Téléchargez MySQL Community Server (version 5.7+ ou 8.0)
Étape 2 : Installer MySQL
- Exécutez l'installateur téléchargé
- Suivez l'assistant d'installation
- Notez le mot de passe root (important!)
- Vérifiez que MySQL est démarré (Services Windows)
Étape 3 : Importer les Scripts SQL
Ouvrez MySQL Command Line Client ou MySQL Workbench et exécutez:
-- Connectez-vous d'abord avec vos identifiants
mysql -u root -p
-- Importez les scripts
source C:\Chemin\Vers\Prospectius.sql
source C:\Chemin\Vers\SuppressionDB.sql
-- Vérifiez que les bases sont créées
SHOW DATABASES;Alternative avec PowerShell:
mysql -u root -p < "C:\Chemin\Vers\Prospectius.sql"
mysql -u root -p < "C:\Chemin\Vers\SuppressionDB.sql"2. Configuration de l'Application
Lors du premier lancement de prospectius.exe, l'application vous demandera:
- ✅ Adresse du serveur MySQL (par défaut:
localhost) - ✅ Nom d'utilisateur (par défaut:
root) - ✅ Mot de passe (celui défini lors de l'installation MySQL)
- ✅ Port (par défaut:
3306)
Ces paramètres sont sauvegardés pour les lancements suivants et peuvent être modifiés dans Configuration > Base de Données.
3. Lancer l'Application
Simplement double-cliquez sur prospectius.exe pour lancer l'application.
Première connexion
- Utilisateur:
demo- Mot de passe:
demoCréez votre propre compte ensuite via "S'inscrire"
💻 Système Requis
| Critère | Minimum | Recommandé |
|---|---|---|
| OS | Windows 10 (64-bit) | Windows 11 (64-bit) |
| RAM | 4 GB | 8 GB |
| Stockage | 500 MB libres | 1 GB libres |
| MySQL | 5.7+ | 8.0 LTS |
| Internet | Optionnel | Pour mises à jour |
✨ Fonctionnalités Principales
-
✅ Gestion complète des prospects
- Liste complète avec statuts
- Ajout/édition en temps réel
- Suppression sécurisée avec audit
- Recherche et filtrage avancés
-
✅ Historique des interactions
- Enregistrement (appel, email, réunion, etc.)
- Notes détaillées et dates de suivi
- Historique complet par prospect
- Types d'interaction configurables
-
✅ Statistiques et analyses
- Graphiques en temps réel
- Taux de conversion avec tendances
- Tableau de bord personnalisé
- Export Excel complet
-
✅ Authentification sécurisée
- Login multi-utilisateur
- Mots de passe chiffrés (bcrypt)
- Gestion des sessions
- Récupération de mot de passe
-
✅ Audit et conformité
- Logging de toutes les opérations
- Historique d'audit complet
- Traçabilité des modifications
- Rapports de conformité
-
✅ Interface utilisateur
- Design moderne (Material Design 3)
- Navigation intuitive
- Responsive et fluide
- Thème clair/sombre
🚀 Installation
Prérequis
- Flutter 3.0+
- Dart 3.0+
- MySQL/MariaDB 5.7+
- Node.js 16+ (optionnel, pour le serveur backend)
Installation Rapide
1. Cloner le projet
git clone https://github.com/josoavj/ProspectiusFinal.git
cd ProspectiusFinal2. Installation des dépendances
flutter pub get3. Configuration de la base de données
# Linux/macOS
./scripts/setup.sh
# Windows
.\scripts\install-windows.ps14. Lancer l'application
flutter run📋 Configuration
Configuration de la Base de Données
Fichier lib/config/database_config.dart
const String dbHost = 'localhost';
const int dbPort = 3306;
const String dbUser = 'root';
const String dbPassword = 'votre_mot_de_passe';
const String dbName = 'Prospectius';Créer la base de données
mysql -u root -p < scripts/Database/Prospectius.sqlVariables d'Environnement
export DB_HOST=localhost
export DB_PORT=3306
export DB_USER=root
export DB_PASSWORD=password
export DB_NAME=Prospectius🏗️ Architecture
Structure du Projet
lib/
├── main.dart # Point d'entrée
├── models/ # Modèles de données
│ ├── account.dart
│ ├── prospect.dart
│ ├── interaction.dart
│ ├── status_history.dart
│ └── stats.dart
├── services/ # Logique métier
│ ├── database_service.dart
│ ├── mysql_service.dart
│ ├── auth_service.dart
│ ├── prospect_service.dart
│ ├── transfer_service.dart
│ ├── audit_service.dart
│ └── error_handling_service.dart
├── providers/ # State management (Provider)
│ ├── auth_provider.dart
│ ├── prospect_provider.dart
│ ├── stats_provider.dart
│ └── audit_provider.dart
├── screens/ # Écrans UI
│ ├── login_screen.dart
│ ├── prospects_screen.dart
│ ├── stats_screen.dart
│ ├── configuration_screen.dart
│ └── ...
└── utils/ # Utilitaires
├── app_logger.dart
└── constants.dart
Architectures Utilisées
- MVVM (Model-View-ViewModel)
- Provider pour la gestion d'état
- Clean Architecture pour la séparation des responsabilités
- Repository Pattern pour l'accès aux données
📚 Utilisateurs et Authentification
Créer un Compte
- Cliquer sur "S'inscrire" sur l'écran de login
- Entrer nom d'utilisateur et mot de passe
- Le compte est créé automatiquement
Statuts des Prospects
- Nouveau - Prospect fraîchement ajouté
- En contact - Discussions en cours
- En cours de négociation - Négociation avancée
- Client - Prospect converti
- Perte - Prospect perdu
🎯 Démarrage Rapide
Créer votre Premier Prospect
- Connectez-vous avec vos identifiants
- Cliquez sur "Ajouter un prospect"
- Remplissez les informations (nom, entreprise, etc.)
- Cliquez sur "Enregistrer"
- Commencez à suivre vos interactions!
Statuts des Prospects
| Statut | Description |
|---|---|
| 🆕 Nouveau | Prospect fraîchement ajouté |
| 📞 En contact | Discussions en cours |
| 💼 En négociation | Négociation avancée |
| ✅ Client | Prospect converti |
| ❌ Perte | Prospect perdu/rejeté |
Suivre les Interactions
- Ouvrez la fiche prospect
- Cliquez sur "Ajouter une interaction"
- Sélectionnez le type (appel, email, réunion, etc.)
- Ajoutez vos notes
- Enregistrez automatiquement
⚙️ Configuration Avancée
Modifier les Paramètres MySQL
- Allez dans Configuration > Base de Données
- Modifiez les paramètres (hôte, utilisateur, port)
- Cliquez sur "Tester la connexion"
- Enregistrez les nouveaux paramètres
Exporter vos Données
- Allez dans Prospects > Exporter
- Sélectionnez la plage de dates
- Cliquez sur "Télécharger Excel"
- Les données s'ouvrent dans votre tableur préféré
Consulter les Logs d'Audit
- Allez dans Administration > Logs d'audit
- Filtrez par date, utilisateur, action
- Exportez les rapports si nécessaire
🐛 Dépannage Courant
Erreur: "Can't connect to MySQL server"
Cause: MySQL n'est pas en cours d'exécution
Solutions:
- Ouvrez Services Windows (
services.msc) - Cherchez MySQL80 (ou votre version)
- Cliquez droit → Démarrer
Ou en PowerShell (Admin):
Start-Service MySQL80Erreur: "Access denied for user 'root'"
Cause: Mot de passe incorrect
Solutions:
- Allez dans Configuration > Base de Données
- Vérifiez votre mot de passe MySQL
- Cliquez sur "Tester la connexion"
- Réinitialisez le mot de passe si nécessaire:
ALTER USER 'root'@'localhost' IDENTIFIED BY 'nouveau_mot_de_passe';
FLUSH PRIVILEGES;Erreur: "Table 'Prospectius.Prospect' doesn't exist"
Cause: Scripts SQL non importés correctement
Solutions:
- Supprimez la base de données:
DROP DATABASE Prospectius; - Réimportez les scripts SQL
- Redémarrez l'application
mysql -u root -p < Prospectius.sqlL'application met longtemps à charger
Cause: Connexion lente ou trop de données
Solutions:
- ✅ Vérifiez votre connexion à MySQL
- ✅ Réduisez la plage de données affichées
- ✅ Videz le cache: Configuration > Nettoyage du cache
- ✅ Redémarrez MySQL si stressé
📊 Schéma de Base de Données
Tables Principales
-- Utilisateurs
Account
├── id_compte (PK)
├── username
├── password_hash
├── email
└── created_at
-- Prospects
Prospect
├── id_prospect (PK)
├── id_compte (FK)
├── name
├── status
├── company
└── created_at
-- Interactions
Interaction
├── id_interaction (PK)
├── id_prospect (FK)
├── id_compte (FK)
├── interaction_type
├── note
└── interaction_date
-- Historique des statuts
StatusHistory
├── id_history (PK)
├── id_prospect (FK)
├── old_status
├── new_status
└── changed_date
-- Transferts
TransferHistory
├── id_transfer (PK)
├── id_prospect (FK)
├── from_user_id (FK)
├── to_user_id (FK)
└── transfer_date
-- Audit
audit_logs
├── id (PK)
├── user_id (FK)
├── action
├── table_name
├── record_id
└── timestamp🔐 Sécurité
Bonnes Pratiques
- ✅ Mots de passe chiffrés avec bcrypt
- ✅ Audit complet de toutes les opérations
- ✅ Validation des entrées utilisateur
- ✅ Gestion sécurisée des sessions
- ✅ Pas de stockage de données sensibles
- ✅ Sauvegarde régulière de la base de données
Sauvegarder votre Base de Données
# Sauvegarde complète
mysqldump -u root -p Prospectius > backup_$(Get-Date -Format 'yyyyMMdd_HHmmss').sql
# Restauration
mysql -u root -p Prospectius < backup.sql📞 Support et Contact
Problèmes Fréquents
- FAQ - Questions fréquemment posées
- QUICKSTART.md - Guide de démarrage
- INSTALLATION.md - Installation détaillée
Signaler un Bug
- Ouvrez une issue sur GitHub
- Décrivez le problème avec détails
- Joignez les logs (Configuration > Logs)
- Signalez votre version et OS
Contacter l'Équipe
- Email: support@prospectius.app
- GitHub: https://github.com/josoavj/ProspectiusFinal/issues
- Wiki: https://github.com/josoavj/ProspectiusFinal/wiki
📋 Information Technique
| Propriété | Valeur |
|---|---|
| Version | 1.0.0 |
| Date de Release | 7 décembre 2025 |
| Plateforme | Windows 64-bit |
| Framework | Flutter 3.38.3+ |
| Langage | Dart 3.0+ |
| Base de données | MySQL 5.7+ / MariaDB 10.5+ |
| Licence | MIT |
🎯 Feuille de Route
v1.0.0 ✅ (Actuel)
- Gestion complète des prospects
- Suivi des interactions
- Statistiques et analyses
- Authentification utilisateur
- Audit complet
📜 Licence
Prospectius est sous licence MIT. Vous êtes libre d'utiliser, modifier et distribuer cette application.
👨💻 À Propos
Développé par Josoa (@josoavj)
Remerciements spéciaux aux contributeurs et utilisateurs bêta qui ont aidé à améliorer Prospectius.
🚀 Profitez de Prospectius et optimisez votre prospection!
Dernière mise à jour: 7 décembre 2025
Support Windows 10+ (64-bit)