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.

IWHWI

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
Architettura a livelli e sistema di nodi
Architettura a livelli e sistema di 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.

Il sistema di nodi struttura ogni tipo di contenuto in modo modulare. Gli Init Node contengono i campi non traducibili (stato, ordinamento, date). I Lang Node creano raccolte separate per lingua (titolo, slug, descrizione). I Supp Node raggruppano campi specializzati (immagini, media, parametri). I Flag Node aggiungono indicatori opzionali.

Questa modularità permette di aggiungere o modificare strutture senza impattare l'esistente.

Domain-Driven Design Architettura a livelli Entità Modello di business Infrastructure Registry Versioning Cartelle aXXXX Sincronizzazione Init Node Lang Node Supp Node Flag Node Modularità

Workflow source/sync e gestione dati

Il workflow source/sync è il cuore di IWHWI. Per ogni tipo di contenuto il framework offre comandi: new (creare cartella aXXXX vuota), source create (push verso Directus), source update (aggiornare), sync (recuperare da Directus), source set (copiare tra spazi). Ogni operazione è atomica e tracciabile.

Questo ciclo garantisce che i file locali e Directus restino sincronizzati in permanenza.

I file di dati sono in formato JSON, memorizzati in cartelle numerate (aXXXX) e versionati in Git. Ogni file è timestampato: i file default hanno timestamp fisso (1970), i file directus e ia portano la data di creazione reale. La modalità auto seleziona automaticamente i file più recenti tra tutti gli spazi.

Questa organizzazione permette di confrontare, ripristinare e verificare ogni versione di contenuto.

Workflow source/sync e gestione dati
Workflow source/sync e gestione dati
Workflow source/sync e gestione dati

La traduzione automatica è integrata nel workflow. IWHWI rileva i contenuti mancanti per lingua e li traduce tramite Gemini o Google Cloud Translate. Le traduzioni sono generate nello spazio ia, verificate e poi pushate verso Directus. Il sistema supporta cinque lingue (fr-FR, en-US, es-ES, de-DE, it-IT) ed è estensibile.

La traduzione diventa una fase automatizzata del pipeline di contenuti, non un compito manuale.

Source/Sync Workflow Comandi Ciclo di vita Sincronizzazione JSON Git Timestamp Versioning Audit Traduzione automatica Gemini Google Translate Multilingua Pipeline
Integrazione MCP e pilotaggio tramite IA
Integrazione MCP e pilotaggio tramite IA
Integrazione MCP e pilotaggio tramite IA

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.

IWHWI genera automaticamente i tipi TypeScript dagli schemi di contenuto, garantendo coerenza tra CMS e codice frontend. Il framework supporta due ambienti (alpha e production) con profili dedicati. L'insieme è progettato per essere estensibile: aggiungere un nuovo tipo di contenuto si fa in modo dichiarativo.

Risultato: un pipeline di contenuti completamente automatizzato, tipizzato e pilotato dall'intelligenza artificiale.

MCP Model Context Protocol Server MCP Strumenti IA Automazione Comandi MCP Structure Source Translate Ciclo di vita TypeScript Tipi generati Multi-ambiente Estensibilità Pipeline IA

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.