# **Sommaire du Cahier des Charges : Solution Circuy**

### **1. Vision et Positionnement Stratégique**
*   **1.1. Proposition de Valeur :** Le SDK d'onboarding "Sovereign" intuitif.
*   **1.2. Différenciateurs Clés (Moat) :**
    *   Souveraineté européenne et conformité RGPD native.
    *   Architecture hydratée (Event-driven) synchronisant front et backend.
    *   Résilience du ciblage DOM (Auto-healing).

### **2. Architecture Globale du Système**
*   **2.1. Les 3 Piliers du Produit :** SDK Client, Extension Chrome (Éditeur), et Dashboard Backend.
*   **2.2. Flux de Données Type :** De la capture par l'extension à l'exécution par le moteur Shepherd.js via CDN.

### **3. Spécifications du SDK JavaScript Client**
*   **3.1. Contraintes de Performance :**
    *   Taille du bundle optimisé sans dépendance lourde.
    *   Chargement asynchrone et non-bloquant pour préserver les *Core Web Vitals*.
*   **3.2. Moteur d'Affichage et Isolation :**
    *   Utilisation de Shepherd.js et Floating UI.
    *   **Isolation stricte via Shadow DOM** (mode: 'closed').
*   **3.3. Intelligence et Résilience :**
    *   MutationObserver pour la détection d'éléments asynchrones (SPAs).
    *   Algorithmes d'Auto-healing (Sélecteurs de secours, ARIA, texte).
*   **3.4. Gestion de l'État et Persistance :**
    *   Persistance locale (localStorage) pour les parcours multi-pages.
    *   Mécanisme d'expiration (TTL) et synchronisation avec le Targeting Engine.

### **4. Extension Chrome (Éditeur No-Code)**
*   **4.1. Interface de Création :**
    *   Overlay flottant encapsulé et isolation CSS.
    *   Modes de positionnement (Panneau, Dock, Fenêtre).
*   **4.2. Mode Inspecteur Visuel :**
    *   Capture multi-critères des sélecteurs DOM.
    *   Configuration des étapes (titres, textes, positions, déclencheurs).
*   **4.3. Moteur d'Embranchements (Branching Engine) :**
    *   Création de questions à choix multiples et routage dynamique.

### **5. Module IA "Page-Skill" et Agent Dynamique**
*   **5.1. Moteur d'Extraction et d'Anonymisation :**
    *   Construction de l'A11y Tree (Accessibilité).
    *   **Masquage PII (RGPD) :** Algorithmes de filtrage des données sensibles.
*   **5.2. Génération de Parcours Runtime :**
    *   Modèle de données Page-Skill JSON et prompt LLM structuré.
    *   Exécution éphémère et workflow de validation (Human-in-the-loop).

### **6. Backend et Dashboard de Gestion**
*   **6.1. Administration des Scénarios :** Versionnage, activation et prévisualisation.
*   **6.2. Moteur de Ciblage (Targeting Engine) :** Segmentation par rôle, langue, URL et limitation de fréquence.
*   **6.3. Analytics et Funnels :** Taux de complétion, détection des points d'abandon et statistiques de choix.

### **7. Infrastructure Technique et Sécurité**
*   **7.1. Stack Technologique :** WXT (Extension), TypeScript, Hono (Backend), PostgreSQL/Drizzle.
*   **7.2. Stratégie CDN et Distribution :**
    *   Cache Edge et authentification par clé publique dans l'URL.
    *   Protocole de purge instantanée ("Zero Redeploy").
*   **7.3. Authentification et SSO :**
    *   Modèle hybride OAuth 2.0 et **Passkeys (WebAuthn)**.
    *   Synchronisation "Zero-Click" entre le Dashboard et l'extension.
*   **7.4. Hébergement Souverain :** Déploiement sur OVHcloud ou Greenshift.