✨ Release Notes v1.0.0

Correction majeure du parsing conversationnel des chiffres isolés (ex: « 2 » en réponse à la question de quantité).

🚀 Principales Nouveautés & Améliorations :

• Validation Contextuelle du Mode de Paiement : L'envoi d'un chiffre isolé (« 1 » ou « 2 ») ou d'un mot d'affirmation (« oui », « ok ») ne déclenche la génération d'un lien de paiement (Orange Money / Wave) que si le dernier message du bot demandait explicitement le mode de paiement.
• Prise en Compte Stricte de la Quantité : Lorsque le bot demande la quantité (ex: « Combien de bouteilles souhaitez-vous commander ? »), la réponse « 2 » met à jour la quantité à 2 unités et enchaîne directement vers le choix entre retrait en boutique et livraison à domicile.
• Suppression des Salutations Parasites : Élimination définitive de la réitération de la formule d'accueil (« Bonjour et bienvenue... ») lors de la saisie de réponses courtes numériques.

Suppression automatique de la formule d'accueil complète (« Bonjour et bienvenue ! Je suis Anta, votre assistante d'achat... ») lorsque le client formule directement sa commande.

🚀 Principales Nouveautés & Améliorations :

• Nettoyage des Blocs d'Introduction Complètes : Le filtre clean_redundant_greetings intercepte et supprime tout pavé de présentation introductive lorsqu'une intention de commande de produit (ex: "Bonjour. Je veux de l'huile de baobab") est présente.
• Réponse Directe au Besoin Client : Anta répond directement avec la disponibilité, le prix et la question sur la quantité demandée sans réitérer sa présentation.

Correction des salutations répétitives (Wolof / Français) et prévention de la fausse détection de noms de produits (ex: "Huile de Baobab") comme adresse de livraison.

🚀 Principales Nouveautés & Améliorations :

• Interdiction Stricte des Répétitions de Salutation : Extension de la règle et du filtre clean_redundant_greetings pour supprimer les relances « Nanga def ! », « Na ngua ! », « Bonjour ! » ou « Salam ! » dès que la discussion est déjà engagée.
• Protection contre les Faux Positifs de Localisation : Résolution du bug où des demandes de produits (ex: "je veux de l'huile de baobab") étaient assimilées au quartier Baobab ou à une adresse de livraison. L'analyse des adresses vérifie désormais la présence de prépositions explicites et exclut les requêtes produits.
• Respect Strict des Étapes de Commande (Règle 3.2) : Le bot valide désormais la quantité puis propose le choix entre Retrait en Boutique et Livraison à Domicile avant d'évaluer tout tarif ou mode de paiement.

Résolution de l'erreur ERR_NGROK_3200 sur la génération des liens de paiement Wave et Orange Money lors de l'utilisation du simulateur local.

🚀 Principales Nouveautés & Améliorations :

• Dynamic Base URL Propagation : Transmission systématique de request.base_url dans le simulateur WhatsApp et les webhooks pour construire des liens de paiement basés sur l'hôte actif.
• Correction Fallback Localhost : Remplacement du tunnel ngrok inactif dans .env par http://localhost:8000 pour garantir l'accès direct aux checkout de paiement hors tunnel.

Mise à niveau majeure du moteur conversationnel WhatsApp avec le Prompt Système officiel « Anta », l'assistante virtuelle de vente pour Market Plus et Blitzer.

🚀 Principales Nouveautés & Améliorations :

• Identité & Langue Anta : Intégration de l'identité virtuelle Anta (basée au Sénégal), gestion bilingue Français / Wolof / Franwolof, salutations chaleureuses et courtoisie locale.
• Flux de Commande Structuré (5 Étapes) : Collecte progressive et guidée : Salutation, Identification du besoin, Vérification produit & stock, Prix et quantité dans l'unité adaptée, Choix du mode d'acquisition (Retrait Boutique vs Livraison).
• Parcours A (Retrait en Boutique / Click & Collect) : Récapitulatif détaillé par ligne, choix Wave / Orange Money, génération de l'intention de paiement à 0 FCFA de livraison, transmission des coordonnées boutique (adresse, horaires, téléphone) et proposition de facture PDF.
• Parcours B (Livraison à Domicile) : Calcul dynamique des tarifs Blitzer (Standard & Express), récapitulatif global, paiement sécurisé Wave/OM, facturation digitale et transmission automatique des informations livreur (Téléphone, Plaque moto, N° Membre Blitzer, Lien GPS Leaflet).
• Règles Générales de Conduite & Grounding : Strict respect des stocks et des prix officiels, confidentialité des livreurs et clients, et tolérance maximale pour les variations de langage.

Renforcement du moteur conversationnel de l'assistant IA pour interdire formellement les doubles questions par message et améliorer la gestion des abréviations courantes.

🚀 Principales Nouveautés & Améliorations :

