README

## 1.19.4 — Health des garde-fous Studio — 2026-09-12

- Le pulse Studio expose la disponibilité des garde-fous SEO locaux sous forme de score/fraîcheur explicables.
- Studio reste local-first et bloque l interprétation positive si les règles locales sont absentes.

## 1.19.3 — Pulse opérationnel transversal — 2026-09-12

- Expose au Core un pulse du nombre de règles SEO locales et des clients actifs éligibles à Studio.
- Conserve les garde-fous local-first avant tout appel IA.

# Studio AWM 1.19.1 — identité visuelle réelle + finalisation complète après approbation

Studio AWM transforme maintenant l approbation d une maquette en véritable **départ de production**. Le parcours principal est volontairement simple : approuver une direction, vérifier rapidement l identité et les médias, puis laisser Studio construire un brouillon Elementor complet.

## Parcours stagiaire après approbation

1. **Maquette** — A, B ou C est approuvée.
2. **Identité & photos** — Studio récupère les couleurs et le logo via le Site DNA, conserve le header/footer du site par défaut et recherche d abord des photos déjà présentes sur les pages Elementor autorisées.
3. **Elementor** — le bouton **Finaliser et créer le brouillon** prépare les médias manquants seulement si nécessaire, contrôle le SEO local, puis crée la page en brouillon.
4. **Vérification** — la page peut être ouverte en aperçu ou dans Elementor avant toute publication.

### Économie de tokens

La recherche de photos du site, le choix des couleurs, le gabarit header/footer, les contrôles SEO et la préparation de production sont locaux. **OpenAI Image n est appelé que pour les images réellement manquantes** lorsque le mode Auto/IA le demande. Le référentiel SEO AWM de 250 règles reste local et seuls les sous-ensembles déjà prévus sont transmis lorsque l IA est réellement nécessaire.

### Header / footer

Le gabarit recommandé est **Utiliser le header/footer du site**. Studio envoie alors `full_width` au Hub Client afin que la nouvelle page Elementor utilise le header/footer WordPress existant. Le mode Canvas reste disponible comme choix volontaire.

### Sécurité

Les pages restent créées en **brouillon**. Les règles historiques de Studio demeurent : SEO sensible protégé, Site DNA, validations humaines, médias privés, logs minimaux et aucun changement aux Connectors ou au multi-sites.

---

# Studio AWM 1.18.1 — maquette AVANT / APRÈS sur site existant

Studio AWM conserve le parcours stagiaire de 1.18.0 et corrige un point UX important : **Visual QA montre l état actuel AVANT modification**, tandis qu une nouvelle zone **Maquette · AVANT / APRÈS** matérialise la proposition Studio avant application.

Pour une page Elementor existante, le bouton **Améliorer automatiquement cette page** prépare un plan prudent. Studio reconstruit ensuite localement une simulation APRÈS à partir de l outline Elementor autorisé, du Site DNA, des opérations du plan et des éventuelles nouvelles sections. Cet aperçu ne déclenche aucun appel OpenAI supplémentaire et n écrit rien sur le site.

Le SEO existant, l URL, le canonical, l indexation, les formulaires, les scripts, le tracking et les widgets inconnus restent protégés. L utilisateur peut toujours ouvrir **Demande personnalisée** pour préciser une modification.

Après validation, l application conserve le snapshot historique. Visual QA peut ensuite être relancé sur le rendu public réel afin de comparer le résultat.

---

# Studio AWM 1.18.0 — UX stagiaire + mémoire SEO locale économique

Studio AWM reste le moteur multifonction **Créer · Modifier / étendre · Auditer / optimiser**, mais l entrée principale est maintenant pensée pour un stagiaire : **Service + Localisation(s) → Générer automatiquement**.

Studio dérive automatiquement le titre, l URL, le mot-clé principal et le brief. Une localisation crée une préparation complète; plusieurs localisations créent un lot et l optimisent page par page. Avant toute création, Studio cherche une page existante très similaire et préfère l optimisation à la création d un doublon. Les réglages détaillés restent accessibles dans **Création manuelle / options expertes**.

