Rediseño y migración del sitio institucional

Contexto

El Colegio San Adolfo es una institución educativa de Fe y Alegría en Uruguay. Su sitio institucional corría sobre WordPress con el tema Betheme y el constructor WPBakery 5.7, una combinación incompatible con PHP 8: actualizar el servidor producía un error fatal. El sitio acumulaba además configuración desactualizada: Universal Analytics (servicio discontinuado) hardcodeado, actualizaciones bloqueadas por un plugin, zona horaria configurada en Europe/Madrid y branding insertado manualmente en widgets HTML.

Problema

Se identificaron tres frentes. Primero, el bloqueo de mantenimiento: no era posible actualizar PHP sin dejar el sitio fuera de servicio, lo que impedía cualquier actualización del servidor. Segundo, fallas funcionales: el formulario de newsletter enviaba las suscripciones a una casilla de correo incorrecta. Tercero, exposición de seguridad: un archivo debug.log de 4,7 MB públicamente descargable, enumeración de usuarios habilitada vía REST API y ausencia de headers de seguridad.

Solución

El proyecto comprendió la migración a un child theme propio (csa-2026, templates PHP + Gutenberg) y la corrección de los problemas relevados. El trabajo se realizó con Claude Code como agente de ingeniería, con el siguiente reparto: el agente auditó el dump completo de la base SQL, construyó el theme, aplicó las correcciones de seguridad (bloqueo de la enumeración por REST, cinco headers nuevos, remoción del generator, log inaccesible) y escribió los scripts de deploy —con dry-run por defecto— y los runbooks del proyecto. La ejecución con credenciales (subidas, imports de base de datos) y las decisiones de producto —siete, documentadas— quedaron del lado humano. Los seis commits del repositorio están co-firmados por el agente.

El sistema de diseño se generó con Google Stitch: minimalismo, navy con rojo académico y detalles en dorado. Las diez páginas del sitio se migraron fuera de WPBakery, lo que permite dar de baja las licencias de WPBakery y Revslider. Se configuró GA4 con guard de dominio, se reparó la newsletter —verificada con un envío real— y se automatizó el QA con Playwright: capturas comparativas entre producción, entorno local y diseño, incluyendo mobile.

Durante el proceso se diagnosticó además un error 503 que afectaba únicamente a los posts individuales, con la home y las páginas estáticas operativas. La causa era una recursión infinita en la generación del título SEO; la corrección fue de una línea.

Resultados

El pasaje a producción se realizó el 17 de julio de 2026 con verificación punto por punto: 11 URLs respondiendo 200, import de base de datos con 89 statements y 0 errores, 188.394 valores serializados validados sin corrupción y cero residuos de WPBakery. El menú pasó de 10 a 5 ítems; los plugins activos, de 14 a 9. Existían backup completo y plan de rollback documentado; no fue necesario utilizarlos. El diseño y la auditoría se realizaron en junio de 2026; la dedicación efectiva fue de unas seis jornadas de entre 2 y 4 horas.