• Unicité Stricte des Questions (1 Question / Message) : Interdiction totale de poser 2 questions simultanées (ex: Tarif + Mode de paiement). Après saisie du lieu de livraison, l'assistant affiche les tarifs Blitzer et demande uniquement le mode de paiement (Wave / Orange Money).
• Option Standard par Défaut : La livraison Standard (1500 FCFA) est appliquée par défaut sans poser de question additionnelle, sauf si le client réclame explicitement l'Express.
• Reconnaissance des Abréviations Polies : Prise en compte de stp (s'il te plaît) et svp (s'il vous plaît) dans le lexique wolof/français local sans altérer la détection des lieux de livraison.
• Emission Instantanée du Lien de Paiement : Dès que le client indique son choix (ex: "wave", "orange money"), l'assistant génère immédiatement le lien de paiement sécurisé (Wave / Orange Money) et supprime toute relance superflue.

Implémentation complète du moteur de facturation PDF officielle pour Market Plus et du flux conversationnel interactif post-paiement.

🚀 Principales Nouveautés & Améliorations :

• Générateur PDF Officiel : Création automatique de factures PDF professionnelles avec logo de la boutique, adresse, téléphone, décompte HT, TVA (18%), frais de livraison et Total TTC.
• Flux WhatsApp Post-Paiement : Demande systématique posée au client après validation du paiement pour télécharger sa facture PDF en 1 clic.
• Dashboard Marchand : Ajout du bouton de téléchargement direct de la facture PDF dans le détail des commandes.
• Endpoint Dédié : GET /api/v1/orders/{order_id}/pdf-invoice pour la consultation et le téléchargement des factures.

Optimisation du module d'importation de catalogue WhatsApp Meta Graph API avec résolution intelligente des identifiants (Catalog ID, WABA ID, Phone Number ID) et conservation automatique des jetons d'accès.

📦 Synchronisation Catalogue Meta Graph API :

• ⚙️ Modal Config Meta Avancé : Sauvegarde locale (localStorage) et en base de données de l'identifiant de catalogue Meta (Catalog ID) et du jeton d'accès (Access Token).
• 📥 Importation Immédiate (Payload Body) : Envoi direct des identifiants au point de terminaison POST /api/v1/products/whatsapp/import pour éliminer le fallback démo et importer les 21+ produits réels de la boutique Meta.
• 🔍 Résolveur Dynamique d'Identifiants : Auto-détection du catalogue attaché au compte WhatsApp Business si l'utilisateur ne fournit que son Phone Number ID ou WABA ID.

Déploiement du module de suivi en temps réel (Live Order Tracking) sur carte interactive OpenStreetMap / Leaflet (Dark Mode) avec géolocalisation continue du conducteur Blitzer et assistance WhatsApp.

🗺️ Nouveautés Géolocalisation & Suivi en Direct :

• 🛵 Carte de Suivi Client Interactive (/track/{order_id}) : Affichage sur carte Leaflet à 0 FCFA de frais d'API de la moto du livreur Blitzer 🛵 en mouvement direct, de la boutique 🏪 et de l'adresse client 📍.
• 📡 API de Position Conducteur (POST /api/v1/blitzer/drivers/{driver_id}/location) : Endpoint de transmission GPS et de mise à jour des étapes de livraison (Prise en charge, En route, Arrivé).
• 💬 Intégration IA WhatsApp : L'assistant virtuel communique automatiquement le lien de suivi au client dès le paiement validé et répond avec la position exacte du livreur lorsqu'il est sollicité.

Verrouillage complet de la console d'administration Blitzer (/blitzer/admin.html). Seuls le Software Product Owner et les Super Admins possèdent le privilège d'accès.

🔒 Contrôle d'Accès & Prévention des Conflits :

• 🛡️ Restriction d'Accès Dashboard Admin Blitzer : Seuls les comptes dotés des rôles software_product_owner et super_admin sont autorisés à ouvrir et administrer la console Blitzer (admin.html).
• 🚫 Blocage Automatique des Commerçants et Conducteurs : Tout accès tenté par un commerçant (admin), conducteur ou collaborateur est immédiatement rejeté à la connexion et à l'ouverture de la page avec redirection automatique vers login.html.
• ⚖️ Protection de la Validation des Abonnements : Suppression du risque de validation indue des abonnements conducteurs par des utilisateurs non habilités.

Mise en place du centre intelligent d'information et de mise à jour logicielle permettant aux abonnés d'être notifiés en temps réel des nouvelles versions de la plateforme selon leur formule d'abonnement.

🚀 Centre de Mise à Jour Système & Notification par Formule :