## Référentiel SEO AWM local

La version 1.18.0 embarque **250 règles SEO AWM** dans une mémoire locale structurée sur le serveur Alliance. `AWM_Studio_SEO_Rules` exécute d abord les contrôles déterministes sans appel OpenAI : structure de titre, slug, H1, métadonnées, ALT, alignement service/localisation, conflits sensibles et règles de protection.

Le moteur suit le principe **Local d abord → cache/résumé → IA seulement si nécessaire**. Le référentiel complet n est jamais recopié dans un prompt. Studio sélectionne au maximum **12 règles pertinentes** selon le contexte (création, page existante, local, média, conversion, action sensible). Le Site DNA transmis au modèle est lui aussi compacté pour éviter de renvoyer des données inutiles.

Les règles à risque élevé peuvent empêcher une dérogation automatique du mode stagiaire. URL, canonical, indexation, redirections, pages sensibles et autres actifs SEO restent sous validation humaine.

## Démarrage rapide

- **Service** : obligatoire.
- **Localisation(s)** : facultatif; plusieurs villes peuvent être séparées par virgule, point-virgule ou nouvelle ligne.
- Titre, URL, mot-clé et brief sont générés automatiquement.
- Si une page similaire existe déjà, Studio ouvre l optimisation au lieu de créer un doublon.
- Pour plusieurs villes, Studio prépare localement le lot puis utilise OpenAI séquentiellement pour rendre chaque page réellement distincte et utile.
- Les images IA ne sont pas générées avant la première validation afin d éviter des coûts inutiles.

## Visual QA et sécurité

Les fonctions 1.17.0 restent présentes : Visual QA desktop/tablette/mobile, Site DNA, corrections Elementor sûres, snapshots et rollback. Les formulaires, widgets inconnus, scripts et tracking restent protégés. Les nouvelles pages restent en brouillon avant publication.

## Compatibilité

- Core AWM 4.5.68+
- WordPress 6.0+
- PHP 8.0+
- Hub Client AWM 1.11.33+ recommandé pour les corrections visuelles sûres.

---

# Studio AWM 1.17.0 — Visual QA réel + corrections Elementor sûres

Studio AWM reste le moteur multifonction **Créer · Modifier / étendre · Auditer / optimiser**. La version 1.17.0 ajoute une première vraie boucle de **Visual QA sur le rendu public réel** des pages existantes.

Pour une page publiée non sensible, Studio prépare trois captures publiques **desktop, tablette et mobile** avec WordPress.com MShots, puis les transmet à OpenAI via la Responses API avec le Site DNA et l audit structurel. L IA retourne un rapport structuré : score global, scores par appareil, cohérence de marque, qualité de conversion, forces et problèmes observés avec preuve visuelle et recommandation.

Le Visual QA est strictement en lecture seule. Aucun cookie, session WordPress, URL d administration ou page protégée n est envoyé au service de capture. Les pages sensibles et les brouillons ne peuvent pas utiliser la capture externe automatique. Le fournisseur de capture peut être remplacé avec le filtre `awm_studio_visual_capture_url`.

Studio 1.17.0 exploite aussi les réglages de style sécurisés déjà pris en charge par Hub Client 1.11.33 : couleurs, alignements, tailles typographiques responsive, marges et paddings. Un rapport Visual QA peut donc être converti en **plan de correction Elementor** limité aux opérations jugées sûres. Le plan reste visible avant application, puis passe par le snapshot et les validations historiques de Studio. Aucun CSS libre n est accepté.

La version conserve le Site DNA visuel de 1.16.0, les modifications ciblées, le SEO/SEOPress, les snapshots, la protection des widgets inconnus/formulaires et les nouvelles pages en brouillon. Aucun changement aux Connectors ni au multi-sites.

## Service externe utilisé par Visual QA

