Inventario de funciones
Este documento es el inventario de origen para hacer que las funciones del producto WebBlocks CMS sean detectables. Es un inventario de visibilidad de producto y operativa, no un contrato de ejecución. Los contratos técnicos detallados permanecen en la documentación enlazada.
El inventario ayuda a los nuevos usuarios y a los flujos de trabajo de IA/operador a entender qué capacidades del CMS existen, en qué superficies de administración, públicas o de API aparecen y qué páginas de documentación dirigidas al usuario siguen faltando. También sirve como página fuente en Markdown para una futura página de documentación del CMS enlazada a su origen.
Columnas del inventario
- Función: la capacidad del producto o la dirección documentada.
- Área: el área de producto propietaria de la función.
- Estado: implementado, dirección documentada, solo planificado o necesita documentación más clara.
- Ruta de administración: la superficie de administración en el navegador, cuando existe.
- Comportamiento público: lo que experimentan los visitantes públicos o los sitios representados.
- Soporte de API: si Internal Content API o las superficies de descubrimiento la exponen.
- Notas de origen / implementación: breve contexto de origen o de implementación.
- Documentación existente: enlaces de documentación actuales relativos al repositorio.
- Carencia de documentación / próxima página de documentación: la siguiente necesidad de documentación.
Modelo de contenido básico y Page Builder
| Función | Área | Estado | Ruta de administración | Comportamiento público | Soporte de API | Notas de origen / implementación | Documentación existente | Carencia de documentación / próxima página de documentación |
|---|---|---|---|---|---|---|---|---|
| Sitios | Contenido básico | Implementado | /webadmin/sites | Enrutamiento público, marca, idiomas (locales), variables y contenido con alcance de sitio | Detectable a través de Internal Content API | Ámbito raíz de contenido para páginas, dominios, idiomas (locales), medios y navegación | docs/multisite.md, docs/core-concepts.md | cubierto |
| Idiomas (locales) / Localización | Contenido básico | Implementado | /webadmin/locales, idiomas en la edición del sitio | Páginas y URL públicas que tienen en cuenta el idioma | Detectable a través de Internal Content API | Traducciones de página localizadas y enrutamiento por idioma | docs/localization.md, docs/multisite.md | cubierto |
| Páginas | Page Builder | Implementado | /webadmin/pages | Las páginas publicadas se representan mediante el enrutamiento público del CMS | Lectura de páginas y soporte de planes de contenido | Páginas, traducciones, slots y bloques relacionales | docs/core-concepts.md, docs/internal-content-api.md | falta guía de usuario |
| Page Layouts | Page Builder | Implementado | /webadmin/page-layouts, ajustes de Edit Page | Comportamiento del contenedor público y de los envoltorios de slot | Detectable para la planificación de contenido | Layouts gestionados con slots de layout y clases de body | docs/page-layouts.md | cubierto |
| Slots | Page Builder | Implementado | editor de slots de Edit Page | Las regiones de slot representan contenido propio de la página o compartido | Los planes de contenido apuntan a slots propios de la página | Los slots separan las regiones de la página del contenido de los bloques | docs/core-concepts.md, docs/page-layouts.md | falta una visión general de Page Builder |
| Shared Slots | Page Builder | Implementado | /webadmin/shared-slots, origen del slot en Edit Page | Los árboles de bloques de slot reutilizables con alcance de sitio se representan en las páginas | Bases de la API de Shared Slot y soporte de asignación | Referencias a contenido compartido, no plantillas copiadas | docs/core-concepts.md, docs/internal-content-api.md | falta guía de usuario |
| Bloques | Page Builder | Implementado | editor de bloques de slot de Edit Page | Los bloques representan el contenido público de la página | Descubrimiento de bloques/contenido y planes de contenido | Árboles de bloques relacionales con traducciones y ajustes | docs/core-concepts.md, docs/public-block-render-markup.md | falta una visión general de Page Builder |
| Contratos de tipo de bloque | Page Builder | Implementado | modal de contrato en /webadmin/block-types | Guía un comportamiento seguro del renderizador y del editor | Las superficies de contrato de contenido y de descubrimiento exponen los contratos de bloque | El registro de contratos define campos, ajustes y capacidades | docs/block-type-contracts.md, docs/api-discovery.md | cubierto |
| Page Builder | Page Builder | Implementado | Edit Page | Permite crear páginas públicas a partir de layouts, slots y bloques | Validación/aplicación de contenido segura en borrador | Modelo de edición básico para el contenido propio de la página | docs/core-concepts.md, docs/ai-page-building-guide.md | falta una visión general de Page Builder |
| Page Assets | Page Builder | Implementado | Edit Page -> Page Management -> Assets | El CSS y el JS con alcance de página solo se cargan en la página propietaria | No es una superficie principal de planes de contenido | Recursos de página relacionales bajo rutas públicas con alcance de sitio | docs/public-assets.md, README.md | falta guía de usuario |
| Biblioteca de medios | Recursos de contenido | Implementado | /webadmin/media | Los archivos de medios públicos pueden ser referenciados por bloques y recursos | Las referencias de medios existentes están previstas para un uso posterior por API | Gestión de medios con alcance de sitio y comprobaciones de uso | docs/core-concepts.md, docs/public-assets.md | falta guía de medios |
| Navegación | Estructura pública | Implementado | /webadmin/navigation | Los bloques y menús de navegación representan la navegación pública | Bases de la API de navegación | Menús y elementos con alcance de sitio, con grupos e iconos | docs/internal-content-api.md, README.md | falta guía de usuario |
| Composición de navbar / cabecera | Estructura pública | Implementado | selector de bloques de Page Builder | Navbar, marca, navegación y acciones de cabecera componen las cabeceras públicas | Se pueden crear cuando se detectan en los contratos de bloque | Primitivas de navbar propiedad del sistema e hijos componibles | docs/public-block-render-markup.md, README.md | falta una visión general de Page Builder |
| Vista previa de página | Editorial | Implementado | Edit Page -> Preview | Vista previa autenticada para páginas en borrador, en revisión y publicadas | Los flujos de trabajo del operador pueden informar de las URL de vista previa | Usa la representación pública con un banner de vista previa noindex | docs/editorial-workflow.md, docs/internal-content-api.md | cubierto |
| Revisiones de página | Editorial | Implementado | revisiones en Edit Page | Restaura de forma segura contenido anterior de la página para los editores | No es una superficie principal de escritura de la API | Instantáneas de revisión de página con metadatos de actor/origen | docs/revisions.md | cubierto |
| Revisiones de Shared Slot | Editorial | Implementado | revisiones de Shared Slot | Restaura contenido compartido reutilizable | No es una superficie principal de escritura de la API | Historial de revisiones y restauración de Shared Slot | docs/revisions.md | cubierto |
| Page Converter | Page Builder | Implementado | /webadmin/pages, flujos Import/Convert | Crea páginas del CMS en borrador a partir del análisis revisado de HTML estático | Usa conceptos internos de planificación de contenido, no una API pública | Análisis de HTML acotado y planes de conversión firmados | docs/page-converter-roadmap.md, README.md | falta guía de usuario |
| Importación de una sola página | Page Builder | Implementado | /webadmin/pages -> Import Page | Crea una página en borrador a partir de una carga JSON documentada | Independiente de Internal Content API | Flujo en modal de administración para la importación revisada de una sola página en JSON | README.md | falta guía de usuario |
Flujo de trabajo editorial y permisos
| Función | Área | Estado | Ruta de administración | Comportamiento público | Soporte de API | Notas de origen / implementación | Documentación existente | Carencia de documentación / próxima página de documentación |
|---|---|---|---|---|---|---|---|---|
| Flujo de trabajo Draft / In Review / Published / Archived | Editorial | Implementado | Edit Page -> Overview | Las rutas públicas solo representan páginas publicadas | La API sigue priorizando el borrador en las escrituras de contenido | Los estados de página separan redacción, revisión, publicación y archivado | docs/editorial-workflow.md | cubierto |
| Rol de editor | Permisos | Implementado | /webadmin/users, gestión de roles | Los editores pueden gestionar el contenido asignado dentro de sus permisos | La autorización afecta al acceso a la administración y a la API | Rol del CMS independiente de la condición de administrador del producto anfitrión | docs/users-and-permissions.md | cubierto |
| Rol de administrador de sitio | Permisos | Implementado | /webadmin/users, gestión de roles | Los administradores de sitio gestionan el contenido del sitio asignado | La autorización afecta al acceso a la administración y a la API | Rol administrativo con alcance de sitio | docs/users-and-permissions.md | cubierto |
| Rol de superadministrador | Permisos | Implementado | /webadmin/users, gestión de roles | Administración del CMS a nivel de instalación | Necesario para las operaciones de tokens y de sistema | El superadministrador del CMS es un rol del CMS, no la condición de administrador del anfitrión | docs/users-and-permissions.md, ARCHITECTURE_DECISIONS.md | cubierto |
| Acceso a sitios asignados | Permisos | Implementado | gestión de usuarios | Restringe el trabajo de administración a los sitios asignados | Se aplica a la autorización de la API | Las pertenencias a sitios limitan el acceso al CMS | docs/users-and-permissions.md, docs/multisite.md | cubierto |
| Transiciones del flujo de trabajo | Editorial | Implementado | Edit Page -> Overview | Controla cuándo las páginas pueden hacerse públicas o dejar de estar publicadas | El flujo de publicación sigue siendo independiente de los planes de contenido normales | Los permisos de transición protegen los cambios de estado editorial | docs/editorial-workflow.md | cubierto |
| Permisos de publicación | Permisos | Implementado | permisos de rol/usuario | Determina quién puede publicar páginas públicas | La capacidad de publicación por API es avanzada e independiente | La publicación no es intencionadamente el valor predeterminado para las escrituras de IA/operador | docs/editorial-workflow.md, docs/internal-content-api.md | falta un ejemplo de IA/operador |
| Permisos de archivado | Permisos | Implementado | permisos de rol/usuario | Controla la retirada de la publicación pública | No es un comportamiento normal de los planes de contenido | El archivado es flujo de trabajo editorial, no una eliminación destructiva | docs/editorial-workflow.md | cubierto |
| Permisos de restauración de revisiones | Permisos | Implementado | pantallas de revisiones de página y de Shared Slot | El contenido restaurado afecta a la representación pública futura tras la publicación | No es un comportamiento normal de los planes de contenido | Los flujos de restauración requieren autorización del CMS | docs/revisions.md | cubierto |
| Página de perfil del CMS | UX de administración | Implementado | /webadmin/profile | Sin comportamiento público directo | No orientado a la API | Los administradores con sesión iniciada gestionan su propio perfil | README.md | falta guía de usuario |
| Usuarios a nivel de instalación | Permisos | Implementado | /webadmin/users | Sin comportamiento público directo | La autorización afecta a los tokens de API y al acceso | La gestión de usuarios del CMS asocia roles del CMS a los usuarios del anfitrión | docs/users-and-permissions.md | cubierto |
Funciones del sitio público
| Función | Área | Estado | Ruta de administración | Comportamiento público | Soporte de API | Notas de origen / implementación | Documentación existente | Carencia de documentación / próxima página de documentación |
|---|---|---|---|---|---|---|---|---|
| Renderizado de páginas públicas | Sitio público | Implementado | Page Builder y ajustes públicos | Renderiza páginas publicadas del CMS a partir de layouts, slots y bloques | Los planes de contenido pueden crear páginas renderizables en borrador | El presentador público resuelve sitios, páginas, slots, Shared Slots y bloques | docs/core-concepts.md, docs/public-block-render-markup.md | necesita una visión general del Page Builder |
| Búsqueda pública | Sitio público | Implementado | Maintenance -> Search Rebuild, ajustes de búsqueda pública | Resultados de búsqueda pública acotados por sitio/idioma | No es una API de entrega | Índice de búsqueda respaldado por base de datos | docs/search.md | cubierto |
| Modal de búsqueda | Sitio público | Implementado | Bloque Header Actions y assets públicos | Modal de búsqueda activado desde la cabecera | No orientado a API | Usa el runtime del modal de búsqueda público propiedad del CMS | docs/search.md, README.md | cubierto |
| Bloque Search Form | Bloques públicos | Implementado | Selector de bloques del Page Builder | Renderiza el formulario de búsqueda público | Se puede crear cuando se descubre en los contratos de bloque | Punto de entrada de búsqueda basado en bloques | docs/search.md, docs/public-block-render-markup.md | cubierto |
| Visitor Reports | Analítica | Implementado | /webadmin/visitor-reports | Informes de tráfico público respetuosos con la privacidad | No es una API pública de entrega | Agregados de eventos de visitantes e informes | README.md | necesita guía de usuario |
| Marca del sitio / valores SEO por defecto | Sitio público | Implementado | Edit Site -> Branding, SEO Defaults | Metadatos públicos de reserva y assets de marca | Las superficies de descubrimiento de sitios exponen el contexto | Nombre visible, lema, valores SEO por defecto, favicon e imagen social propiedad del sitio | docs/core-concepts.md, README.md | necesita guía de usuario |
| Overrides de SEO a nivel de página | Sitio público | Implementado | Ajustes de traducción de página | Overrides de metadatos de página según el idioma | Las superficies de lectura de páginas incluyen el contexto de metadatos de página | Los valores SEO viven en las traducciones de página | README.md, docs/localization.md | necesita guía de usuario |
| Favicon / imagen social | Sitio público | Implementado | Edit Site -> Branding | Favicon público y reservas de vista previa social | No es una superficie principal de escritura por API | Soporte de medios de marca a nivel de sitio | README.md | necesita guía de usuario |
| Variables de sitio | Sitio público | Implementado | Edit Site -> Variables | Sustituye los tokens {{ site.variable_key }} en el renderizado público compatible | No es una superficie principal de escritura por API | Tokens de texto relacionales y reutilizables acotados al sitio | README.md | necesita guía de usuario |
| Enrutamiento multisitio | Sitio público | Implementado | /webadmin/sites, gestión de dominios | Enruta las solicitudes al sitio/dominio coincidente | El descubrimiento de sitios admite el contexto del operador | Dominios principal y alias por sitio | docs/multisite.md, docs/coexistence.md | cubierto |
| URL públicas localizadas | Sitio público | Implementado | Locales y traducciones de página | Rutas de página y reservas según el idioma | El descubrimiento de idiomas admite el contexto del operador | Traducciones de página y enrutamiento por idioma | docs/localization.md | cubierto |
Formularios y mensajes
Contact Form y Contact Messages son funciones de primer nivel de WebBlocks CMS. La guía orientada al usuario sobre configuración, envío, gestión del spam, reserva de correo electrónico y resolución de problemas vive ahora en docs/contact-forms-and-messages.md.
| Función | Área | Estado | Ruta de administración | Comportamiento público | Soporte de API | Notas de origen / implementación | Documentación existente | Carencia de documentación / próxima página de documentación |
|---|---|---|---|---|---|---|---|---|
| Bloque Contact Form | Formularios | Implementado | Selector de bloques del Page Builder | Renderiza un formulario público y almacena los envíos | Se puede crear mediante planes de contenido cuando se descubre contact_form | Bloque de primer nivel con soporte de destinatario de reserva | docs/contact-forms-and-messages.md, docs/block-type-contracts.md, docs/public-block-render-markup.md | cubierto |
| Pantalla de administración Contact Messages | Formularios | Implementado | /webadmin/contact-messages | Sin listado público; el personal administrador revisa los envíos | No es una API pública de entrega | La tabla de administración incluye el estado de entrega y de spam | docs/contact-forms-and-messages.md, README.md | cubierto |
| Almacenamiento de envíos del formulario de contacto | Formularios | Implementado | Contact Messages | Almacena los envíos públicos reales para su revisión | No orientado a API | Los envíos se almacenan antes de intentar la notificación por correo electrónico | docs/contact-forms-and-messages.md | cubierto |
| Descarte por comprobación antispam | Formularios | Implementado | Renderizador de Contact Form y gestión de envíos | Los envíos con el campo de comprobación generado relleno reciben la redirección de éxito habitual y se descartan | No orientado a API | Envoltorio oculto .wb-form-check propiedad del CMS, generado por el renderizador nativo | docs/contact-forms-and-messages.md | cubierto |
| Puntuación de spam / cuarentena | Formularios | Implementado | Contact Messages | Los envíos sospechosos pueden ponerse en cuarentena para su revisión por administración | No orientado a API | Señales de spam conservadoras para enlaces, patrones comerciales e IP repetidas | docs/contact-forms-and-messages.md | cubierto |
| Cadena de reserva de notificación por correo | Formularios | Implementado | Bloque Contact Form, Edit Site -> Contact, correo del entorno | Intenta resolver el destinatario a partir del bloque, del sitio y de la reserva de correo segura | No orientado a API | Los intentos de entrega se producen tras el almacenamiento duradero; la guía de configuración cubre .env, los destinatarios del sitio y el vaciado de caché | docs/contact-forms-and-messages.md, docs/installation.md, docs/getting-started.md | cubierto |
| Comando de diagnóstico del correo de contacto | Operaciones | Implementado | Diagnóstico del lado del operador | Sin comportamiento público | No orientado a API | Diagnóstico de la configuración de correo sin exponer secretos y comprobaciones de envío SMTP controladas | docs/contact-forms-and-messages.md, docs/operations.md, README.md | cubierto |
| Estado de entrega / detalles del fallo | Formularios | Implementado | Contact Messages | Sin divulgación pública de los fallos | No orientado a API | Los mensajes guardados incluyen el estado de notificación visible para administración | docs/contact-forms-and-messages.md | cubierto |
API interna de contenido y operaciones de IA
La API interna de contenido está pensada para herramientas de IA/operador de confianza. No es una API pública de entrega, ni una integración con un proveedor de IA, ni un sustituto de la exportación/importación. Las herramientas de IA/operador deben usar el descubrimiento en vivo y no deben adivinar los handles de bloque.
Documentación adicional recomendada:
docs/ai-page-building-overview.md- docs/contact-forms-and-messages.md ya existe.
- docs/markdown-docs-to-cms-sync.md ya existe desde antes.
| Funcionalidad | Área | Estado | Ruta en la administración | Comportamiento público | Soporte de API | Notas de código / implementación | Documentación existente | Carencia de documentación / próxima página |
|---|---|---|---|---|---|---|---|---|
| API Tokens | Operaciones de IA | Implementado | /webadmin/system/api-tokens | Sin comportamiento público | Autenticación mediante token Bearer | Los tokens se almacenan con hash y se muestran una sola vez | docs/internal-content-api.md, docs/api-discovery.md | cubierto |
| Capacidades de los tokens | Operaciones de IA | Implementado | Creación/edición de tokens de API | Sin comportamiento público | Autorización de API acotada por capacidades | Las capacidades de publicación y eliminación son opciones avanzadas que hay que activar | docs/internal-content-api.md | necesita un ejemplo para IA/operador |
| Endpoint de descubrimiento de la API | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Raíz de descubrimiento para herramientas de confianza | Parte de la URL base de la API y del token | docs/api-discovery.md | cubierto |
| Endpoint de OpenAPI | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Contrato de API legible por máquina | Enlazado desde el descubrimiento | docs/api-discovery.md, docs/internal-content-api.md | cubierto |
| Endpoint de la guía para IA | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Enlace a la guía desde el descubrimiento | Ayuda a los operadores a construir de forma segura | docs/ai-page-building-guide.md | necesita una visión general |
| Endpoint del contrato de contenido | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Descubrimiento del contrato de bloques y contenido | Necesario antes de planificar el contenido | docs/api-discovery.md, docs/block-type-contracts.md | cubierto |
| Endpoint de ejemplos | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Descubrimiento de planes de contenido de ejemplo | Enlazado desde el descubrimiento | docs/api-discovery.md | necesita un ejemplo para IA/operador |
| API de lectura de páginas | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Inspección de páginas de solo lectura | Endpoint de estilo recurso dentro de la API interna | docs/internal-content-api.md | cubierto |
| Descubrimiento de bloques y contenido | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Inspección del contrato de bloques y del contenido | Evita adivinar los identificadores de bloque | docs/block-type-contracts.md, docs/api-discovery.md | cubierto |
| Validación de contenido | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Valida los planes de contenido antes de aplicarlos | Paso de seguridad obligatorio en los flujos de trabajo del operador | docs/internal-content-api.md, docs/ai-page-building-guide.md | cubierto |
| Aplicación de contenido | Operaciones de IA | Implementado | Sin ruta en la administración web | Crea contenido del CMS en borrador, no público por defecto | Aplica los planes de contenido aprobados | Prioriza el borrador y no es destructivo por defecto | docs/internal-content-api.md, docs/ai-page-building-guide.md | cubierto |
| Creación de páginas segura en borrador | Operaciones de IA | Implementado | La página resultante aparece en Pages | Las páginas en borrador se pueden previsualizar antes de publicarlas | Compatible mediante planes de contenido | Crea páginas, slots, traducciones y árboles de bloques | docs/internal-content-api.md | necesita un ejemplo para IA/operador |
| replace_existing_draft_page / modelo de sustitución seguro en borrador | Operaciones de IA | Implementado | Página en borrador existente en Pages | Sustituye únicamente los slots gestionados que pertenecen a la página en borrador | Modo validate/apply soportado | Usa salvaguardas basadas en la ruta esperada o en la fecha de actualización | docs/internal-content-api.md, docs/markdown-docs-to-cms-sync.md | necesita un ejemplo para IA/operador |
| Bases de la API de navegación | Operaciones de IA | Implementado | Recursos de navegación en la administración | El contenido planificado puede afectar a la navegación pública tras su aprobación | Bases de los menús de navegación y sus elementos | Bases seguras sin comportamientos destructivos amplios | docs/internal-content-api.md | necesita un ejemplo para IA/operador |
| Bases de la API de Shared Slots | Operaciones de IA | Implementado | Administración de Shared Slots | El contenido compartido puede renderizarse en varias páginas tras su aprobación | Bases de los Shared Slot y de sus asignaciones | Soporte de asignación compatible dentro del mismo sitio | docs/internal-content-api.md | necesita un ejemplo para IA/operador |
| Errores solo en JSON | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Los errores de la API devuelven JSON | Separa la API del operador de las respuestas de la administración web | docs/internal-content-api.md | cubierto |
| Escrituras de la API con Bearer sin CSRF | Operaciones de IA | Implementado | Sin ruta en la administración web | Sin comportamiento público | Las escrituras con Bearer no dependen del CSRF del navegador | Contrato de token de confianza para las herramientas del operador | docs/internal-content-api.md | cubierto |
| Comunicación de la URL de vista previa | Operaciones de IA | Implementado | Vista previa en Edit Page | Los operadores pueden revisar las vistas previas de los borradores | Las respuestas de aplicación pueden informar del contexto de vista previa | La vista previa sigue estando autenticada y es segura para los borradores | docs/ai-page-building-guide.md, docs/editorial-workflow.md | cubierto |
| Flujo de creación de páginas con IA que prioriza el borrador | Operaciones de IA | Implementado | Pantallas de Pages y de vista previa | Las páginas creadas por IA son borradores hasta su aprobación | Flujo de descubrimiento, validación y aplicación | Requiere descubrimiento en vivo y contratos exactos | docs/ai-page-building-guide.md | necesita docs/ai-page-building-overview.md |
| Runbook de sincronización de la documentación Markdown con el CMS | Documentación | Dirección documentada | Sin ruta de administración en tiempo de ejecución | Las futuras páginas de documentación vinculadas al código fuente podrán publicar contenido derivado de Markdown | Utilizaría los flujos de descubrimiento, validación y aplicación aprobada y segura en borrador | La fuente Markdown sigue siendo la autoritativa y los archivos modificados de docs/ guían la planificación de la IA y del operador | docs/markdown-docs-to-cms-sync.md | cubierto |
Operaciones
| Funcionalidad | Área | Estado | Ruta en la administración | Comportamiento público | Soporte de API | Notas de código / implementación | Documentación existente | Carencia de documentación / próxima página |
|---|---|---|---|---|---|---|---|---|
| System Updates | Operaciones | Implementado | /webadmin/system/updates | Actualiza el código instalado del CMS y los recursos del paquete | No es una API de entrega pública | Flujo de actualización nativo del paquete | docs/updates.md, docs/operations.md | necesita una guía para el operador |
| Actualizaciones del paquete de versión | Operaciones | Implementado | System Updates | El comportamiento del sitio público cambia tras una actualización aprobada | No orientado a API | Consume los artefactos de versión del paquete | docs/updates.md, docs/package-architecture.md | necesita una guía para el operador |
| Raíz de actualización nativa del paquete | Operaciones | Implementado | System Updates | Sin comportamiento público directo | No orientado a API | La raíz canónica del paquete es vendor/fklavyenet/webblocks-cms | docs/package-architecture.md, ARCHITECTURE_DECISIONS.md | cubierto |
| Migraciones de actualización | Operaciones | Implementado | System Updates | Mantiene alineado el esquema necesario en tiempo de ejecución | No orientado a API | Las migraciones de actualización del paquete dan soporte a las instalaciones existentes | docs/updates.md, ARCHITECTURE_DECISIONS.md | cubierto |
| Preparación para la actualización | Operaciones | Implementado | System Updates | Sin comportamiento público | No orientado a API | Comprobaciones de preparación y de detalles de la versión antes de actualizar | docs/updates.md | necesita una guía para el operador |
| Última ejecución de actualización | Operaciones | Implementado | System Updates | Sin comportamiento público | No orientado a API | Informe de la última ejecución para los operadores | docs/updates.md, README.md | necesita una guía para el operador |
| Informe de soporte | Operaciones | Implementado | System Updates | Sin comportamiento público | No orientado a API | Diagnósticos de soporte descargables para los problemas de actualización | docs/updates.md | necesita una guía para el operador |
| Backups | Operaciones | Implementado | /webadmin/backups | Protege el contenido del sitio y el estado de la instalación | No orientado a API | Registros de copia de seguridad y disco de almacenamiento | docs/operations.md | cubierto |
| Restore | Operaciones | Implementado | /webadmin/backups, flujo de restauración | El contenido restaurado puede afectar al sitio público | No orientado a API | Flujo controlado de restauración de copias de seguridad | docs/operations.md | cubierto |
| Site Export / Import | Operaciones | Implementado | /webadmin/site-transfers/exports, /webadmin/site-transfers/imports | Traslada el contenido del sitio entre instalaciones | Independiente de la Internal Content API | Empaqueta contenido, medios, navegación y datos relacionados del sitio | docs/operations.md, README.md | necesita una guía de usuario |
| Clonación / promoción de sitios | Operaciones | Implementado / documentado | Flujos de trabajo de sitios y de promoción | El contenido de un sitio clonado o promocionado puede volverse público | No es una API de entrega pública | Conceptos de transferencia y promoción de sitios basados en el paquete | docs/operations.md, README.md | necesita una guía para el operador |
| Search Rebuild | Operaciones | Implementado | Maintenance -> Search Rebuild | Actualiza el índice de búsqueda público | No orientado a API | Reconstruye la búsqueda pública basada en base de datos | docs/search.md, docs/operations.md | cubierto |
| Comandos de reparación de catálogos | Operaciones | Implementado | Mantenimiento del lado del operador | Repara los catálogos del CMS que usan la administración y el renderizado | No orientado a API | Comandos de mantenimiento para la consistencia de los catálogos | docs/operations.md, README.md | necesita una guía para el operador |
| Asistente de instalación | Instalación | Implementado | Pantallas de instalación del primer arranque | Crea el estado inicial de instalación del CMS | No orientado a API | Configuración inicial guiada desde el navegador | docs/installation.md | cubierto |
| Instalación para consumidores del paquete | Instalación | Implementado | Flujo de instalación del paquete | Habilita las rutas públicas y de administración del CMS en una aplicación anfitriona | No orientado a API | El instalador del paquete prepara el esquema, los recursos y el primer usuario | docs/installation.md, README.md | cubierto |
| Desarrollo local nativo | Desarrollo | Documentación implementada | Solo desarrollo local | Entorno de desarrollo local con dominios .test locales | No orientado a API | Guía de desarrollo local solo con HTTPS | docs/native-local-development.md | cubierto |
| Estrategia de pruebas | Desarrollo | Documentación implementada | Flujo de trabajo de desarrollo | Sin comportamiento público directo | No orientado a API | Scripts de prueba basados en riesgos y guía de validación | docs/testing-strategy.md | cubierto |
Sistema de plugins
| Función | Área | Estado | Ruta de administración | Comportamiento público | Soporte de API | Fuente / notas de implementación | Documentación existente | Laguna de documentación / próxima página de documentación |
|---|---|---|---|---|---|---|---|---|
| Arquitectura de host de plugins | Plugins | Bases implementadas | /webadmin/system/plugins | Los plugins pueden añadir comportamiento público cuando están activados | No es una API pública genérica | El núcleo del CMS es un host de plugins | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | cubierto |
| Instalación manual de plugin por ZIP | Plugins | Implementado | System -> Plugins -> Upload | Los plugins instalados están desactivados por defecto | No orientado a API | Ruta de instalación gestionada por el almacenamiento y validación del paquete | docs/plugin-system.md | necesita una guía del ciclo de vida de los plugins |
| Ciclo de vida del plugin desactivado por defecto | Plugins | Implementado | System -> Plugins | Los plugins desactivados son inertes | No orientado a API | Los paquetes instalados deben activarse explícitamente | docs/plugin-system.md | cubierto |
| Activar / desactivar | Plugins | Implementado | System -> Plugins | Activa o elimina el comportamiento activo del plugin | No orientado a API | Las comprobaciones de compatibilidad y configuración protegen la activación | docs/plugin-system.md | necesita una guía del ciclo de vida de los plugins |
| Configuración / migraciones del plugin | Plugins | Bases implementadas | Pantallas de detalle/configuración del plugin | El comportamiento del plugin puede requerir configuración antes de que funcionen las rutas | No orientado a API | Las tablas propias del plugin que faltan muestran indicaciones de configuración controladas | docs/plugin-system.md | necesita una guía del ciclo de vida de los plugins |
| Permisos del plugin | Plugins | Implementado | Gestión de permisos de roles/usuarios | Controla el acceso a las rutas de administración del plugin | No orientado a API | Los permisos llevan el handle como prefijo | docs/plugin-system.md | cubierto |
| Rutas de administración del plugin | Plugins | Implementado | /webadmin/plugins/{plugin-handle} | Comportamiento de administración del plugin en el navegador cuando está activado | No orientado a API | Las rutas solo existen si está activado y están protegidas por namespace | docs/plugin-system.md | cubierto |
| Estado/salud del plugin | Plugins | Implementado | System -> Plugins | Sin comportamiento público directo | No orientado a API | Comprobaciones de salud y estado de compatibilidad | docs/plugin-system.md | cubierto |
| Bloques/paquetes de bloques propiedad del plugin | Plugins | Bases implementadas | Selector de bloques cuando el plugin está activo | Los bloques del plugin pueden renderizar contenido público | Detectables cuando los contratos de bloque los exponen | Los handles de los bloques del plugin pertenecen al plugin | docs/plugin-system.md, docs/block-type-contracts.md | necesita una guía del ciclo de vida de los plugins |
| Hooks de recursos públicos | Plugins | Bases implementadas | Registro del plugin | Los plugins pueden aportar recursos públicos seguros | No orientado a API | Hooks seguros de aportación en head y al final de body | docs/plugin-system.md | cubierto |
| Navegador de Plugin Catalog | Plugins | Implementado | System -> Plugins -> Browse Plugin Catalog | Sin comportamiento directo en el sitio público | Lee metadatos del catálogo; no es una API pública de entrega | Exploración de metadatos del catálogo público | docs/plugin-system.md, docs/plugin-ecosystem-and-catalog.md | necesita una guía del ciclo de vida de los plugins |
| Instalación desde el catálogo | Plugins | Implementado | Detalle de Plugin Catalog | El plugin instalado permanece desactivado hasta que se activa | No orientado a API | Instalación de artefactos del catálogo verificada por suma de comprobación | docs/plugin-system.md | necesita una guía del ciclo de vida de los plugins |
| Actualizaciones de plugins respaldadas por el catálogo | Plugins | Implementado | System -> Plugins | Comportamiento del plugin actualizado tras una actualización aprobada | No orientado a API | Reutiliza la ruta de validación de suma de comprobación y de paquete | docs/plugin-system.md | necesita una guía del ciclo de vida de los plugins |
| Desinstalación manual | Plugins | Implementado | System -> Plugins | Elimina el paquete de plugin subido y desactivado | No orientado a API | Conserva las tablas de base de datos propias del plugin | docs/plugin-system.md | cubierto |
| WebBlocks UI Manager como plugin de operador, no como función incluida en el núcleo del CMS | Plugins | Arquitectura implementada | Se instala solo cuando se sube/activa manualmente | Sin comportamiento habitual en el runtime del CMS | No orientado a API | El plugin de operador propio permanece fuera del núcleo incluido | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | cubierto |
Preparación de la documentación y del sitio de producto
La documentación actual es técnicamente rica, pero la visibilidad de las funciones es incompleta. Este inventario debería ayudar a decidir qué páginas de documentación de cara al usuario faltan y qué páginas de origen pueden publicarse más adelante como páginas de documentación enlazadas a la fuente en un sitio de documentación de destino.
Páginas de documentación prioritarias:
- Visión general de la creación de páginas con IA
- Visión general del Page Builder
- Inventario de funciones
- Resolución de problemas de Forms / Messages
- Guía del ciclo de vida de los plugins
- Guía del operador de System Updates
El contenido de marketing de webblocksui.com debería mantenerse separado de la documentación técnica. Las páginas de marketing pueden resumir el valor del producto, mientras que la documentación en Markdown debería seguir siendo la fuente para la orientación técnica y de operación.