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

Publicado Actualizado
  • Next.js
  • Cloudflare
  • Soporte multilingüe
  • Desarrollo web
  • Migración de sitios web

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

Arquitectura del sitio; ilustración original en japonés

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

Proceso de lanzamiento en ocho pasos; original en japonés

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.

Aplicaciones

Aplicaciones →

Comentarios 0

No indica nacionalidad ni residencia. Las VPN pueden alterarlo.

Todavía no hay contenido.

El nombre, mensaje y país de conexión serán públicos tras aprobación. No incluya datos personales.