ceibacore / ceiba-cms
Ceiba CMS - Framework-agnostic PHP 8.x CMS module
Requires
- php: ^8.1
- ceibacore/ceiba-db: ^1.0
Requires (Dev)
- phpunit/phpunit: ^10.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Lemur CMS es un motor de gestión de contenidos (CMS) headless y desacoplado, diseñado bajo los principios de Clean Architecture y Hexagonal Architecture. Es compatible con cualquier aplicación host (como Laravel) y está estructurado en módulos para la gestión de páginas, menús de navegación, elementos multimedia, autenticación y SEO.
Características Principales
- Arquitectura Limpia e Independiente: Capa de dominio protegida de librerías externas o detalles de infraestructura de bases de datos.
- Virtual DOM Semántico: Estructura de componentes y páginas almacenada en DB como VDOM agnóstico del framework de diseño.
- Motor de Importación de HTML Inteligente: Conversión en tiempo real de cadenas HTML/PHP a nodos VDOM con caché inteligente y soporte contextual.
- Generación de Módulos Dinámicos: Creación de tablas de base de datos físicas y endpoints CRUD sobre la marcha en tiempo de ejecución.
- Renderizado SSR y compilación en disco: Compilación y caché asíncrona de páginas y loops a plantillas PHP y Blade optimizadas.
Índice de Documentación de Integración
Toda la documentación técnica del sistema, especificaciones de la API y guías de integración se ha consolidado en el directorio integration-documentation. A continuación se muestra la estructura disponible:
1. Primeros Pasos (Getting Started)
- Guía de Inicio Rápido: Configuración del entorno, base de datos de pruebas y ejecución de comandos CLI.
- Estado de Implementación: Bitácora completa y lista de chequeo de características implementadas y aprobadas en el core del sistema.
2. Arquitectura (Architecture)
- Visión General de la Arquitectura: Capas del sistema, mapeo de módulos en código y convenciones de namespaces.
- Arquitectura de VDOM y Renderizado Agnóstico: Desacoplamiento del core de layouts visuales como Bootstrap o Tailwind mediante un Virtual DOM semántico.
- Motor de Arquitectura Dinámica V2: Especificación detallada del motor de condiciones dinámicas y consultas avanzadas sobre la marcha.
3. Módulos Core (Core Modules)
- Infraestructura de Soporte: Excepciones personalizadas, validadores de entidades y clases helpers utilitarias.
- Integración HTTP y CLI: Enrutador del CMS, endpoints REST del API, controladores y consola de comandos CLI.
- Componentes de Presentación: Renderizador de menús de navegación con caché integrada, breadcrumbs, banners dinámicos y notificaciones flash.
4. Page Builder
- Importador de HTML a Nodos VDOM: Motor de conversión stateless de cadenas HTML a JSON VDOM, sistema de caché de reglas y navegación con
DomHelper. - Referencia Semántica de HTML: Catálogo y especificación de etiquetas HTML5 y directivas ARIA soportadas por el motor.
5. Módulos Dinámicos (Dynamic Modules)
- Creador de Módulos Dinámicos: Generación automática de esquemas de tablas físicas en tiempo de ejecución, controladores genéricos CRUD e integración de loops de datos.
Ejecución de Pruebas
Para asegurar la estabilidad del sistema tras cualquier cambio en la infraestructura, ejecuta la suite de pruebas unitarias y de integración de PHPUnit:
php vendor/bin/phpunit