Plateforme d’Intelligence Commerciale pour le Mali
# 🇲🇱 TradeSahel — Intelligence Commerciale Mali
> Plateforme d'analyse commerciale intelligente dédiée aux commerçants et PME du Mali, avec IA intégrée, base de données persistante et exports professionnels.
---
## 📋 Table des matières
1. Présentation
2. Fonctionnalités
3. Architecture
4. Installation
5. Lancement
6. Format des données
7. Structure des fichiers
8. Base de données
9. Comptes démo
10. Dépendances
11. FAQ
---
## Présentation
**TradeSahel** est un dashboard commercial complet développé avec Streamlit, conçu spécifiquement pour le marché malien (devise FCFA). Il permet aux commerçants, boutiquiers et PME d'analyser leurs ventes, suivre leurs stocks, générer des rapports IA et exporter leurs données en PDF, Word ou Excel — sans aucune connaissance technique.
### Pourquoi TradeSahel ?
- 🛒 **Adapté au Mali** : FCFA, saisonnalité locale (Ramadan, récoltes, hivernage), contexte PME africain
- 🤖 **IA intégrée** : Rapports commerciaux, prévisions et chat IA via Groq (LLaMA 3.3 70B)
- 💾 **Données persistantes** : Base SQLite locale — vos données restent entre les sessions
- 🔒 **Sécurisé** : Authentification SHA-256, comptes multi-utilisateurs
- 📱 **Accessible** : Interface web simple, aucune installation complexe
---
## Fonctionnalités
### 📊 Tableau de bord
- KPIs en temps réel : CA nominal, CA réel (hors inflation 2%), panier moyen, quantité, transactions
- Calcul automatique de la marge bénéficiaire si `prix_achat` fourni
- Tableau détaillé par produit avec part du CA et taux de marge
- Graphiques interactifs : Top 10 produits, répartition par secteur, évolution temporelle
- Filtres : type de commerce, produit, période (jour/semaine/mois/année)
### 🏬 Multi-boutiques
- Comparaison simultanée de plusieurs points de vente
- Import multi-fichiers avec détection automatique des doublons (hash MD5)
- Vue consolidée ou par boutique
### ⚖️ Comparaison
- Comparaison de deux périodes avec évolution en %
- Comparaison multi-produits sur une même pério …