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.
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
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
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.
Comentários 0
Não indica nacionalidade ou residência. VPNs podem alterar o resultado.
Ainda não há conteúdo.