====== Guide-Decision ======

Application desktop Mac d'analyse de données web avec recommandations IA personnalisées.

{{ :icon.svg?100 |Guide-Decision Logo}}
[[https://dl.ticoet.me/downloads/1-SEO-GEO/2-entity-authority-signals-v1/guide-decision-v2.zip|Télécharger l'application]]
===== Présentation =====

**Guide-Decision** est un outil d'aide à la décision pour les propriétaires de sites web. Il connecte vos sources de données analytics (Google Analytics 4, Matomo), analyse vos métriques, et génère des recommandations personnalisées grâce à l'intelligence artificielle.

<WRAP center round tip 80%>
Contrairement aux dashboards classiques, Guide-Decision **comprend votre activité** : type de site, contraintes techniques, budget, objectifs... et adapte ses conseils en conséquence.
</WRAP>

===== Fonctionnalités =====

==== Connexion Multi-Sources ====

^ Source ^ Authentification ^ Données récupérées ^
| Google Analytics 4 | OAuth 2.0 | Sessions, utilisateurs, pages vues, conversions |
| Matomo | Token API | Visites, pages vues, sources, rebond |

==== Gestion Multi-Comptes ====

Idéal pour les consultants et agences :
  * Plusieurs comptes GA4/Matomo
  * Plusieurs sites par compte
  * Contexte client distinct par site

==== Contexte Client ====

Pour chaque site, définissez :
  * **Description de l'activité** : Texte libre décrivant le business
  * **CMS utilisé** : WordPress/Elementor, Gutenberg, Shopify, Wix, etc.
  * **Budget** : DIY, Limité, Modéré, Confortable
  * **Objectifs** : Visibilité, Leads, Ventes, Engagement, Fidélisation, Branding
  * **Développeur disponible** : Oui/Non
  * **Contraintes techniques** : Limitations connues

==== Scraping Intelligent ====

L'application analyse automatiquement :
  * **Sitemap XML** : Structure et nombre de pages
  * **Pages clés** : Titre, meta description, H1/H2, contenu
  * **Qualité SEO** : Pages sans meta, sans H1, mots par page

==== Analyse IA (Ollama) ====

Génération de recommandations personnalisées :
  * **Éditoriales** : Idées d'articles, thèmes de contenu
  * **Stratégiques** : Partenariats, positionnement, offres
  * **Techniques** : Si développeur disponible

===== Types de Sites Supportés =====

^ Type ^ KPIs Spécifiques ^
| Blog | Pages vues, temps lecture, rebond, partages |
| E-commerce | CA, conversion, panier moyen, abandon |
| Formations | Inscriptions, achèvement, revenue/cours |
| Lieu culturel | Billetterie, remplissage, événements |
| Compagnie artistique | Demandes programmation, vidéos |
| Restaurant | Réservations, avis, GMB |
| Artisan | Devis, contacts, SEO local |
| Consultant | Leads, qualification, rétention |
| Tourisme | Réservations, saisonnalité |
| Association | Dons, bénévoles, adhésions |
| Sport | Adhésions, rétention, sponsors |
| Santé | RDV, fidélisation patients |
| Immobilier | Contacts, visites virtuelles |
| Communication | CTR, ROI, A/B testing |
| RH | Candidatures, time-to-hire |
| Presse | Mentions, sentiment, influence |
| Local | SEO local, conversions géo |
| Custom | Personnalisé |

===== Installation =====

==== Prérequis ====

  * **Node.js 18+** : https://nodejs.org/
  * **Python 3.10+** : Installé par défaut sur macOS
  * **Ollama** (optionnel) : https://ollama.ai/

==== Installation Rapide ====

<code bash>
# Cloner le dépôt
git clone https://github.com/VOTRE_USER/guide-decision.git
cd guide-decision

# Installer les dépendances
npm install
pip3 install requests

# Lancer l'application
./start.sh
</code>

==== Installation Manuelle ====

<code bash>
# Terminal 1 - Serveur local
python3 local-server.py

# Terminal 2 - Application React
npm run dev
</code>

Ouvrir : **http://localhost:1420/**

===== Configuration =====

==== Ajouter Matomo ====

  - Paramètres > Ajouter un compte Matomo
  - Renseigner :
    * URL Matomo (ex: ''https://stats.example.com'')
    * Site ID
    * Token API (Administration > Personnel > Sécurité)

==== Ajouter Google Analytics 4 ====

  - Paramètres > Connecter un compte Google
  - Autoriser l'accès
  - Ajouter un site avec le Property ID GA4

<WRAP center round important 80%>
L'avertissement "application non vérifiée" est normal pour une app personnelle. Cliquez sur "Avancé" puis "Continuer".
</WRAP>

==== Activer l'Analyse IA ====

<code bash>
# Installer Ollama
brew install ollama

# Télécharger un modèle
ollama pull llama3.2
</code>

Dans l'app : Paramètres > IA > Activer

===== Architecture Technique =====

<code>
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   GA4 API   │     │ Matomo API  │     │  Site Web   │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       │    ┌──────────────┴──────────────┐    │
       └───►│     local-server.py         │◄───┘
            │   (proxy CORS + scraping)   │
            └──────────────┬──────────────┘
                           │
            ┌──────────────▼──────────────┐
            │     Frontend React          │
            │  - Dashboard + KPIs         │
            │  - Recommandations          │
            └──────────────┬──────────────┘
                           │
            ┌──────────────▼──────────────┐
            │     Ollama (local)          │
            │  - Analyse contextuelle     │
            │  - Recommandations IA       │
            └─────────────────────────────┘
</code>

==== Stack Technique ====

^ Composant ^ Technologie ^
| Frontend | React 18 + TypeScript + Vite |
| Styling | Tailwind CSS |
| State | Zustand (persistance localStorage) |
| Proxy | Python HTTP server |
| IA | Ollama (local) |

===== Sécurité et Confidentialité =====

<WRAP center round tip 80%>
  * **Données locales** : Tout est stocké en localStorage
  * **IA locale** : Ollama tourne sur votre machine
  * **Tokens** : Jamais partagés avec des tiers
</WRAP>

===== Voir Aussi =====

  * [[entity-authority-signals|GEO Authority Suite]] - Plugin WordPress SEO
  * [[geo_blocks_suite|GEO Blocks Suite]] - Blocs Gutenberg pour l'IA
  * [[geo-content-optimizer|GEO Content Optimizer]] - Score de citabilité
  * [[audit-geo-online|Audit Online]] - Audit SEO rapide

===== Liens Externes =====

  * [[https://ticoet.fr/suite-doutils-geo-pour-wordpress-audit-en-ligne/|Suite d'outils GEO pour WordPress]]
  * [[https://ollama.ai/|Ollama - IA locale]]

===== Changelog =====

==== Version 2.0.0 (2024-02) ====

  * Refonte complète de l'interface
  * Ajout du formulaire Contexte Client
  * Scraping automatique des pages clés
  * Analyse sitemap XML
  * Recommandations IA contextualisées
  * Support multi-comptes

{{tag>analytics seo ia matomo google-analytics recommandations}}