Rapport Technique Complet : Agent IA WhatsApp & Dashboard CRM (Growth OS)

011. Fondations & Cadre Stratégique

---

021. Vision & Architecture Générale du Système

Le système est conçu sous forme de microservices isolés communiquant via un réseau virtuel Docker interne, garantissant une haute performance, une isolation des processus et un déploiement en **zéro-downtime**.

```mermaid graph TD Client[WhatsApp Client Web / App] <-->|WhatsApp Protocol| Bot[whatsapp-neural-agent (Node.js Service)] Bot <-->|Local Auth & Session Volume| Chrome[Headless Chromium] Bot <-->|JSON Database IO| LocalDB[(crm_db.json)] Bot <-->|Gemini API Gateway| Gemini[Google Gemini 1.5 Flash] Panel[Next.js CRM Admin Panel] <-->|Internal Gateway Bridge| API[Next.js API Routes] API <-->|HTTP Auth + Worker Secret| Bot Portal[Next.js Investor Portal] <-->|PostgreSQL DB Conn| Postg[(PostgreSQL / Prisma)] ```

03Spécifications des Composants :

1. **whatsapp-neural-agent (Node.js/Express)** : - Service central gérant la connexion au client WhatsApp via `whatsapp-web.js` et pilotant un navigateur Headless Chromium. - Héberge le moteur d'analyse sémantique connecté aux API Gemini de Google. - Enregistre et gère l'historique complet des discussions dans `data/crm_db.json`. 2. **Next.js CRM Panel (`panel_crm`)** : - Interface utilisateur d'administration sécurisée. - Utilise une route API Gateway pour servir de passerelle sécurisée vers le service Node.js. - Intègre les jetons de sécurité JWT (`admin_session`) et la validation par secret inter-services (`INTERNAL_WORKER_SECRET`). 3. **Next.js Investor Portal (`user_app`)** : - Portail web dédié aux investisseurs à l'adresse `https://app.ettaoulyabdelali.com/`. - Permet de simuler les gains selon les différents packs de capital et scénarios de rentabilité, de signer les contrats de co-investissement en ligne et de consulter l'audit des charges réelles de la société.

---

042. Refonte UX/UI du Dashboard CRM (`/agent`)

L'interface a été entièrement redessinée pour offrir un environnement de travail de type **Growth OS** ultra-premium, fluide et réactif, respectant une esthétique sombre et luxueuse (*Dark Carbon*).

05A. Structure Side-by-Side (Bento Layout)

L'affichage a été séparé en deux zones distinctes avec une répartition de largeur **70% / 30%** : * **Zone Principale (70% - Gauche)** : Un tableau maître affichant toutes les données du CRM (Total Leads, Noms, Secteurs de niche, Budgets, Potentiel de closing, Statuts d'appels, et Actions rapides). * **Sidebar Opérationnelle (30% - Droite)** : Un panneau vertical Bento contenant trois widgets dynamiques pour les actions quotidiennes à haute priorité.

06B. Sticky Headers 100% Fonctionnels

Pour résoudre le problème du défilement où l'en-tête du tableau disparaissait, nous avons restructuré le CSS au niveau des cellules individuelles. * L'application de la classe `sticky top-0 bg-[#0c0c0f] z-10 border-b border-zinc-800` directement sur les balises `th` (au lieu de la balise de ligne `tr`) garantit que les titres des colonnes restent parfaitement figés en haut du viewport lors d'un défilement infini.

07C. Esthétique Premium Carbon

* **Palette de couleurs** : Fond sombre `#0c0c0f`, bordures subtiles en gris zinc (`border-zinc-800`), accents vert émeraude pour les statuts actifs, orange/or pour les potentiels élevés. * **Typographie & Effets** : Utilisation d'Inter/Outfit, avec des badges translucides (`backdrop-blur-md`) et des micro-animations de transition au survol des lignes et boutons.

---

083. Les Widgets Opérationnels de la Sidebar (30% Droite)

Les trois widgets fournissent à Abdelali Ettaouly une vue immédiate sur ses priorités de closing et de suivi quotidien :

09📞 Widget 1 : Appels Urgents (Urgent Calls)