• 🔔 Notification de Version Personnalisée : Détection automatique des nouvelles versions système au démarrage avec présentation sur-mesure des nouveautés selon le forfait de l'abonné (Essentiel, Premium, Enterprise).
• ⚡ Mise à Jour Instantanée sur Souhait : Bouton d'action ⚡ Mettre à jour permettant à l'abonné d'appliquer la mise à jour de son espace marchand à sa convenance.
• 💡 Conseils d'Évolution d'Abonnement : Recommandations ciblées pour faire évoluer sa formule vers Premium ou Enterprise afin de débloquer les privilèges logistiques Blitzer et le déstockage FEFO/FIFO.
• 🏷️ Badge Interactif de Version Header : Indicateur d'état interactif v0.9.4 placé dans l'en-tête du tableau de bord avec voyant d'état (Vert = À jour, Ambre = Mise à jour disponible).
• 🔻 Accessibilité Résiliation Abonnement : Bouton de résiliation Enterprise/Premium accessible dans la modal de version et dans le pied de page (footer) à côté de "Tous droits réservés".

Renforcement de la gouvernance multi-tenant et de l'isolation du réseau logistique Blitzer pour la diffusion d'alertes routières et de messages broadcast.

🔒 Gouvernance & Sécurité du Réseau Blitzer :

• 📻 Exclusivité Broadcast Global : La publication d'alertes routières globales sur tout le réseau (Radio Trafic Sénégal) et les messages broadcast globaux sont réservés STRICTEMENT et EXCLUSIVEMENT au Software Product Owner et au Super Admin.
• 🏬 Périmètre Administrateurs Boutique : Les administrateurs de boutique (admin / collaborator) ne peuvent plus poster de messages globaux et sont restreints à la diffusion de consignes uniquement vers leurs propres livreurs enregistrés (merchant_id).

Possibilité pour chaque créateur ou administrateur de boutique/société de personnaliser et reconfigurer l'adresse physique de la boutique, le numéro WhatsApp professionnel et de télécharger un logo ou photo de profil.

🏢 Nouveautés & Gestion de Société :

• 📍 Adresse Physique & Numéro WhatsApp : Saisie dès l'inscription et modifiable à tout moment dans la console de gestion boutique.
• ⚙️ Modal de Reconfiguration Boutique : Module ⚙️ Config Boutique accessible depuis l'en-tête du Dashboard pour rééditer les informations de l'entreprise.
• 📷 Téléchargement de Logo / Avatar : Endpoint POST /api/v1/collaborators/merchant/logo permettant l'upload d'images de profil servies directement sur l'interface.
• 🌧️ Alertes Zones Inondées (Hivernage) & Vitesse de Défilement : Intégration des points de vigilance sur les zones inondables (Keur Massar, Cuvette Gadaye, Maristes-Hann) et ralentissement optimisé (55s) du fil défilant Radio Trafic Sénégal pour une lecture confortable.
• 🔄 Rétrocompatibilité Automatique : Application des colonnes address et logo_url et enrichissement des boutiques existantes sans perte de données.

Optimisation ergonomique de la barre supérieure du tableau de bord Market Plus pour éliminer les répétitions du nom de société et intégrer toutes les actions clés en haut d'écran.

🎨 Améliorations de l'En-tête :

• 📍 Repositionnement du Logo & Badge Plan : Positionnement du logo boutique (ou icône) et du badge de plan (👑 ENTERPRISE, PREMIUM, etc.) en dessous du logo Market Plus en haut à gauche.
• 🏢 Barre de Header Unifiée : Déplacement du bandeau principal avec Nom de société et Session active tout en haut, enrichi des boutons d'action ⚙️ Config Boutique, Annuler l'abonnement Enterprise et Déconnexion.

Conformité aux règles de gouvernance Règle 3.5 : Masquage et interdiction stricte des boutons de suspension (Suspendre), validation, rejet et réhabilitation des livreurs Blitzer pour les comptes commerçants (admin ou collaborator).

🔒 Sécurité & Droits d'Administration :

• Exclusivité Software Product Owner & Super Admin : Les commerçants ne voient plus le bouton Suspendre sur les consoles Blitzer (/blitzer/admin.html et /admin/drivers). Seuls les boutons Avertir et Notes leur sont accessibles.
• Notification des Avertissements : Le 3ème avertissement émis par un commerçant transmet automatiquement le dossier à la direction pour évaluation sans permettre au commerçant de suspendre le conducteur.

Déploiement du module app/seed.py d'amorçage automatique de base de données pour les environnements de production cloud (Vercel / saas-tech.io) et rendu résilient du catalogue.

🚀 Améliorations clés :

