Linkerflow

Connexion API

**Titre du Projet : Développement du module « Connecteur SEO Afrique » pour Linkerflow**

**Contexte**
L'objectif est de développer en 24h le module de connexion à Google Search Console (GSC) pour une version africaine de l'outil Linkerflow. Cette plateforme automatise le maillage interne pour optimiser le SEO. La phase actuelle consiste à construire la passerelle sécurisée permettant aux utilisateurs d'importer leurs données GSC. L'application doit être pensée pour une expérience utilisateur fluide, compatible avec des contextes de connexion variés en Afrique, et garantir une intégration robuste des données de performance (clics, impressions, CTR, position) pour alimenter l'algorithme de maillage intelligent.

**Données (Entités et Champs)**
*   **Utilisateur :** ID, nom, email, téléphone (format international), pays.
*   **Propriété SEO :** ID utilisateur, URL du site, statut de vérification GSC, dernier token d'accès, date de dernière synchronisation.
*   **Performance (Données GSC) :** Page URL, Requête (Keyword), Clics, Impressions, CTR, Position moyenne, Date.
*   **Audit Interne :** Liste des liens existants vs liens suggérés par l'IA de Linkerflow.

**Écrans**
1.  **Dashboard d'Onboarding :** Interface simplifiée affichant la valeur ajoutée (ROI SEO).
2.  **Passerelle GSC :** Bouton « Connecter avec Google » utilisant OAuth2, avec gestion des permissions spécifiques.
3.  **Tableau de Bord de Performance :** Visualisation des données importées avec graphiques clairs.
4.  **Interface de Validation de Maillage :** Liste des pages avec suggestions de liens automatiques, bouton d'action pour valider/appliquer.
5.  **Paramètres de compte :** Gestion du profil et préférences de notification.

**Règles métier**
*   **Sécurité OAuth :** Stockage chiffré des tokens d'accès GSC. Aucun token ne doit être exposé en log.
*   **Sync Data :** Rafraîchissement automatique des données toutes les 24h. Implémenter une gestion fine des limites d'API (quota Google).
*   **Algorithme SEO :** Prioriser les pages à fort potentiel (impressions élevées, CTR faible) pour suggérer des liens internes.
*   **Support local :** Les notifications de succès/erreur de synchronisation doivent être envoyées via WhatsApp (API Twilio/WABA) pour une réactivité immédiate.

**Outils et Intégrations**
*   **Backend :** Node.js avec NestJS pour une architecture scalable.
*   **Base de données :** PostgreSQL (Supabase) pour la gestion des relations.
*   **Paiement & Abonnement :** Intégration de CinetPay ou FedaPay pour les abonnements SaaS locaux, permettant de payer via Mobile Money (Orange Money, MTN, Wave).
*   **Communication :** Intégration WhatsApp Business API pour les alertes SEO hebdomadaires.
*   **Hébergement :** AWS ou Render avec déploiement rapide.

**Vérification (QA)**
*   Test d'authentification OAuth : Vérifier la révocation des tokens.
*   Test de charge : Vérifier la récupération des données pour des sites à fort volume (1000+ pages).
*   Test de conversion : Vérifier que le paiement Mobile Money via CinetPay/FedaPay déclenche correctement l'accès à la fonctionnalité Premium.
*   Validation de l'UX mobile : S'assurer que le tableau de bord est parfaitement lisible sur smartphones (usage dominant en Afrique).