- **WordPress.com MShots** : reçoit uniquement l URL publique de la page afin de produire une image du rendu pour les trois viewports.
- **OpenAI Responses API** : reçoit les captures, un résumé technique de la page et le Site DNA afin de produire le rapport structuré. `store=false` est utilisé par Studio.
- Les pages marquées sensibles et les pages non publiées sont exclues de ce flux automatique.

## Compatibilité

- Core AWM 4.5.68+
- WordPress 6.0+
- PHP 8.0+
- Hub Client AWM 1.11.33+ recommandé pour appliquer les corrections visuelles sûres de style; les fonctions historiques restent compatibles avec les versions minimales déjà supportées.

## Studio AWM 1.13.1 — identité AWM + pages existantes + passage SEO

Le menu WordPress affiche désormais **Studio AWM** et reprend la même base de logo Alliance et le même gabarit d icône que les autres modules.

Studio peut ouvrir une page Elementor existante depuis **Optimisation globale**, lire sa structure réelle, préparer un patch par prompt, demander une approbation humaine puis appliquer uniquement les widgets compatibles. Les widgets tiers et formulaires non reconnus sont conservés. Chaque écriture crée une sauvegarde avant modification et les sauvegardes peuvent être restaurées depuis Studio.

Le même écran ajoute un **Passage SEO IA** qui réutilise le moteur SEO Studio pour proposer titre SEOPress, méta description, mot-clé principal et métas sociales. Le canonical, l URL et l indexation restent sous contrôle humain.

# Studio AWM 1.12.0

Studio AWM est un module WordPress autonome de la Suite AWM.

## Galerie serveur autonome des maquettes

Le bouton **Voir les 3 maquettes** n'essaie plus d'ouvrir un panneau masqué dans l'écran Création. Il soumet maintenant une vraie requête WordPress vers la page autonome `admin.php?page=awm-studio-mockups`.
- Le passage SEO/SEOPress assisté reste disponible aussi pour les pages WordPress classiques; l édition de contenu par prompt demeure limitée à Elementor pour préserver les autres éditeurs.

Cette galerie est rendue entièrement côté serveur et affiche directement :

- les trois propositions A, B et C;
- un grand aperçu de la proposition sélectionnée;
- les formats Écran, Tablette et Mobile sous forme de liens ordinaires;
- l'approbation et la demande de correction par formulaires WordPress protégés par nonce;
- le client et la préparation réellement ouverts.

La galerie fonctionne sans le contrôleur JavaScript de l'écran Création. Elle contourne donc les anciens scripts, les panneaux repliés, les ancres bloquées et les conflits de route qui empêchaient l'affichage sur le vrai WordPress Alliance.

## Propriété des données

Studio est l'unique propriétaire de ses préparations, maquettes A/B/C, historiques, analyses de pages, réglages IA, profils techniques et fichiers privés. Les clés `_awm_studio_*`, l'option `awm_studio_ai_settings`, l'option `awm_studio_ui_settings` et le répertoire `wp-content/awm-studio-private` sont gérés par Studio.

Core AWM partage uniquement **la sécurité** (domaine de permissions, approbations, coffre de chiffrement, sessions et journal de sécurité) et **les connexions sécurisées** vers les connecteurs clients. Toutes les autres données et fonctions appartiennent à Studio.

Hub AWM ne charge pas le moteur, l'interface ni les données de Studio.

## Compatibilité

- Core AWM 4.5.68+
- WordPress 6.0+
- PHP 8.0+
- Hub Client AWM 1.10.0+ pour l édition des pages Elementor existantes et les snapshots; les créations historiques restent compatibles avec les versions antérieures requises.


## Correctif palette 1.19.1
La palette de production privilégie maintenant les couleurs réellement observées dans plusieurs pages Elementor. Les couleurs globales Elementor non utilisées sur le site ne doivent plus imposer une palette générique (par exemple le bleu système). La détection reste locale et ne consomme aucun token OpenAI. Une modification volontaire d un sélecteur de couleur passe la palette en mode manuel; le bouton « Reprendre les couleurs du site » revient à la détection automatique.