• Auto-Seeding Cloud Vercel : Détection automatique au démarrage de FastAPI et injection des 3 boutiques de démonstration (Sénégal, Mali, Côte d'Ivoire) avec 21 produits illustrés.
• Fallback Catalogue Universel Visiteur : L'endpoint /api/v1/products/list fonctionne désormais en mode sécurisé avec ou sans jeton JWT pour garantir un affichage à 100% sur saas-tech.io.

Génération automatique de 3 boutiques fictives de test (Sénégal, Mali, Côte d'Ivoire) avec 7 produits illustrés chacune, affichage visuel des images et gestion complète de la suppression des produits (DELETE).

Nouveautés & Fonctionnalités

• 🏪 3 Boutiques Fictives de Test : Inscription de "Dakar Élégance & Artisanat", "Mali Mode & Saveurs Bamako" et "Abidjan High-Tech & Design".
• 📸 Images Produits High-Quality : Affichage des miniatures et grandes images produits (Unsplash) dans la grille et le tableau du catalogue.
• 🗑️ Suppression de Produit (DELETE) : Ajout de l'endpoint DELETE /api/v1/products/{id} et du bouton 🗑️ Supprimer avec confirmation pour les tests.

Isolation de la fonctionnalité de création et clonage des pays d'Afrique dans un nouvel onglet dédié 🌍 Créer un Pays, strictement réservé au Software Product Owner (SPO).

Nouveautés & Sécurité

• 🌍 Nouvel Onglet "Créer un Pays" : Déplacement du formulaire de configuration et clonage de pays d'Afrique vers un onglet indépendant.
• 🔒 Exclusivité Stricte SPO : Visibilité et accès strictement restreints au rôle software_product_owner. Bloqué pour tout autre rôle.
• 🚀 Clonage Automatique des Déclinaisons Pays : Génération instantanée des règles locales (devise ISO, indicatif, immatriculation moto, nomenclature livreurs).

Ajout d'un onglet de navigation dédié 🏢 Liste des Commerçants sur le tableau de bord Market Plus pour le Super Admin et le Software Product Owner.

Nouveautés & Fonctionnalités

• 🏢 Onglet Dédié "Liste des Commerçants" : Navigation dédiée permettant d'accéder au répertoire exhaustif des commerçants abonnés SaaS sans masquer l'accès à la boutique.
• 📊 Filtrage & Recherche Multi-Critères : Recherche par nom de boutique, email utilisateur ou téléphone WhatsApp avec filtres par Pays, Plan SaaS (Essential, Pro, Enterprise) et Statut d'Abonnement (Actif, Essai, Expiré).
• 📱 Intégration WhatsApp Business : Visualisation directe du numéro WhatsApp associé au bot conversationnel de chaque boutique abonnée.

Refonte complète de la console d'administration Blitzer (`/blitzer/admin.html` & `/admin/drivers`) sous forme d'onglets de navigation thématiques fluides.

Nouveautés & Architecture en Onglets

• 📌 En-tête Fixe et Toujours Visible : L'en-tête principal (Logo, profil utilisateur, Aide F1, lien retour) et les 4 cartes de statistiques (KPI) restent désormais constamment visibles en haut de l'écran.
• 🏍️ Onglet 1 — Liste des Conducteurs : Regroupe les filtres de recherche, le bouton jaune d'effacement rapide 1-clic 🔍 Filtré ✖, les dropdowns de statut/pays, la configuration des colonnes et le tableau dynamique des livreurs.
• 📢 Onglet 2 — Diffusion d'Alerte Générale & Messages : Espace dédié à la diffusion d'alertes d'urgence WhatsApp (Broadcast) et à l'envoi de messages individuels aux livreurs.
• 🔑 Onglet 3 — Gestion de l'Équipe & Inscriptions : Espace d'administration réservé à la création de comptes administrateurs, la réinitialisation de mots de passe et l'inscription manuelle de conducteurs.
• 💾 Persistance de l'Onglet Actif : L'onglet sélectionné est automatiquement conservé dans la session utilisateur (sessionStorage), évitant tout changement intempestif lors du rafraîchissement.

Correction de l'animation CSS et défilement continu fluide du fil d'actualités et alertes routières en direct.

Alertes Routières & Radio Trafic

• 📻 Animation `@keyframes marqueeScroll` : Ajout des règles d'animation CSS manquantes garantissant le défilement horizontal fluide et ininterrompu du bandeau Radio Trafic Sénégal sur la console administration Blitzer (`/blitzer/admin.html`) et le portail public (`/blitzer/index.html`).
• ⏸️ Pause Interactive au Survol : Survoler le bandeau d'alerte met automatiquement l'animation en pause pour permettre une lecture confortable des flashes d'information.

Support complet des connexions simultanées de comptes différents sur plusieurs onglets du même navigateur sans écrasement de session.

Sécurité & Isolation des Onglets

• 🔒 Priorité `sessionStorage` : Priorisation systématique du stockage par onglet (`sessionStorage`) par rapport au stockage global (`localStorage`).
• 👥 Multi-Utilisateurs Simultanés : Vous pouvez désormais être connecté sous `User 1` sur l'Onglet 1 et `User 2` sur l'Onglet 2 en toute indépendance sans qu'un compte n'écrase l'autre.

Navigation fluide par clic sur les logos officiels et pré-chargement ultra-rapide des profils utilisateurs.

Nouveautés & Navigation

• 🛍️ Logo Market Plus : Un clic sur le logo Market Plus (dashboard, docs, release notes) réinitialise la vue principale sur la page de départ (`Ventes & Boutique`) avec défilement fluide vers le haut.
• 🛵 Logo Blitzer : Un clic sur le logo Blitzer (console d'administration, landing page, gestion des conducteurs) renvoie immédiatement vers la page de départ administrative ou d'accueil Blitzer.
• ⚡ Rendu Utilisateur Réactif (0 ms) : Rendu immédiat de l'adresse e-mail dès le clic sur le bouton de connexion sans attente d'API ni rafraîchissement de la page.

Amélioration majeure de la visibilité et de la transparence de l'identité de l'utilisateur connecté et de sa société/boutique sur le tableau de bord principal et l'intégralité des boîtes de dialogue/modales.

Interface Utilisateur & Modales

• 👤 En-tête du Dashboard Market Plus : Intégration d'un composant de profil verre synthétique (glassmorphism) affichant clairement l'e-mail de l'utilisateur connecté, son rôle (`Super Admin`, `Admin`, `Collaborateur`, `Software Product Owner`) et le nom de sa société/boutique (`business_name`).
• 🖼️ Bandeau d'En-tête de Dialogue Standardisé : Ajout systématique dans toutes les modales (Ajout/Édition de produit, Gestion de l'équipe/collaborateurs, Changement de mot de passe, Carnet de crédit/dette, Traitement des notes vocales WhatsApp IA, Reçus de vente, Guide F1, Validation CNI, Abonnements) d'un bandeau contextuel rappelant l'utilisateur actif et son entreprise.
• 🛵 Administration Blitzer & Navigation SaaS-Tech : Mise en page unifiée du profil utilisateur et de la société sur la console administrateur Blitzer (`/admin/drivers`), la documentation API (`docs.html`) et la landing page (`saas_tech.html`).

Déploiement de la synchronisation automatisée (Push & Pull) entre le catalogue d'articles Market Plus et le catalogue officiel WhatsApp Business (Meta Commerce Graph API v19.0+).

Service Backend & Module Commerce

• 🔄 Synchronisation Push (`/api/v1/products/whatsapp/sync`) : Envoi automatique ou manuel par lots (Batch API) de tous les articles, prix FCFA et stocks vers le catalogue Meta Commerce.
• 📥 Importation Pull (`/api/v1/products/whatsapp/import`) : Importation en 1 clic des produits existants de la boutique WhatsApp Business du client avec protection anti-doublon et isolation multi-tenant.
• ⚙️ Configuration Catalog ID (`/api/v1/products/whatsapp/config`) : Interface permettant de configurer le WhatsApp Catalog ID et le jeton d'accès Meta par boutique.

Déploiement du service backend automatisé d'extraction et de calcul du trafic routier en temps réel pour le Sénégal, alimentant la Radio Trafic Blitzer et synchronisé avec la console d'administration.

Service Backend & Télémétrie Automatisée

• Moteur Télémétrique Dynamique (`/api/v1/blitzer/traffic`) : Calcul automatique des temps de parcours et retenues sur les 5 axes majeurs de Dakar (Autoroute A1, VDN1/2/3, RN1, Corniche Ouest, AIBD).
• Support API Extérieures (Google Maps / TomTom Traffic) : Connecteurs prêts pour l'extraction de données trafic réelles via clé API configurée.
• Mode Hybride & Saisie Admin Instantanée : Fusion automatique des bulletins automatisés avec les alertes d'urgence soumises par l'équipe d'exploitation Blitzer.

Implémentation de l'initiation d'appels vidéo WhatsApp en direct pour le contrôle de conformité des conducteurs et déploiement du bandeau défilant Info Trafic Sénégal en temps réel sur la plateforme Blitzer.

Console d'Administration & Communication Flotte

• 📹 Appel Vidéo WhatsApp Direct (`/admin/drivers`) : Boutons d'action rapide permettant d'initier un contrôle visuel vidéo WhatsApp avec les livreurs enregistrés.
• 📻 Radio Trafic Sénégal (Live Marquee Ticker) : Bandeau défilant d'actualité routière en direct sur les axes majeurs (Autoroute A1, VDN3, RN1, Corniche Ouest, AIBD).
• ⚙️ Éditeur d'Alertes Routières Admin : Console d'édition permettant aux administrateurs de publier et de mettre à jour les messages d'état du trafic en temps réel.

Adoption officielle du nouveau logo et favicon épurés SaaS-Tech reprenant le signe géométrique 'S' (chevrons hexagonaux cyan et violet) posé directement à côté de la typographie SaaS-Tech.

Identité Visuelle & Portails

• Logo Officiel Vectoriel (`app/static/logo.png`) : Signe hexagonal 'S' bicolore cyan/violet juxtaposé au texte SaaS-Tech.
• Favicon HD (`/favicon.ico`) & Documentation : Intégration sur l'ensemble du site web saas-tech.io, du dashboard, des manuels PDF/DOCX et de la console Blitzer.

Déploiement de l'identité visuelle officielle de SaaS-Tech (Logo Option 2 & Favicon HD) représentant la fusion du Cloud SaaS, de l'IA et de l'innovation continentale africaine.

Identité Visuelle & Design System

• Logo Officiel SaaS-Tech (`app/static/logo.png`) : Nœud tridimensionnel entrelacé néon cyan et métal doré représentant l'Afrique et l'innovation SaaS.
• Favicon & Icône d'Application (`/favicon.ico`) : Déclinaison haute définition intégrée sur l'ensemble des pages (SaaS-Tech Landing, Dashboard, Instagram et Console Blitzer).

Création et publication des manuels d'administration Blitzer officiels (PDF et DOCX) et déploiement du Centre d'Aide F1 sur les consoles de gestion de flotte et de conformité conducteurs.

Documentation & Console Blitzer F1

• Centre d'Aide F1 Blitzer (`/admin/drivers` & `/blitzer/admin.html`) : Assistance administrateur avec recherche instantanée (Broadcast, Alerte, Suspendus, Mot de passe Admin, Ajout Livreur, Pays Owner).
• Manuels Blitzer PDF & DOCX Téléchargeables : Liens de téléchargement direct (`/docs/Manuel_Utilisateur_Blitzer.pdf` et `/docs/Manuel_Utilisateur_Blitzer.docx`).

Génération des manuels utilisateur officiels Market Plus aux formats PDF et DOCX, et intégration du Centre d'Aide Interactif accessible en 1 clic et via la touche clavier F1.

Documentation & Aide F1

• Centre d'Aide Touche F1 : Modale d'aide rapide avec recherche instantanée couvrant 100% des modules (Ventes, Crédit, Utilisateurs, Livreurs, Inventaire à l'aveugle, Stats, Pays).
• Manuels PDF & DOCX Téléchargeables : Liens de téléchargement direct depuis le centre d'aide F1 (`/docs/Manuel_Utilisateur_Market Plus.pdf` et `/docs/Manuel_Utilisateur_Market Plus.docx`).

Création et déploiement de la vitrine sociale Instagram interactive officielle pour SaaS-Tech avec présentation du catalogue, du bot IA WhatsApp Market Plus, du carnet de crédit et des solutions de paiement.

Nouveautés & Vitrine Sociale

• Page Instagram SaaS-Tech (`/instagram`) : Interface complète, interactive et responsive avec badge vérifié et liens de redirection vers saas-tech.io.
• Publications & Modales Interactives : Présentation des cas d'usage (AI Voice Commerce, Analytics FCFA, Flotte de livreurs et Mobile Money Wave/Orange Money).
• Stories / Highlights dynamiques : Stories intégrant les caractéristiques clés de la plateforme SaaS-Tech.

Verrouillage absolu du droit de création de pays au Software Product Owner (Owner) avec possibilité de délégation temporaire paramétrable à un Super Admin.

Ajouté & Sécurisé

• Exclusivité Owner (SPO) : Seul le Software Product Owner possède le droit de créer un nouveau pays. Aucun autre rôle n'a ce droit par défaut.
• Délégation Temporaire Paramétrable : Endpoints API POST /api/v1/countries/delegate-permission et POST /api/v1/countries/revoke-permission permettant à l'Owner de concéder (pour une durée en heures définie) ou de révoquer ce droit à un Super Admin.
• Vérification Automatique d'Expiration : Vérification dynamique de la fenêtre temporelle de délégation à chaque tentative de création.

Facilité de déploiement multi-pays en Afrique et accès instantané à la réhabilitation des conducteurs depuis l'interface d'administration.

Ajouté & Amélioré

• Modale & Bouton 🌍 + Ajouter un pays : Bouton d'action directe intégré sur l'ensemble des dashboards d'administration (`dashboard.html`, `drivers_admin.html`, `Blitzer/admin.html`) permettant la configuration et le clonage immédiat des pays d'Afrique (Mali, Burkina Faso, Sénégal, Côte d'Ivoire, Guinée, Niger, Togo, Bénin, Cameroun).
• Élargissement des Droits d'Administration : Autorisation des rôles super_admin et admin pour l'initialisation et la création de pays via l'API /api/v1/countries/create.
• Garantie d'Accès à la Réhabilitation : Le bouton vert Réhabiliter est désormais 100% visible et disponible pour tout conducteur suspendu, réactivant le compte et remettant le compteur d'avertissements à 0.

Mise en place d'un système gradué de modération comportementale des conducteurs Blitzer avec notifications automatiques et suspension de 3 à 6 mois au 3ème avertissement.

Ajouté & Amélioré

• Modale de Signalement des Conducteurs : Possibilité pour les administrateurs de signaler un conducteur pour motif précis (retards de livraison répétés, impolitesse, manquement à la sécurité).
• Graduation des Avertissements & Notifications Auto :
  • 1er Avertissement : Notification automatique transmise au livreur rappelant la charte de qualité.
  • 2ème Avertissement : Notification avec avertissement explicite d'une suspension automatique de 3 à 6 mois au 3ème avertissement.
  • 3ème Avertissement : Suspension automatique immédiate de 3 à 6 mois avec notification comportant les dates précises d'inactivation du compte.
• Preuve d'envoi & Traces administratives : Aperçu et popup de la notification automatique générée et consignation dans les notes internes du conducteur.

Intégration de la vitrine SaaS-Tech comme portail de lancement d'accueil central (depuis GitHub et le serveur FastAPI) pour propulser l'ensemble de l'écosystème.

Ajouté

• Page de Démarrage Centralisée (`saas_tech.html`) : Définition de la vitrine SaaS-Tech comme page racine `/` et `/saas-tech` de l'application.
• Portail de Lancement Market Plus & Blitzer : Liens et boutons d'action intégrés permettant d'accéder en 1-click à Market Plus App (`/dashboard`) et à Blitzer Livr (`/blitzer/admin.html`).
• Compatibilité GitHub Pages & Serveur : Génération de `index.html` à la racine et adaptation automatique des liens statiques/dynamiques.

Trois fonctionnalités majeures pour booster l'adoption et la rentabilité des commerçants sur le marché africain.

Ajouté

• Carnet de Crédit Digital & Relances WhatsApp : Gestion du crédit client (Daftar), suivi des acomptes, créances et génération automatique de relances amicales sur WhatsApp avec lien de paiement.
• Voice Commerce WhatsApp : Moteur de transcription et d'analyse d'intentions vocales en Wolof et Français régional avec suggestions de réponses.
• Mini-Facture Visuelle & Hub Multi-Mobile Money : Générateur de factures stylisées avec intégration 1-click pour Wave, Orange Money, MTN MoMo et Moov Money.

Cette version permet d'associer une date de production et un centre de coût aux produits lors de leur création ou modification.

Ajouté

• Date de production & Centre de coût : Ajout des deux nouvelles propriétés optionnelles dans les modèles backend, les schémas d'API Pydantic et le formulaire de création/édition de produit du tableau de bord.
• Affichage analytique : Visualisation directe de la date de production et du centre de coût dans les modes Liste et Grille du catalogue de produits.
• Affichage du Nom de Boutique en Entête : Personnalisation visuelle dynamique avec affichage du nom de la boutique dans la barre d'entête principale et bannière d'accueil sur le tableau de bord.

Intégration du nouvel algorithme officiel de calcul des livraisons Blitzer (175 FCFA/km de base, majoration Express +4%, commission Market Plus 2.5%, cascade d'attribution 3 min).

Ajouté

• Calculateur Kilométrique 175 FCFA/km : Tarif de base standard fixé à 175 FCFA par kilomètre avec répartition transparente entre le livreur (100% de la rémunération brute) et la commission Market Plus (2,5%).
• Tarification Express Majorée (+4%) : Livraison express prioritaire avec tarif au kilomètre fixé à 182 FCFA/km (175 FCFA × 1.04).
• Nomenclature et Terminologies Locales : Prise en charge automatique des appellations régionales de mototaxis par pays (Sénégal: Jakarta, Bénin: Zemidjan, Togo: Oleya, Niger: Kabou kabou, Nigéria: Okada, Cameroun: Bendskin).
• Cascade d'attribution 3 Minutes : Attribution prioritaire au conducteur membre actif le plus proche avec temporisation automatique de 3 minutes avant transmission au conducteur suivant.
• Transmission instantanée des identifiants au client : Communication automatique du numéro de membre Blitzer (ex: MX-2026-XXXX) et de la plaque d'immatriculation au client dès l'acceptation de la course.

Prise en charge spécifique du démarrage de la plateforme (0 conducteur encore inscrit) et harmonisation de la présentation des 3 options claires offertes au client en cas d'absence ou d'indisponibilité de livreur moto Blitzer.

Amélioré

• Scénario Démarrage / 0 Conducteur Inscrit : Prise en charge explicite du démarrage de l'application lorsqu'aucun livreur moto n'est encore inscrit en base de données ou actif sur la zone.
• Présentation des 3 Options Client : Envoi automatique d'un message bienveillant et structuré proposant 3 choix distincts : 1️⃣ Récupération gratuite en boutique (Click & Collect), 2️⃣ Livraison différée le jour prochain dès qu'un livreur est disponible, 3️⃣ S'occuper soi-même de la livraison (recourir à son propre livreur, un proche ou son véhicule).
• Mise à jour des Bannières de Confirmation : Actualisation des reçus de paiement Web et des réponses de l'assistant WhatsApp IA pour intégrer les 3 options.

Prise en charge intelligente de l'indisponibilité des conducteurs de Jakarta (grève, pénurie de mototaxis, zone non couverte) et envoi automatique d'un message d'information transparent et rassurant aux clients finaux.

Ajouté

• Gestion de l'indisponibilité des conducteurs Jakarta : Lors de la confirmation d'une commande avec livraison, si aucun livreur actif n'est disponible ou si le Mode Grève est actif, le système n'assigne aucun faux conducteur et envoie immédiatement un message d'information WhatsApp expliquant la situation.
• Options offertes au client : Proposition explicite de 2 alternatives simples : récupération en boutique sur place (Click & Collect) ou livraison différée prioritaire dès la reprise des motos.
• Mode Grève Admin Blitzer (🚨) : Bouton de basculement rapide dans l'interface Blitzer Admin permettant d'activer/désactiver le Mode Grève généralisé avec motif d'urgence et alerte rouge sur Radio Trafic.
• Bannière visuelle sur le Reçu de Paiement : Affichage d'un encadré d'avertissement bienveillant sur la page de paiement validée en cas d'absence de livreur immédiatement disponible.

Cette version introduit l'algorithme de déstockage FEFO (First Expired, First Out) pour la gestion d'inventaire Premium et ajoute des options de personnalisation d'affichage des colonnes pour les conducteurs.

Ajouté

• Gestion FEFO (First Expired, First Out) : Amélioration du moteur de stock pour déstocker en priorité absolue les articles dont la date d'expiration est la plus proche (péremption imminente), avant de basculer sur le standard de réception FIFO.
• Personnalisation des colonnes Admin : Option interactive de masquage/affichage des colonnes pour le tableau de bord des conducteurs Jakarta (Blitzer & Market Plus Admin) afin d'optimiser l'espace écran, avec persistance dans le navigateur (localStorage).
• Visibilité des onglets inactifs : Amélioration du style CSS des onglets de navigation inactifs du tableau de bord principal pour leur donner un fond gris moderne (#1f2937) et des bordures plus visibles, facilitant l'identification visuelle des boutons.
• Unités de mesure des produits : Prise en charge des unités de mesure (litre, kilogramme, pointures, bouteilles, caisses, ou personnalisées) lors de la création et modification des produits.
• Traduction de l'interface en français : Traduction des termes anglophones restants (ex: "Monthly", "Approved", "Pending") dans la table d'administration des livreurs Blitzer.

Cette version ajoute des outils d'administration suprêmes à l'application Market Plus via le rôle **Software Product Owner** et le système de **suspension temporaire/personnalisée** des comptes utilisateurs.

Ajouté

• Rôle Software Product Owner (SPO) : Nouveau rôle d'administration ultime permettant de créer, modifier et révoquer n'importe quel compte utilisateur ou Super Administrateur de la plateforme.
• Système de Suspension : Les comptes collaborateurs et administrateurs peuvent désormais être suspendus pour une durée spécifique (ex: 1 semaine, 3 mois, 6 mois) ou une durée libre en jours. Durant la suspension, l'accès à l'API et au tableau de bord est immédiatement bloqué.
• Redirection WhatsApp post-paiement : Le webhook de paiement notifie désormais automatiquement le compte WhatsApp du client en fin de transaction pour lui proposer de commander un nouvel article.

Cette version introduit le plan d'abonnement Market Plus Premium modulable, débloquant des modules de gestion d'inventaire à l'aveugle, des statistiques décisionnelles avancées et la synchronisation de catalogue WhatsApp Business. Les marchands peuvent souscrire aux modules à la carte (+1 500 F/mois par module) ou activer l'ensemble via le pack complet à tarif remisé (+3 500 F/mois additionnels).

Ajouté

• Espace Premium : Interface de souscription Premium avec modal présentant les bénéfices métier.
• Désabonnement en 1 clic : Option de retour au forfait standard Essential.
• Inventaire à l'aveugle : Module d'audit de stock masquant les stocks théoriques et imposant un double comptage en cas d'écart.
• Statistiques Temporelles : Rapport des ventes regroupées par Jour, Semaine, Mois, et Année.
• Synchronisation Catalogue : Import direct des articles depuis WhatsApp Commerce API.
• Suivi des Numéros de Série : Module Premium permettant de tracer chaque produit via un code ou numéro de série unique.
• Gestion et Suivi par Lots : Module Premium facilitant le regroupement et le suivi de lots de fabrication / approvisionnement.
• Dates d'Expiration : Module Premium de suivi et d'alertes automatiques sur les dates de péremption des produits périssables.
• Gestion FIFO (First In, First Out) : Module Premium automatisant le déstockage des produits les plus anciens en premier pour garantir la rotation.
• Mentions Légales (Impressum) : Information sur Market Plus Corp (Dakar) et Vercel (Hébergeur).
• Réseaux Sociaux : Intégration des liens officiels Facebook, Instagram et TikTok dans le pied de page du tableau de bord.

Corrigé

• Validation de pointure : Le Bot refuse désormais les pointures de chaussures non valides (doivent se situer entre 18 et 48).
• Persistance des paiements : Résolution de l'erreur 404 sur Vercel causée par la nature éphémère du stockage SQLite.

Ajouté

• Réseau Blitzer : Affectation de livraisons aux conducteurs Blitzer directement depuis le dashboard.
• Contrôle CNI Conducteurs : Validation stricte à 17 chiffres de la carte d'identité CEDEAO.
• Design Responsive : Optimisation totale pour les écrans mobiles.

Ajouté

• Conversations IA : Automatisation des ventes WhatsApp via Claude API.
• Liens de Paiement : Génération automatique des liens d'encaissement Wave et CinetPay.