IWHWI

IWHWI: framework IA para gestionar sus contenidos Directus vía MCP.

Los CMS headless como Directus exponen colecciones y campos, mientras que Strapi o Contentful exponen content types y campos - pero cada uno con sus propias convenciones, su propio SDK y sus propias limitaciones. Resultado: su modelo de contenido queda prisionero de una herramienta, sus automatizaciones deben rehacerse con cada migración y la industrialización sigue siendo artesanal.

IWHWI (Interface Web Headless with Intelligence) es nuestro framework propietario en Clean Architecture que resuelve este problema. Introduce una capa de abstracción por encima del CMS: los Content Types - compuestos de Nodes (bloques estructurales) y Fields (campos de negocio) - se modelan en el dominio de negocio, independientemente del adaptador CMS utilizado. Directus, que no posee nativamente el concepto de Content Type (a diferencia de Strapi o Contentful), es el primer adaptador implementado - el caso más complejo. Los demás CMS, que ya disponen de este concepto, seguirán.

Gracias al protocolo MCP (Model Context Protocol), un asistente IA puede crear estructuras, sincronizar datos, traducir contenido y pilotar todo el ciclo de vida - todo desde una conversación. Descubra a continuación la arquitectura, los conceptos clave y las capacidades concretas de este framework.

IWHWI

Clean Architecture y abstracción CMS

IWHWI se basa en una Clean Architecture de cuatro capas: Domain (entidades, nodos, campos), Infrastructure (adaptadores CMS, fuentes de datos), Interface (servidor MCP, comandos IA) y Usecase (fachadas, servicios). El dominio de negocio está totalmente desacoplado del CMS: el adaptador Directus implementa una interfaz genérica (ICmsAdapter) que otros CMS podrán implementar.

Content Types: una abstracción por encima del CMS

Los CMS headless como Strapi o Contentful integran nativamente el concepto de Content Type. Directus, en cambio, solo maneja colecciones y campos individuales - sin capa de abstracción. Por eso IWHWI fue diseñado partiendo de Directus, el caso más bajo nivel, introduciendo los Content Types compuestos de Nodes (bloques estructurales) y Fields (campos de negocio). Por ejemplo, el Content Type « categories » se define en IWHWI con 4 Nodes (1 init, 2 lang, 1 supp) y campos adicionales. Bajo Directus, esta definición se traduce automáticamente en 3 colecciones (categories, categories_base, categories_seo) con todas las relaciones necesarias. El Supp Node no es una colección separada: añade un grupo de campos directamente en la colección principal. Esta abstracción, pensada para el caso más complejo, será aún más fácil de adaptar a los CMS que ya poseen este concepto.

Sistema de Nodes

  • Init Node: colección principal (identificadores, estado, metadatos).
  • Lang Node: colecciones vinculadas al Content Type languages (contenido traducido por idioma).
  • Flag Node: colecciones vinculadas al Content Type countries (configuraciones por país).
  • Supp Node: grupos de campos añadidos a la colección principal (imágenes, parámetros).

Migración desde CMS tradicionales

Gracias a esta capa de abstracción, IWHWI también puede servir como puente de migración entre los CMS tradicionales y los CMS headless modernos. El objetivo: recuperar el contenido estructurado de un sitio existente - WordPress, Joomla + Seblod, Joomla + K2, Joomla + FlexiContent o Drupal + CCK - mapearlo hacia los Content Types IWHWI y luego enviarlo al CMS headless destino (Directus, Strapi, Contentful...). Todos estos sistemas almacenan tipos de contenido con campos personalizados, accesibles mediante sus API REST o sus bases de datos. IWHWI será probado en estos escenarios de migración para validar este enfoque.

Campos en tres capas

Los campos se gestionan independientemente del CMS en tres niveles: Types (definiciones base de interfaces), Generics (campos de negocio reutilizables) y Specifics (campos específicos de un nodo). Cada campo es un archivo separado, importado y compuesto dentro de los nodos.

Arquitectura en capas y sistema de nodos
Arquitectura en capas y sistema de nodos
Arquitectura en capas y sistema de nodos

Arquitectura en capas y sistema de nodos

IWHWI sigue una arquitectura Domain-Driven Design en cuatro capas. La capa Domain define las entidades de negocio: campos tipados (genéricos y específicos), nodos (Init, Lang, Supp, Flag) y tipos de contenido (páginas, bloques, categorías, etc.). Cada tipo de contenido se declara de forma declarativa, con sus nodos y campos.

Este enfoque garantiza que el modelo de negocio permanezca independiente de la infraestructura técnica.

La capa Infrastructure gestiona el almacenamiento, la sincronización y los adaptadores externos. Los datos se organizan en carpetas versionadas (aXXXX), cada una con tres espacios: default (referencia fija), directus (estado actual del CMS) e ia (contenido generado por IA). Los registros (registry) mantienen la correspondencia entre identificadores locales y UUIDs de Directus.

