Plateforme e-commerce mobile moderne connectée à PrestaShop avec architecture modulaire.

Koutonou est une application mobile Flutter qui démontre la faisabilité complète d'intégration avec les APIs PrestaShop. Le projet valide une architecture scalable pour marketplace e-commerce avec gestion multilingue, multi-devises et multi-pays.

• 🌐 APIs PrestaShop : Languages, Currencies, Countries (241 pays)
• 📱 Interface Flutter : Navigation, cache intelligent, gestion d'erreurs
• 🔧 Architecture : Modulaire, scalable, production-ready
• 🎨 UI/UX : Demo fonctionnel, simulation e-commerce

flutter --version  # Flutter 3.0+
dart --version     # Dart 3.0+

# Cloner le projet
git clone https://github.com/99ch/koutonou.git
cd koutonou

# Installer les dépendances
flutter pub get

# Générer les modèles
dart run build_runner build

# Configuration environnement
cp .env.example .env
# Éditer .env avec vos paramètres API

# Lancer l'application
flutter run

koutonou/
├── 📱 lib/
│   ├── 🎯 main.dart                 # Point d'entrée
│   ├── ⚙️ core/                     # Services core, thème, utils
│   ├── 🌐 localization/             # Internationalisation
│   ├── 📦 modules/                  # Modules métier
│   │   ├── configs/                 # Languages, Currencies, Countries
│   │   ├── customers/               # Authentification utilisateurs
│   │   ├── orders/                  # Gestion commandes
│   │   └── ...                      # Autres modules
│   ├── 🛣️ router/                   # Navigation GoRouter
│   └── 🔧 shared/                   # Widgets réutilisables
├── 📊 tools/                        # Scripts génération code
├── 🧪 test/                         # Tests automatisés
└── 📋 docs/                         # Documentation

• 🌍 Configuration Globale

  • Sélection langue dynamique (Français/Anglais)
  • Gestion multi-devises (EUR, USD, etc.)
  • Support 241 pays avec détails complets

• 📱 Interface Utilisateur

  • Navigation fluide (GoRouter)
  • Thème adaptatif (Light/Dark)
  • Cache intelligent (TTL 1h)
  • Gestion d'erreurs robuste

• 🔗 Intégration API

  • PrestaShop REST API complète
  • Proxy PHP pour CORS et auth
  • Parsing automatique JSON
  • Logging détaillé

• 📦 Catalogue Produits
• 👥 Authentification Clients
• 🛒 Gestion Panier
• 📋 Processus Commande

# Tests unitaires
flutter test

# Tests d'intégration
flutter test integration_test/

# Tests MVP spécifiques
./test_core_architecture.sh
./run_mvp_phase1.sh

• 📋 Architecture - Design patterns et structure
• 🧪 Tests Guide - Guide de test du router
• ✅ MVP Report - Rapport de faisabilité
• 🏆 Success Report - Résultats Phase 1

• Frontend : Flutter 3.0+, Dart 3.0+
• Backend : PrestaShop REST API
• Navigation : GoRouter
• State Management : Provider
• Serialization : json_annotation/build_runner
• Internationalisation : flutter_localizations
• Cache : Memory cache avec TTL

1. Fork le projet
2. Créer une branche feature (git checkout -b feature/amazing-feature)
3. Commit les changements (git commit -m 'Add amazing feature')
4. Push la branche (git push origin feature/amazing-feature)
5. Ouvrir une Pull Request

Ce projet est sous licence MIT. Voir LICENSE pour plus de détails.

• Développeur : 99ch
• Projet : Koutonou
• Issues : GitHub Issues

🎯 Mission : Démontrer et valider l'intégration PrestaShop dans un écosystème mobile moderne avec Flutter.

🏆 Status : MVP Phase 1 - ✅ SUCCÈS COMPLET