kuferweb para TYPO3

kuferweb es el puente entre el sistema especializado Kufer y el sitio web público TYPO3

Las escuelas de adultos, los centros de formación y las academias gestionan su actividad de cursos desde hace décadas con software especializada, y en muchos centros del ámbito germanófono ese software se llama Kufer. Kufer cubre todo el ciclo de vida del curso: gestión de docentes, planificación, reserva de aulas, participantes, facturación, certificados. Para la web eso supone una tarea estándar: el catálogo de cursos mantenido en el backoffice debe ser visible al día en la web TYPO3, incluyendo búsqueda con filtros, vistas de detalle e inscripción en línea.

El público está claramente delimitado: centros de formación con un mandante Kufer existente que operan su web sobre TYPO3. Típico es una escuela municipal de adultos con unos 2.500 cursos por semestre y media docena de docentes que mantienen sus cursos en Kufer. Sin una integración limpia, el catálogo de la web se queda obsoleto, la doble gestión se convierte en estado permanente y las inscripciones acaban en un sistema separado que nadie aprecia.

Escenarios típicos de uso

Un primer escenario es el catálogo de cursos actualizado automáticamente. Una escuela con 2.500 cursos por semestre quiere que cada alta de curso, cada cambio de precio y cada cambio de docente se vuelva visible en la web sin intervención manual. Un job de sincronización horario tira los datos actuales de Kufer, los escribe en una tabla TYPO3 y actualiza la búsqueda. El redactor ya no mantiene cursos en el backend de TYPO3.

Un segundo escenario es la inscripción en línea directa. Un centro de formación con programas subvencionados quiere llevar a los interesados directamente desde la página de detalle del curso a un proceso de inscripción que, en segundo plano, llama a la API de Kufer y registra al participante en Kufer. TYPO3 sirve como frontend, Kufer sigue siendo la fuente de la verdad, la redacción ve el nuevo estado de inscripción en la interfaz que ya conoce.

Un tercer escenario es la búsqueda con facetas específicas del ámbito. Una academia con 40 áreas y varios miles de cursos quiere permitir a los interesados buscar por categorías, lugares, fechas, docentes y clases de precio. La búsqueda corre en la página TYPO3 contra un índice local construido a partir del export de Kufer, con buen rendimiento e independiente de la disponibilidad de la aplicación especializada.

Un cuarto escenario es la salida multilingüe de cursos. Una escuela de idiomas con sedes en varias regiones mantiene los cursos en Kufer solo en un idioma y quiere ofrecer en la web una presentación multilingüe para los interesados. La integración asume el mapping a las variantes de idioma de TYPO3, complementa los campos Kufer con traducciones manuales en la redacción del CMS y garantiza que los cambios en Kufer no sobrescriban las traducciones locales.

Arquitectura técnica

Las integraciones kuferweb en TYPO3 son casi siempre desarrollos a medida, porque las estructuras de datos varían por mandante Kufer y las versiones de API han cambiado varias veces a lo largo de los años. El planteamiento estándar es una extensión Extbase ligera con tres pilares: una capa de servicio que encapsula la API de Kufer, una capa de persistencia que replica los cursos en tablas TYPO3 y una capa de presentación que entrega plantillas Fluid para lista, filtro y detalle.

La sincronización corre a través de una tarea del Scheduler de TYPO3. Para catálogos grandes se recomienda una importación delta que solo transmita los cursos modificados desde la última ejecución. La API de Kufer suele entregar un timestamp o una marca de cambio por curso, que se utiliza para la detección delta.

La inscripción en línea requiere un path adicional de API y una gestión limpia de errores. La API de Kufer puede responder lenta bajo alta carga, por eso las inscripciones corren típicamente de forma asíncrona: el formulario deposita la petición de alta en una cola, un worker la transmite a Kufer y el participante recibe un correo de confirmación en cuanto Kufer acusa el registro.

Problemas frecuentes y soluciones

El primer problema es la divergencia de campos entre mandantes Kufer. Lo que en el mandante A se llama “número de evento” en el mandante B es “código de curso” y en el mandante C “número de inscripción”. La solución es un field mapping configurable en la extensión TYPO3 que se adapta por instalación y no queda hardcoded en el código.

El segundo problema es la calidad de datos en el catálogo de cursos. Las redactoras no siempre mantienen textos completos en Kufer: faltan descripciones breves, no hay imágenes, no se definen públicos objetivo. En la web esas lagunas aparecen como campos vacíos. La solución es una capa de validación en la sincronización que marque los cursos incompletos en el backend y exija a la redacción completarlos.

El tercer problema es la lógica de cancelación. Cuando se cancelan cursos en Kufer, deben desaparecer de la web o al menos marcarse como cancelados. La solución es poner explícitamente los cursos cancelados en la sincronización en un estado que se oculte en la lista y dotar la página de detalle de un redirect a una vista general de categoría.

Un cuarto problema es la visualización de la ocupación en tiempo real. Los interesados ven en la web “quedan 3 plazas libres” aunque la reserva en segundo plano ya haya pasado a lista de espera. La solución es no leer la indicación de ocupación desde el caché de sincronización, sino emitir, en cada llamada de la página de detalle, una pequeña llamada en vivo a Kufer, con caching agresivo (30 a 60 segundos) y un fallback al último valor conocido si la API no responde.

Migración y compatibilidad de versiones

Las integraciones kuferweb corren en TYPO3 v11, v12 y v13 siempre que la conexión API esté construida de forma moderna. El punto de dolor más frecuente no es la versión de TYPO3, sino la versión de Kufer: cuando el centro migra su mandante Kufer a una nueva versión, cambian ocasionalmente endpoints API y estructuras de datos, lo que obliga a reajustar la integración TYPO3.

Gosign construye integraciones kuferweb sobre la base de la API actual de Kufer, comprueba antes del inicio del proyecto la compatibilidad con el mandante del cliente y monta la integración de forma tan modular que los futuros upgrades de API funcionen sin reconstrucción a gran escala. Con apoyo de IA, el código del cliente API nace en horas en lugar de días, con lo que la puesta en marcha en la mayoría de los proyectos se vuelve realista en dos o tres sprints.