SANGE Studio migra a Next.js: arquitectura y tres tardes hasta el lanzamiento
Migré el sitio de SANGE Studio de HTML estático a Next.js entre el 11 y el 13 de noviembre de 2026, dedicando unas tres o cuatro horas al día después del trabajo. Conservé las URL y el contenido en 12 idiomas, y añadí un panel web para gestionar borradores, vistas previas y publicaciones. Aquí explico la arquitectura, los servicios de Cloudflare y el proceso hasta el lanzamient
Migré el sitio de SANGE Studio de HTML estático a Next.js entre el 11 y el 13 de noviembre de 2026, dedicando unas tres o cuatro horas al día después del trabajo. Conservé las URL y el contenido en 12 idiomas, y añadí un panel web para gestionar borradores, vistas previas y publicaciones. Aquí explico la arquitectura, los servicios de Cloudflare y el proceso hasta el lanzamiento.
Por qué cambiar
El sitio anterior combinaba HTML, CSS, JavaScript y scripts de Python que generaban páginas con antelación. Ya servía presentaciones de aplicaciones, documentos legales y artículos, pero modificar una entrada exigía mantener coherentes las listas, traducciones y el mapa del sitio. Con 12 idiomas había mucho que revisar.
Separé los datos de los artículos del proceso que genera las páginas y trasladé el blog a una base de datos. El objetivo era escribir, guardar un borrador, revisar su aspecto y después publicar.
La función de Next.js
Next.js es un framework para desarrollar aplicaciones web con React. Aquí permite crear las páginas públicas y el panel de administración. El servidor obtiene el artículo y devuelve HTML con su texto: renderizado del lado del servidor, o SSR. Los lectores siguen usando las mismas URL; quien edita gestiona versiones y estados de publicación en lugar de archivos HTML individuales.
Qué hace cada servicio de Cloudflare
Cloudflare ofrece distribución y protección de sitios, ejecución de aplicaciones y almacenamiento. En este proyecto combiné cuatro servicios.
Workers: ejecutar el programa
Cloudflare Workers ejecuta código en la red de Cloudflare. La infraestructura de ejecución está gestionada por el servicio, sin que tenga que preparar una máquina y mantener su sistema operativo. Obtiene artículos, genera páginas y procesa las solicitudes del editor.
D1: guardar artículos y traducciones
Cloudflare D1 es una base de datos que organiza información y permite consultarla según condiciones. Guarda títulos, cuerpos, idiomas, borradores, versiones publicadas e historial. Por ejemplo, devuelve las entradas publicadas en inglés o la versión japonesa de un artículo.
R2: guardar imágenes
Cloudflare R2 almacena archivos. D1 contiene los datos del artículo; R2, las imágenes subidas desde el panel. Las imágenes anteriores y el CSS siguen distribuyéndose como archivos estáticos.
Access: limitar la administración
Cloudflare Access controla quién puede entrar en una aplicación web. Leer artículos no requiere iniciar sesión; editar sí. La aplicación también valida la autenticación y las operaciones de guardado.
Cómo se conectan los componentes
El diagrama está en japonés. Los lectores entran al sitio público y los administradores pasan por Access. Ambas interfaces utilizan Workers, que se conecta con D1, R2 y los archivos estáticos.
Al abrir una entrada, Workers lee el texto publicado de D1 y devuelve la página. Las imágenes proceden de R2 o de archivos estáticos. Tras la autenticación mediante Access, los cambios del editor llegan a D1 a través de Workers.
OpenNext prepara la aplicación Next.js para Workers. No todas las páginas se trasladaron a la base de datos: las presentaciones de aplicaciones y los documentos legales utilizan datos extraídos del HTML anterior y se mantienen mediante Git, un sistema de control de versiones. La edición web se centra en el blog.
Borradores separados de la publicación
El panel permite crear entradas, guardar borradores, previsualizar, publicar, traducir y gestionar imágenes. Guardar un borrador no cambia lo que ve el lector. La versión pública se sustituye al publicar, después de revisarla.
Se conserva el historial y una versión anterior puede recuperarse como nuevo borrador. Cada idioma tiene su propio borrador y estado de publicación. El cuerpo admite HTML y Markdown, con una vista formateada de títulos, imágenes y tablas, edición del código y vista previa del contenido guardado.
Tiempo de trabajo
Fueron tres días, del 11 al 13 de noviembre de 2026, a razón de tres o cuatro horas al terminar la jornada: aproximadamente entre nueve y doce horas en total. Es una estimación, no una medición cronometrada. Reutilicé artículos, traducciones, imágenes y diseño; no construí todo el sitio desde cero. No medí cada etapa por separado.
| Fecha | Trabajo principal |
|---|---|
| 11 de noviembre | Revisar el sitio y los datos multilingües; diseñar la arquitectura |
| 12 de noviembre | Implementar páginas y administración; comprobar localmente |
| 13 de noviembre | Preparar producción, publicar, separar la administración y verificar |
Ocho pasos hasta el lanzamiento
La ilustración japonesa resume los pasos que se explican a continuación.
1. Inventariar el sitio
Revisé 300 URL públicas, páginas 404 en 12 idiomas y siete artículos con 84 versiones lingüísticas. URL, textos, imágenes y metadatos para buscadores sirvieron como lista de comprobación.
2. Diseñar la estructura y los datos
Asigné artículos y traducciones a D1, imágenes nuevas a R2 y lógica a Workers. Definí borradores, versiones publicadas, historial y estados por idioma, separando guardar de publicar.
3. Preparar el entorno local
Docker Compose proporcionó un entorno separado de producción. Docker ejecuta programas junto con su entorno necesario. Pude probar guardados y subidas sin cambiar artículos públicos. Desarrollé en Windows y generé las compilaciones de producción en Linux.
4. Implementar páginas y funciones
Importé el contenido e implementé visualización, edición y publicación. Conservé encabezados, imágenes, tablas y páginas por idioma, así como enlaces y marcadores. Las antiguas URL de selección de idioma recibieron redirecciones.
5. Probar en local y en validación
Las pruebas automáticas y el entorno de validación cubrieron guardado, publicación, traducciones, imágenes, URL, idiomas y mapa del sitio. También comprobé el rechazo de operaciones no autorizadas y el aislamiento de los borradores.
6. Preparar producción
Creé D1 y R2 de producción separados de las pruebas, importé los artículos y configuré Access. Verifiqué la autenticación con la compilación de producción antes de publicar.
7. Respaldar y cambiar por etapas
Hice una copia de los datos y comprobé su coherencia. Conecté y probé primero el panel, y después trasladé el sitio público al nuevo Worker. Conservé la configuración anterior para poder volver atrás. Más tarde separé la administración en un dominio dedicado.
8. Revisar las URL reales
Tras el cambio comprobé páginas, errores 404 localizados, URL canónicas, mapa del sitio, imágenes, base de datos y acceso administrativo. Después actualicé Node.js y dependencias, volví a compilar y probar, y desplegué. La comprobación volvió a cubrir 300 URL y 61 archivos estáticos.
Qué ha cambiado y qué queda por medir
El blog dispone ahora de edición web sin perder sus URL ni su contenido multilingüe. Borradores, traducciones, imágenes y versiones públicas se gestionan juntos. Los efectos sobre posicionamiento y velocidad requieren medición: el sitio anterior ya entregaba el texto en HTML. La mejora concreta está en la edición y la gestión de datos.
Usar infraestructura gestionada no elimina las actualizaciones de la aplicación, los permisos ni las copias de seguridad. Seguiré ajustando el editor al preparar nuevos artículos y traducciones.
Basado en la arquitectura y los registros de migración del 13 de noviembre de 2026. Los enlaces de servicios llevan a la documentación oficial de Cloudflare.
Comentarios 0
No indica nacionalidad ni residencia. Las VPN pueden alterarlo.
Todavía no hay contenido.