SANGE Studio migra para Next.js: arquitetura e três noites até o lançamento

Migrei o site do SANGE Studio de HTML estático para Next.js entre 11 e 13 de novembro de 2026, trabalhando cerca de três a quatro horas por dia depois do expediente. Mantive as URLs e o conteúdo em 12 idiomas e passei a gerenciar rascunhos, prévias e publicações pelo navegador. Neste artigo explico a arquitetura, os serviços da Cloudflare e a sequência até o lançamento.

Publicado Atualizado
  • Next.js
  • Cloudflare
  • Suporte a vários idiomas
  • Desenvolvimento web
  • Migração de sites

Migrei o site do SANGE Studio de HTML estático para Next.js entre 11 e 13 de novembro de 2026, trabalhando cerca de três a quatro horas por dia depois do expediente. Mantive as URLs e o conteúdo em 12 idiomas e passei a gerenciar rascunhos, prévias e publicações pelo navegador. Neste artigo explico a arquitetura, os serviços da Cloudflare e a sequência até o lançamento.

Por que migrar?

O site anterior usava HTML, CSS, JavaScript e scripts Python para gerar páginas antecipadamente. Ele já atendia às páginas dos aplicativos, documentos legais e artigos. Porém, alterar uma publicação também exigia manter listas, traduções e sitemap consistentes. Em 12 idiomas, havia bastante coisa para conferir.

Separei os dados dos artigos da geração das páginas e levei o blog para um banco de dados. A ideia é escrever, salvar um rascunho, conferir a apresentação e só então publicar.

O papel do Next.js

Next.js é um framework para desenvolver aplicações web com React. Aqui ele atende às páginas públicas e ao painel administrativo. O servidor busca os dados e devolve HTML com o texto do artigo, processo chamado renderização no servidor, ou SSR. O leitor continua acessando as mesmas URLs; quem edita gerencia versões e estados de publicação em vez de arquivos HTML individuais.

Os serviços da Cloudflare

A Cloudflare oferece distribuição e proteção de sites, execução de aplicações e armazenamento. Combinei quatro serviços com funções distintas.

Workers: executar a aplicação

Cloudflare Workers executa código na rede da Cloudflare. A infraestrutura de execução é gerenciada pelo serviço, sem que eu precise preparar uma máquina e manter seu sistema operacional. Workers busca artigos, monta páginas e processa pedidos do editor.

D1: armazenar artigos e traduções

Cloudflare D1 é um banco de dados: organiza informações e permite consultá-las por critérios. Guarda títulos, textos, idiomas, rascunhos, versões publicadas e histórico. Pode, por exemplo, retornar artigos publicados em inglês ou a versão japonesa de uma entrada.

R2: guardar imagens enviadas

Cloudflare R2 armazena arquivos. O D1 guarda informações dos artigos; o R2, imagens enviadas pelo painel. Imagens antigas e CSS continuam sendo distribuídos como arquivos estáticos.

Access: restringir a administração

Cloudflare Access controla quem pode entrar em uma aplicação web. Ler artigos não exige login; editar exige. A aplicação também valida a autenticação e as solicitações de gravação.

Como os componentes se conectam

Arquitetura dos serviços; ilustração original em japonês

O diagrama está em japonês. Leitores acessam o site público; administradores passam pelo Access. As duas interfaces usam Workers, conectado ao D1, ao R2 e aos arquivos estáticos.

Ao abrir um artigo, Workers lê o texto publicado no D1 e devolve a página. As imagens vêm de arquivos estáticos ou do R2. Depois do login pelo Access, as alterações passam pelo Workers até o D1.

OpenNext prepara a aplicação Next.js para Workers. Nem todas as páginas foram para o banco: apresentações de aplicativos e documentos legais usam dados extraídos do HTML anterior e continuam mantidos pelo Git, sistema de controle de versões. O novo fluxo de edição pelo navegador é voltado principalmente ao blog.

Separar rascunhos da publicação

