Documentation technique

Guide développeur

Ce document décrit l’architecture actuelle du module Blue Editoria : Content workflow. Il tient compte du workflow simplifié : Tableau de bord, Mes contenus, Tableur, Studio IA, Maillage site, Paramètres, Mon compte et Aide.

Architecture du plugin

`includes/`

Logique métier : réglages, service IA, analyse site, génération, maillage, tableur, templates IA, cache, logs et helpers.

`admin/`

Classes d’écrans admin. Les écrans avancés existent encore pour maintenance, mais l’UX principale reste volontairement simplifiée.

`templates/`

Vues PHP du back-office : tableau de bord, Mes contenus, tableur, Studio IA, Maillage site, Paramètres, Mon compte, Aide.

`assets/`

CSS et JavaScript admin. Le tableur possède son script dédié afin de ne pas charger toute sa logique partout.

Classes principales à connaître

AISCB_Plugin : boot principal, wiring des services, topbar module, caches et helpers globaux.
AISCB_Admin_Menu : menus, pages admin, handlers POST, endpoints AJAX, tableur et notifications.
AISCB_Settings : options, CPT actifs, champs autorisés, règles de maillage, design IA.
AISCB_License_Manager : gestion historique de la connexion au service IA, credits, liens compte/boutique et synchronisation serveur central.
AISCB_Site_Analysis : scan des contenus, scores, métadonnées, liens et état d’analyse.
AISCB_Internal_Linking : suggestions, inventaire de liens, liens entrants, protections bouton/CTA, nettoyage et actions groupées.
AISCB_Content_Generator et AISCB_Generation_Queue : génération de contenus et file de traitement.
AISCB_CPT_Page_Template_Service, AISCB_HTML_CSS_Generator, AISCB_Layout_Engine : socle du Studio IA et rendu HTML/CSS.
AISCB_Performance_Cache : cache interne et invalidation fine.
AISCB_Debug_Logger : logs techniques et journaux de debug.

Important : ne pas réintroduire l’ancien workflow visible en plusieurs étapes techniques. Les pages avancées masquées servent à maintenir le moteur, pas à guider l’utilisateur final.

Données et stockage

Options WordPress pour les réglages, CPT actifs, champs autorisés, caches de profil et états de scan.
Post meta pour suggestions de maillage, inventaires, données de campagne et états liés au contenu.
Tables internes pour campagnes, sujets, logs et historiques lorsque le repository du module les gère.
Transients et cache objet pour éviter les scans CPT/champs à chaque chargement.

Actions AJAX / admin importantes

Tableur

aiscb_get_table_rows
aiscb_contents_sheet_save
aiscb_contents_sheet_update_links
aiscb_contents_sheet_refresh_linking

Notifications

aiscb_notifications_feed
aiscb_notifications_mark_read
aiscb_notifications_quick_action

Mes contenus

admin_post_aiscb_run_analysis
admin_post_aiscb_bulk_contents_link_action
admin_post_aiscb_content_link_action

Studio IA

Le Studio IA doit rester une interface simple. Les services de propositions, construction, rendu, audit et activation restent en arrière-plan.

Sécurité et garde-fous

Chaque action admin doit vérifier manage_options ou la capacité adaptée.
Chaque action POST/AJAX doit utiliser un nonce WordPress.
Les entrées sont nettoyées avec sanitize_text_field, sanitize_key, absint, esc_url_raw et wp_unslash.
Les sorties sont échappées avec esc_html, esc_attr, esc_url ou wp_kses_post.
Le maillage ne doit pas modifier automatiquement les boutons, CTA, menus, footers ou liens Elementor sensibles.
Le HTML/CSS généré par IA doit rester scoped, sans script et sans sélecteurs globaux dangereux.

Hooks et filtres prévus

aiscb_detected_fields : ajuster la liste des champs détectés.
aiscb_available_components : enrichir la bibliothèque de composants Studio IA.
aiscb_generation_payload : modifier le payload envoyé au moteur IA.
aiscb_generated_html et aiscb_generated_css : filtrer le rendu généré.
aiscb_activation_rules : ajuster les règles d’activation.
aiscb_relink_source_content : fournir un HTML source alternatif au moteur de maillage.