Este sistema permite un seguimiento completo de versiones y trazabilidad de cada modificación.

El sistema de nodos estructura cada tipo de contenido de forma modular. Los Init Nodes llevan los campos no traducibles (estado, orden, fechas). Los Lang Nodes crean colecciones separadas por idioma (título, slug, descripción). Los Supp Nodes agrupan campos especializados (imágenes, medios, parámetros). Los Flag Nodes añaden indicadores opcionales.

Esta modularidad permite añadir o modificar estructuras sin impactar lo existente.

Domain-Driven Design Arquitectura en capas Entidades Modelo de negocio Infrastructure Registros Versionado Carpetas aXXXX Sincronización Init Node Lang Node Supp Node Flag Node Modularidad

Workflow source/sync y gestión de datos

El workflow source/sync es el corazón de IWHWI. Para cada tipo de contenido, el framework ofrece comandos: new (crear carpeta aXXXX vacía), source create (empujar a Directus), source update (actualizar), sync (recuperar desde Directus), source set (copiar entre espacios). Cada operación es atómica y trazable.

Este ciclo garantiza que los archivos locales y Directus permanezcan sincronizados en todo momento.

Los archivos de datos están en formato JSON, almacenados en carpetas numeradas (aXXXX) y versionados en Git. Cada archivo tiene marca temporal: los archivos default tienen timestamp fijo (1970), los archivos directus e ia llevan la fecha de creación real. El modo auto selecciona automáticamente los archivos más recientes de todos los espacios.

Esta organización permite comparar, restaurar y auditar cada versión de contenido.

Workflow source/sync y gestión de datos
Workflow source/sync y gestión de datos
Workflow source/sync y gestión de datos

La traducción automática está integrada en el workflow. IWHWI detecta los contenidos faltantes por idioma y los traduce vía Gemini o Google Cloud Translate. Las traducciones se generan en el espacio ia, se verifican y luego se empujan a Directus. El sistema soporta cinco idiomas (fr-FR, en-US, es-ES, de-DE, it-IT) y es extensible.

La traducción pasa a ser una etapa automatizada del pipeline de contenido, no una tarea manual.

Source/Sync Workflow Comandos Ciclo de vida Sincronización JSON Git Marcado temporal Versionado Auditoría Traducción automática Gemini Google Translate Multilingüe Pipeline
Integración MCP y pilotaje por IA
Integración MCP y pilotaje por IA
Integración MCP y pilotaje por IA

Integración MCP y pilotaje por IA

El protocolo MCP (Model Context Protocol) permite a un asistente IA (Claude, GPT) ejecutar acciones en sistemas externos. IWHWI implementa un servidor MCP que expone todas sus órdenes como herramientas IA: creación de estructuras Directus, gestión de fuentes, sincronización, traducción, inspección de campos y relaciones.

La IA no se limita a sugerir: ejecuta directamente las operaciones en tu CMS.

Los comandos MCP cubren todo el ciclo de vida: structure (crear/eliminar colecciones y campos), source (crear, actualizar, eliminar ítems), sync (sincronizar Directus → local), translate (traducir automáticamente), local (gestionar archivos de traducción), util (inspeccionar campos, relaciones, ítems). Cada comando está documentado y tipado.

El asistente IA dispone de control completo y seguro sobre tu instancia Directus.

IWHWI genera automáticamente los tipos TypeScript a partir de los esquemas de contenido, garantizando coherencia entre el CMS y el código frontend. El framework soporta dos entornos (alpha y production) con perfiles dedicados. El conjunto está concebido para ser extensible: añadir un nuevo tipo de contenido se hace de forma declarativa.

Resultado: un pipeline de contenido totalmente automatizado, tipado y pilotado por inteligencia artificial.

MCP Model Context Protocol Servidor MCP Herramientas IA Automatización Comandos MCP Structure Source Translate Ciclo de vida TypeScript Tipos generados Multi-entorno Extensibilidad Pipeline IA

Al elegir IWHWI para la gestión de sus contenidos, se beneficia de:

  • un framework concebido para industrializar la gestión de contenidos Directus,
  • una integración nativa con la IA mediante el protocolo MCP,
  • un flujo versionado y reproducible (source/sync) compatible con Git,
  • traducción automática multilingüe y generación de tipos TypeScript,
  • un puente de migración para recuperar contenido de CMS tradicionales (WordPress, Joomla + Seblod/K2/FlexiContent, Drupal + CCK) hacia un headless moderno.

IWHWI convierte la gestión de contenidos en un proceso automatizado, fiable y pilotado por la inteligencia artificial. Contáctenos para una demostración.