O painel permite criar artigos, salvar rascunhos, visualizar prévias, publicar, traduzir e gerenciar imagens. Salvar um rascunho não muda o que o leitor vê. A versão pública só é substituída ao publicar, após a revisão.

O histórico é preservado, e uma versão anterior pode virar um novo rascunho. Cada idioma tem seu próprio rascunho e estado de publicação. O corpo aceita HTML e Markdown, com visualização formatada de títulos, imagens e tabelas, edição do código e prévia do conteúdo salvo.

Tempo de trabalho

Foram três dias, de 11 a 13 de novembro de 2026, com cerca de três a quatro horas após o expediente: aproximadamente nove a doze horas no total. É uma estimativa, não uma medição cronometrada. Artigos, traduções, imagens e design já existiam; não foi um site criado do zero. As etapas não foram cronometradas separadamente.

Data Trabalho principal
11 de novembro Levantamento do site e dos dados multilíngues; arquitetura
12 de novembro Implementação das páginas e do editor; verificação local
13 de novembro Preparação de produção, lançamento, separação da administração e verificações

Oito etapas até o lançamento

Oito etapas de lançamento; original em japonês

A ilustração japonesa resume as etapas descritas abaixo.

1. Levantar o site existente

Conferi 300 URLs públicas, páginas 404 em 12 idiomas e sete artigos com 84 versões linguísticas. URLs, textos, imagens e metadados de busca formaram a lista de verificação.

2. Projetar a estrutura e os dados

D1 ficou com artigos e traduções, R2 com imagens novas e Workers com a lógica. Defini rascunhos, versões públicas, histórico e estados por idioma, distinguindo salvar de publicar.

3. Preparar o ambiente local

Docker Compose forneceu um ambiente separado de produção. Docker executa programas junto com o ambiente necessário. Assim, testei gravações e uploads sem alterar artigos públicos. Desenvolvi no Windows e gerei as compilações de produção no Linux.

4. Implementar páginas e funções

Importei o conteúdo e implementei exibição, edição e publicação, preservando títulos, imagens, tabelas e páginas por idioma. Links e favoritos continuaram utilizáveis; URLs antigas de seleção de idioma ganharam redirecionamentos.

5. Testar e validar

Testes automáticos e um ambiente de validação cobriram gravação, publicação, traduções, imagens, URLs, idiomas e sitemap. Também verifiquei o bloqueio de operações não autorizadas e o isolamento dos rascunhos.

6. Preparar produção

Preparei D1 e R2 separados dos testes, importei os artigos e configurei Access. A autenticação foi verificada com a compilação de produção antes do lançamento.

7. Fazer backup e mudar em etapas

Copiei os dados e verifiquei sua consistência. Primeiro conectei e testei o painel; depois mudei o site público para o novo Worker. Mantive a configuração anterior para poder reverter. Em seguida, levei a administração para um domínio dedicado.

8. Conferir as URLs reais

Depois da mudança, verifiquei páginas, erros 404 localizados, URLs canônicas, sitemap, imagens, banco e proteção administrativa. Mais tarde atualizei Node.js e dependências, recompilei, testei e implantei. As verificações voltaram a cobrir 300 URLs públicas e 61 arquivos estáticos.

O que mudou e o que ainda será medido

Agora o blog pode ser editado pelo navegador sem perder URLs e conteúdo multilíngue. Rascunhos, traduções, imagens e versões públicas ficam no mesmo fluxo. Efeitos sobre busca e velocidade ainda precisam ser medidos: antes o texto já era entregue em HTML. A mudança concreta está na edição e gestão dos dados.

Infraestrutura gerenciada não elimina atualizações da aplicação, permissões ou backups. Vou ajustar o editor à medida que produzir novos artigos e traduções.


Baseado na arquitetura e nos registros de migração de 13 de novembro de 2026. Os serviços estão vinculados à documentação oficial da Cloudflare.

Aplicativos

Aplicativos →

Comentários 0

Não indica nacionalidade ou residência. VPNs podem alterar o resultado.

Ainda não há conteúdo.

Nome, mensagem e país da conexão ficam públicos após aprovação. Não inclua dados pessoais.