omartkd7/Shopmates.Ai

ShopMate AI est une application mobile de boutique en ligne (paiement à la livraison / COD) dans laquelle un assistant conversationnel intelligent est intégré comme fonctionnalité centrale. Le client discute avec l’assistant en langage naturel (français ou darija) 🛍️ ShopMate AI Assistant conversationnel IA pour boutique e-commerce en paiement à la livraison (COD) Application mobile multi-tenant — RAG · Function Calling · MCP --- ## 📑 Sommaire - À propos - Le problème - La solution - Fonctionnalités - Comment fonctionne l'agent IA - Les outils de l'agent - Ce que l'agent refuse - Stack technique - Architecture - Modèle de données - Démarrage rapide - Variables d'environnement - API REST - Exemple de conversation - Sécurité - Déploiement - Feuille de route - Auteur --- ## 🎯 À propos **ShopMate AI** est une application mobile de boutique en ligne dans laquelle un **assistant conversationnel intelligent est la fonctionnalité centrale**, pas un simple ajout. Le client discute en langage naturel (français ou darija) : il pose ses questions sur les produits, la livraison ou les retours, **passe sa commande et la suit** — sans qu'aucun humain n'intervienne, 24h/24. L'application est **multi-tenant** : chaque donnée est rattachée à un `storeId`, donc une même instance peut servir plusieurs boutiques. Le projet est ainsi extensible en véritable produit SaaS. > 🎓 Projet Fil Rouge — *Mobile Augmented AI* · Deadline : **24 octobre 2026** --- ## ❗ Le problème Une boutique COD (très répandue au Maroc) fait face chaque jour à trois coûts cachés : | Problème | Conséquence | |---|---| | 🔁 **Questions répétitives** — prix, tailles, disponibilité, délai et frais de livraison, retours | Le vendeur répond 100 fois par jour la même chose | | 🌙 **Demandes hors horaires** — le soir et le week-end | Les ventes non traitées dans l'heure sont perdues | | 📞 **Prise de commande manuelle** par téléphone | Temps perdu, erreurs de saisie, aucune traçabilité | --- ## 💡 La solution ShopMate AI automatise **les deux tâches à la fois** : 1. **Répondre** — l'assistant puise dans les documents réels de la boutique (RAG), il n'invente pas. 2. **Agir** — l'assistant exécute de vraies opérations métier (function calling), toujours av …