IWHWI
IWHWI: framework IA per gestire i vostri contenuti Directus via MCP.
I CMS headless come Directus espongono collezioni e campi, mentre Strapi o Contentful espongono content type e campi - ma ciascuno con le proprie convenzioni, il proprio SDK e i propri limiti. Risultato: il vostro modello di contenuto è prigioniero di un unico strumento, le vostre automazioni devono essere rifatte ad ogni migrazione e l'industrializzazione resta artigianale.
IWHWI (Interface Web Headless with Intelligence) è il nostro framework proprietario in Clean Architecture che risolve questo problema. Introduce un livello di astrazione sopra il CMS: i Content Types - composti da Nodes (blocchi strutturali) e Fields (campi di business) - sono modellati nel dominio di business, indipendentemente dall'adattatore CMS utilizzato. Directus, che non possiede nativamente il concetto di Content Type (a differenza di Strapi o Contentful), è il primo adattatore implementato - il caso più complesso. Gli altri CMS, che già dispongono di questo concetto, seguiranno.
Grazie al protocollo MCP (Model Context Protocol), un assistente IA può creare strutture, sincronizzare dati, tradurre contenuti e pilotare l'intero ciclo di vita - il tutto da una conversazione. Scoprite qui sotto l'architettura, i concetti chiave e le capacità concrete di questo framework.
Clean Architecture e astrazione CMS
IWHWI si basa su una Clean Architecture a quattro livelli: Domain (entità, nodi, campi), Infrastructure (adattatori CMS, sorgenti dati), Interface (server MCP, comandi IA) e Usecase (facade, servizi). Il dominio di business è totalmente disaccoppiato dal CMS: l'adattatore Directus implementa un'interfaccia generica (ICmsAdapter) che altri CMS potranno implementare.
Content Types: un'astrazione sopra il CMS
I CMS headless come Strapi o Contentful integrano nativamente il concetto di Content Type. Directus, invece, gestisce solo collezioni e campi individuali - senza livello di astrazione. Per questo IWHWI è stato progettato partendo da Directus, il caso più basso livello, introducendo i Content Types composti da Nodes (blocchi strutturali) e Fields (campi di business). Ad esempio, il Content Type « categories » si definisce in IWHWI con 4 Nodes (1 init, 2 lang, 1 supp) e campi aggiuntivi. Sotto Directus, questa definizione si traduce automaticamente in 3 collezioni (categories, categories_base, categories_seo) con tutte le relazioni necessarie. Il Supp Node non è una collezione separata: aggiunge un gruppo di campi direttamente nella collezione principale. Questa astrazione, pensata per il caso più complesso, sarà ancora più semplice da adattare ai CMS che già possiedono questo concetto.
Sistema di Nodes
- Init Node: collezione principale (identificatori, stato, metadati).
- Lang Node: collezioni legate al Content Type languages (contenuto tradotto per lingua).
- Flag Node: collezioni legate al Content Type countries (configurazioni per paese).
- Supp Node: gruppi di campi aggiunti alla collezione principale (immagini, parametri).
Migrazione dai CMS tradizionali
Grazie a questo livello di astrazione, IWHWI può anche fungere da ponte di migrazione tra i CMS tradizionali e i CMS headless moderni. L'obiettivo: recuperare il contenuto strutturato di un sito esistente - WordPress, Joomla + Seblod, Joomla + K2, Joomla + FlexiContent o Drupal + CCK - mapparlo verso i Content Types IWHWI e poi inviarlo al CMS headless di destinazione (Directus, Strapi, Contentful...). Tutti questi sistemi memorizzano tipi di contenuto con campi personalizzati, accessibili tramite le loro API REST o i loro database. IWHWI sarà testato su questi scenari di migrazione per validare questo approccio.
Campi in tre livelli
I campi sono gestiti indipendentemente dal CMS su tre livelli: Types (definizioni base delle interfacce), Generics (campi di business riutilizzabili) e Specifics (campi specifici di un nodo). Ogni campo è un file separato, importato e composto all'interno dei nodi.
Architettura a livelli e sistema di nodi
IWHWI segue un'architettura Domain-Driven Design a quattro livelli. Il livello Domain definisce le entità di business: campi tipizzati (generici e specifici), nodi (Init, Lang, Supp, Flag) e tipi di contenuto (pagine, blocchi, categorie, ecc.). Ogni tipo di contenuto è dichiarato in modo dichiarativo, con i suoi nodi e campi.
Questo approccio garantisce che il modello di business resti indipendente dall'infrastruttura tecnica.
Il livello Infrastructure gestisce storage, sincronizzazione e adattatori esterni. I dati sono organizzati in cartelle versionate (aXXXX), ciascuna con tre spazi: default (riferimento congelato), directus (stato attuale del CMS) e ia (contenuto generato da IA). I registri (registry) mantengono la corrispondenza tra ID locali e UUID Directus.
Questo sistema permette un tracciamento completo delle versioni e tracciabilità di ogni modifica.
Integrazione MCP e pilotaggio tramite IA
Il protocollo MCP (Model Context Protocol) permette a un assistente IA (Claude, GPT) di eseguire azioni su sistemi esterni. IWHWI implementa un server MCP che espone tutti i suoi comandi come strumenti IA: creazione strutture Directus, gestione sorgenti, sincronizzazione, traduzione, ispezione campi e relazioni.
L'IA non si limita a suggerire: esegue direttamente le operazioni sul vostro CMS.
I comandi MCP coprono l'intero ciclo di vita: structure (creare/rimuovere collezioni e campi), source (creare, aggiornare, eliminare item), sync (sincronizzare Directus → locale), translate (tradurre automaticamente), local (gestire file di traduzione), util (ispezionare campi, relazioni, item). Ogni comando è documentato e tipizzato.
L'assistente IA dispone di controllo completo e sicuro sulla vostra istanza Directus.
Scegliendo IWHWI per la gestione dei vostri contenuti, beneficiate di:
- un framework pensato per industrializzare la gestione contenuti Directus,
- integrazione nativa con l'IA tramite il protocollo MCP,
- un workflow versionato e riproducibile (source/sync) compatibile con Git,
- traduzione automatica multilingua e generazione tipi TypeScript,
- un ponte di migrazione per recuperare contenuti da CMS tradizionali (WordPress, Joomla + Seblod/K2/FlexiContent, Drupal + CCK) verso un headless moderno.
IWHWI trasforma la gestione contenuti in un processo automatizzato, affidabile e pilotato dall'intelligenza artificiale. Contattateci per una demo.