* **Objectif** : Lister instantanément les leads en attente d'interaction vocale sans avoir à parcourir le grand tableau. * **Règles de filtrage** : Affiche les contacts dont le `callStatus` est égal à `must_call` (À appeler d'urgence) ou `should_call_me` (Le client doit m'appeler). * **Actions directes** : Boutons d'appel direct en un clic et lien direct vers leur chat WhatsApp.

10💼 Widget 2 : Négociations du Jour (Today's Deals)

* **Objectif** : Donner une estimation du volume d'affaires en cours de discussion aujourd'hui. * **Règles de filtrage** : Analyse les contacts ayant eu une interaction (historique de chat mis à jour) au cours de la date actuelle. * **Calculateur de Pipeline CA** : Extrait la catégorie de budget (`low`, `medium`, `high`) et calcule la somme totale négociée selon la grille d'estimation : - `high` = **50 000 DH** - `medium` = **5 000 DH** - `low` = **1 000 DH** * **Affichage** : Affiche le montant total cumulé bien en évidence en haut du widget, suivi de la liste détaillée des clients concernés et de leur projet.

11🎯 Widget 3 : Situation & Objectifs (Active Clients)

* **Objectif** : Garder un œil sur les projets actifs et les livrables convenus. * **Règles de filtrage** : Filtre les contacts ayant le statut client payant (`isClient: true`). * **Informations affichées** : Secteur d'activité, montant facturé, et notes stratégiques détaillant les objectifs (ex: "Migration Next.js 15 + SEO Satellites 6 mois").

---

124. Portail d'Investisseur Premium (`app.ettaoulyabdelali.com`)

Pour structurer la levée de fonds interne et permettre aux partenaires d'injecter du capital dans nos systèmes (SEO Matrix, SaaS, IPTV Engine), nous avons conçu une interface Next.js 15 haut de gamme.

13A. Barrière de Qualification (Frais de 100 DH)

Pour protéger nos secrets industriels et éviter les curieux (window shoppers) ou concurrents espions, l'accès complet au portail est verrouillé par des **frais de dossier de 100 DH (non remboursables)**. Une bannière floutée et bloquante invite l'utilisateur à régler cette barrière de sécurité avant de pouvoir visualiser les metrics avancés.

14B. Audit des Charges Réelles de la Société

Le portail affiche en toute transparence la structure financière d'Ettaouly Digital : * **Revenu Mensuel Brut** : 8 000 DH (4 clients confirmés × 2 000 DH/mois). * **Charges Mensuelles Détaillées** : - Connexion Internet : 500 DH / mois. - VPS Cloud Services : 1 500 DH / an (~125 DH / mois). - Publicités & Campagnes Ads : 50 DH × 30 jours = 1 500 DH / mois. - PC / Matériel de Travail : Amorti sur 2 ans (10 000 DH total) = ~417 DH / mois. * **Total des Charges Mensuelles** : **2 542 DH / mois**. * **Profit Net de la Société** : **5 458 DH / mois** (~16 374 DH par cycle de 3 mois).

15C. Simulateur de Scénarios d'Investissement Dynamique

L'investisseur saisit son capital d'investissement $I$ et sélectionne l'un des 4 packs : 1. **Bronze Pack** (1 000 DH) : Multiplicateur 1.0x | Période de blocage de 3 mois. 2. **Silver Pack** (5 000 DH) : Multiplicateur 1.2x | Période de blocage de 3 mois. 3. **Gold Pack** (10 000 DH) : Multiplicateur 1.5x | Période de blocage de 3 mois. 4. **Platinum Pack** (50 000 DH+) : Multiplicateur 2.0x | Période de blocage de 3 mois.

La formule mathématique dynamique calcule le gain estimé sur un cycle de 3 mois (sur une base de pool global de 450 000 DH) selon 3 scénarios : * **Scénario Faible (Weak)** : Profit global du système de 15 000 DH sur 3 mois. $$\text{Gain} = 15\,000 \times \left( \frac{I}{450\,000 + I} \right) \times \text{Multiplicateur}$$ * **Scénario Moyen (Average)** : Profit global du système de 60 000 DH sur 3 mois. $$\text{Gain} = 60\,000 \times \left( \frac{I}{450\,000 + I} \right) \times \text{Multiplicateur}$$ * **Scénario Fort (Strong)** : Profit global du système de 150 000 DH sur 3 mois. $$\text{Gain} = 150\,000 \times \left( \frac{I}{450\,000 + I} \right) \times \text{Multiplicateur}$$

16D. Compteur de Verrouillage (90-Day Lock-In)

Affiche visuellement les jours restants avant la fin du cycle trimestriel (ex: 74 jours restants sur 90) pour indiquer la maturité du capital.

17E. Signature Électronique de Contrat

Un module permet à l'investisseur d'apposer sa signature électronique directement sur l'interface Next.js pour valider les conditions générales et recevoir sa facture officielle.

---

185. Moteur d'Analyse Sémantique par IA (Gemini 1.5 Flash)

Nous avons migré l'agent conversationnel vers le modèle **Gemini 1.5 Flash** (`gemini-1.5-flash`), garantissant des réponses extrêmement rapides, précises et un coût d'API optimisé.

19A. Invite de Commande (Prompt) Système

Le prompt envoyé à Gemini force l'extraction stricte des entités au format JSON brut :

```json { "clientName": "Smiya réelle de la personne (exclure les numéros de téléphone)", "sector": "Niche d'activité (ex: E-commerce, Cabinet Dentaire, Agence Auto, SEO...)", "address": "Ville ou localisation (ex: Casablanca, Marrakech, Rabat)", "budget": "low | medium | high | inconnu", "potential": "low | medium | high | inconnu", "notes": "Résumé professionnel de 2-3 phrases décrivant le projet et les points de blocage.", "hasMaps": "yes | no | inconnu", "hasBrand": "yes | no | inconnu", "hasWebsite": "yes | no | inconnu", "paymentStatus": "paid | pending | unpaid" } ```

---

206. Intégration des 12 Business & Investment Laws (Elite Brain Prompt)

Le cerveau logique de l'Agent IA WhatsApp a été renforcé avec l'intégration de **12 lois et philosophies d'affaires** majeures. Chaque message client est filtré à travers ce noyau logique pour orienter les négociations et la psychologie de vente :

1. **“Cashflow is King”** (Robert Kiyosaki - *Rich Dad Poor Dad*) : * *L-Fikra :* Ce qui compte n'est pas le gain ponctuel, mais le flux de kash mensuel récurrent (MRR). * *Application Bot :* Propose des abonnements et contrats mensuels plutôt que des deals one-shot. 2. **“Buy Assets, Not Work”** (Warren Buffett Mindset - *The Intelligent Investor*) : * *L-Fikra :* Construire des systèmes automatiques qui génèrent de l'argent. * *Application Bot :* Met en avant nos funnels automatisés, pages SEO satellites, et agents IA opérationnels 24h/24. 3. **“Positioning is Everything”** (Al Ries - *Positioning: The Battle for your Mind*) : * *L-Fikra :* Ce qui compte est la perception de la marque dans l'esprit du client. * *Application Bot :* Ne se positionne pas comme "créateur de sites web", mais comme "Revenue Growth System for SMEs". 4. **“Monopoly Strategy”** (Peter Thiel - *Zero to One*) : * *L-Fikra :* Éviter la concurrence brutale en dominant une niche hyper-ciblée. * *Application Bot :* Domine le marché des intégrations IA locales et du référencement organique marocain. 5. **“Permissionless Leverage”** (Naval Ravikant) : * *L-Fikra :* Utiliser le code et les médias comme multiplicateurs d'efforts sans permission. * *Application Bot :* Vend des architectures logicielles automatisées. 6. **“Second-Order Thinking”** (Ray Dalio - *Principles*) : * *L-Fikra :* Évaluer les conséquences des conséquences à long terme. * *Application Bot :* Calcule les risques de chaque choix technique ou financier avant d'agir. 7. **“Principles of Influence”** (Robert Cialdini) : * *L-Fikra :* Psychologie de persuasion (Autorité, Preuve sociale, Rareté, Réciprocité). * *Application Bot :* Mentionne nos études de cas réelles (Reedwood Logistics, Herboda) et limite le nombre de places d'investissement (50 investisseurs max). 8. **“The Dealmaker (Leverage Engine)”** (Donald Trump Mindset - *Art of the Deal*) : * *L-Fikra :* Toujours négocier en position de force en exploitant les leviers techniques, médias et capitaux. * *Application Bot :* Réalise des closings agressifs et des propositions de co-investissement irrésistibles. 9. **“Numbers Don’t Lie”** (Wall Street Mindset) : * *L-Fikra :* Pas de chiffres = pas de décision. * *Application Bot :* Traduit toutes les propositions en métriques claires : CAC, LTV, ROI publicitaire. 10. **“Execution Beats Ideas”** (Paul Graham / Silicon Valley Mindset) : * *L-Fikra :* L'idée ne vaut rien sans exécution rapide. * *Application Bot :* Pousse à lancer immédiatement des campagnes de test et des micro-tunnels de vente. 11. **“Capital Allocation”** (Ray Dalio & Warren Buffett) : * *L-Fikra :* Gérer et réinvestir stratégiquement les bénéfices. * *Application Bot :* Formule de pitch de réinvestissement : 40% croissance/ads, 20% outils, 20% opérations, 20% réserves. 12. **“System > Hustle”** (Modern Business Thinking) : * *L-Fikra :* Ne pas s'épuiser à travailler *dans* l'entreprise, mais construire un système qui tourne *sans* soi. * *Application Bot :* Met en avant l'interconnexion de nos API WhatsApp, CRM et portails automatisés.

---

217. Modules d'Automatisation en Clavardage (WhatsApp Triggers)

L'agent WhatsApp possède désormais 4 modules interactifs activés par des mots-clés ou le contexte de discussion :

22A. Qualification Automatique BANT (Score Automatique)

L'IA évalue chaque prospect sur 100 points : * **Budget (30 pts)** | **Urgence (20 pts)** | **Motivation (20 pts)** | **Pouvoir de décision (30 pts)**. * Si le score est supérieur à 70, le badge change en direct dans le CRM. Si le prospect est un **Hot Lead (90-100)** et est prêt à payer, l'IA lui envoie le RIB CIH Bank ou l'option Cash Plus immédiatement pour closer le deal.

23B. ROI Calculator & Projections Financières

Si un prospect demande une estimation de retour sur investissement publicitaire (ex: *"combien je vais gagner si je mets 5000 DH dans les Ads ?"*), l'agent applique la formule : * Nombre de Leads = $\text{Budget Ads} / 10$ DH (coût moyen par lead). * Taux de conversion = 5%. * ROI = $\frac{(\text{Conversions} \times \text{Valeur Panier}) - \text{Budget Ads}}{\text{Budget Ads}} \times 100$. * L'IA affiche clairement le nombre de leads, de ventes estimées, le ROI net et le délai de remboursement (Payback Period).

24C. Concurrent Spy (Analyse concurrentielle SEO)

Si le client envoie le site web de son concurrent direct, l'agent IA effectue instantanément une analyse sémantique et technique : * Opportunités majeures en référencement local (GMB). * Points forts et faiblesses techniques (lenteur de chargement, manque de structure). * Vecteurs de domination stratégiques à déployer.

25D. Mini Hedge Fund (Pitch Partenaires)

Si le contact s'intéresse à l'investissement Ettaouly Digital, l'agent présente la structure de co-investissement, les packs de capital (Bronze, Silver, Gold, Platinum) ainsi que la barrière des 100 DH pour s'inscrire, en insistant sur la rareté (limite de 50 investisseurs, 10 places restantes, fermeture le 10 Juillet 2026).

---

268. Qualification Avancée, Vente Automatisée & Relances IA

Pour maximiser les conversions et automatiser le tunnel de vente d'Abdelali Ettaouly, une mise à niveau majeure a été intégrée dans l'agent WhatsApp et l'interface du Dashboard CRM.

27A. Indicateurs de Qualification Marketing & Badges UX

Pour chaque prospect, l'agent IA évalue et met à jour en temps réel 4 critères fondamentaux affichés de manière compacte sous forme d'icônes dans la colonne **"Indicateurs"** du grand tableau : * 🗺️ **Fiche Google Maps (GMB)** (`hasMaps` : `yes` / `no` / `inconnu`) * 🏷️ **Logo / Identité de marque** (`hasBrand` : `yes` / `no` / `inconnu`) * 🌐 **Site Web / Landing Page** (`hasWebsite` : `yes` / `no` / `inconnu`) * 💳 **État du Paiement** (`paymentStatus` : `paid` (Payé - Vert) / `pending` (En attente - Orange) / `unpaid` (Non payé - Rouge/Gris))

Des filtres sélecteurs dropdown dynamiques ont été ajoutés directement dans les en-têtes de colonnes du tableau principal pour permettre à Abdelali de filtrer instantanément les leads (ex: afficher uniquement les prospects sans site web ou les transactions en attente de paiement).

28B. Tunnel de Vente & Grille Tarifaire Flexibles

L'IA a été instruite pour identifier les besoins manquants d'un prospect de manière fluide et proposer les services de croissance numérique d'Ettaouly Digital à des tarifs très flexibles : 1. **Création & Optimisation de Fiche Google Maps (Local SEO)** : Proposé à **700 DH** (négociable jusqu'à **200 DH** pour les bas budgets). 2. **Gestion de Page Réseaux Sociaux (Social Media Management)** : Proposé entre **1000 DH** et **1500 DH**. 3. **Publicité Payante (Facebook/Instagram Ads)** : Proposé à **1500 DH**. 4. **Landing Page sur-mesure / Développement Web** : À partir de **1000 DH**.

L'IA s'adapte aux capacités financières du client (de 200 DH à 1500 DH) pour maximiser les chances d'acquisition initiale.

29C. Tunnels de Paiement & Closing Direct (Local & International)

Dès qu'un prospect accepte l'offre ou manifeste l'intention de payer, l'agent WhatsApp l'oriente automatiquement vers les canaux correspondants : * **Canaux Locaux (Maroc)** : - **CIH Bank (RIB)** : `230 780 5119849211012700 66` (IBAN : `MA64 2307 8051 1984 9211 0127 0066`, SWIFT : `CIHMMAMC`, Titulaire : Monsieur Abdelali Ettaouly). - **Cash Plus** : Envoyer au numéro `+212661593557` (Titulaire : Abdelali Ettaouly) et renvoyer le code reçu sur WhatsApp. * **Canaux Internationaux** : - **PayPal** : Envoyer à l'adresse marchande `[email protected]` (Option "Envoi à un proche / Friends & Family" pour éviter les frais et les suspensions) avec conversion de 1 USD = 10 MAD. - **Cryptomonnaies (Binance / USDT)** : L'IA valide le paiement en crypto et invite le client à lancer un appel WhatsApp rapide avec Abdelali pour obtenir le QR Code ou l'ID Binance Pay actif de manière sécurisée. - **Western Union / MoneyGram / RIA** : Envoyer à Abdelali Ettaouly, Maroc (Mobile : `+212661593557`).

Dès le partage des coordonnées de facturation, l'IA marque automatiquement le prospect comme `[UPDATE_PAYMENT: pending]` dans le CRM.

30D. Stratégie de Closing par Appel Vocal (WhatsApp Call Drive)

L'agent IA a pour consigne systématique de rabattre le client ou l'investisseur vers un appel téléphonique vocal en direct sur le WhatsApp d'Abdelali Ettaouly (`+212661593557`) pour finaliser la vente ("bach nsed m3a en appel"). L'IA utilise des tournures incitatives telles que : *"Aji ndirou un court appel WhatsApp dba bach n-werrik l'architecture o n-seddou l-deal direct."*

31E. Alignement Multilingue Automatique (Multilingual Policy)

Le bot est configuré pour détecter instantanément la langue de l'interlocuteur (Arabe, Français, Anglais, Espagnol, Darija, etc.) et mener la totalité de la négociation et de l'explication dans cette même langue, tout en appliquant les 12 lois business et l'esprit commercial d'Ettaouly Digital.

32F. Relance Manuelle Inteligente (IA Darija Persuasive)

Un bouton spécial **"Relancer via IA (Darija Persuasive)"** a été ajouté dans le Drawer de chaque contact : * D'un simple clic, le dashboard appelle l'API de relance de l'agent. * L'IA analyse l'historique complet des discussions passées pour rédiger un message de relance ultra-court (1 à 2 phrases max) personnalisé, percutant et rédigé en Darija marocaine raffinée mélangée aux termes digitaux français. * Le message est instantanément expédié sur le WhatsApp du prospect pour réveiller son intérêt sans intervention manuelle.

33G. Système d'Alertes et Notifications directes à l'Administrateur

Un système d'alertes instantanées a été configuré pour envoyer des rapports détaillés directement au numéro WhatsApp d'Abdelali Ettaouly (`+212661593557`) dès qu'un évènement critique se produit : * **Déclencheurs (Triggers)** : 1. Qualification d'un prospect chaud (`[ALERT_LEAD: ...]`). 2. Génération automatique d'une facture (`[GENERATE_INVOICE: ...]`). 3. Mise à jour de l'état de facturation/virement (`[UPDATE_PAYMENT: pending]` ou `[UPDATE_PAYMENT: paid]`). * **Structure du Message de Notification** : - **Titre de l'Alerte** : Spécifie le motif (ex: ALERT LEAD 🔥, GENERATION FACTURE 📄, STATUT PAIEMENT 💳). - **Infos Client** : Nom du contact, numéro et lien direct de discussion rapide (`wa.me`). - **Qualification BANT** : Niche d'activité, budget estimé, et potentiel de closing. - **Facturation/Paiement** : Statut actuel (Paid/Pending) et détails de la facture générée si applicable. - **Remarque & Notes de l'IA** : Synthèse de la situation et des besoins du client. - **CTA (Call to Action)** : Lien direct pour prendre le relais manuel.

---

349. Schéma de Base de Données (PostgreSQL / Prisma)

Pour supporter l'infrastructure du portail investisseurs et la liaison avec les clients actifs du CRM, le schéma relationnel suivant a été établi :

```prisma datasource db { provider = "postgresql" url = env("DATABASE_URL") }

generator client { provider = "prisma-client-js" }

model Partner { id String @id @default(uuid()) name String email String @unique phone String tier String // BRONZE | SILVER | GOLD | PLATINUM status String // ACTIVE | PENDING | INACTIVE registeredFeePaid Boolean @default(false) createdAt DateTime @default(now()) investments Investment[] payouts Payout[] }

model Investment { id String @id @default(uuid()) partnerId String partner Partner @relation(fields: [partnerId], references: [id], onDelete: Cascade) amount Float lockInDaysRemaining Int @default(90) dateInvested DateTime @default(now()) status String // ACTIVE | MATURED | WITHDRAWN }

model Payout { id String @id @default(uuid()) partnerId String partner Partner @relation(fields: [partnerId], references: [id], onDelete: Cascade) amount Float systemRevenue Float systemProfit Float payoutDate DateTime @default(now()) }

model Client { id String @id @default(uuid()) name String company String niche String monthlyFee Float status String // ACTIVE | PAUSED | COMPLETED } ```

---

3510. Sécurisation & Protection Infrastructure

* **Endpoint d'Authentification QR & Connexion Live** : - L'accès visuel et le statut de connexion au compte WhatsApp sont disponibles de manière sécurisée à l'adresse https://whatsapp.ettaoulyabdelali.com/qr (permettant un scan et un monitoring à chaud sans redémarrer le cluster Docker). * **Validation Cryptographique** : Les endpoints de modification et d'analyse ne sont accessibles qu'aux requêtes signées par le serveur API Next.js grâce à la vérification d'en-tête `Authorization: Bearer ${INTERNAL_WORKER_SECRET}`. * **Persistance des Données** : Les données du CRM sont montées via un volume Docker bidirectionnel (`./whatsapp-neural-agent/data:/app/data`), ce qui garantit qu'aucune donnée n'est perdue lors du redémarrage ou de la mise à jour des conteneurs. * **Gestion des Sessions & Prévention des Crashs Chromium** : - Résolution des blocages liés à la corruption du cache de session (`.wwebjs_auth` et `.wwebjs_cache` sur le VPS) en réinitialisant proprement les dossiers de cache et en optimisant le script de nettoyage des processus orphelins (SingletonLock Code 21).

--- *Rapport technique établi pour l'infrastructure Growth OS d'Abdelali Ettaouly - Juin 2026.*