Migração Next.js / Astro em Colônia

Köln é a maior cidade da Renânia do Norte-Vestefália e a quarta mais populosa da Alemanha, com 1 025 523 habitantes a 31 de dezembro de 2025, segundo a Wikipédia. É sede da Lufthansa e da RTL, tem um setor de media público e privado em crescimento, indústria química e automóvel, e a Koelnmesse recebe feiras como a gamescom, a DMEXCO, a imm cologne e a ISM. Para quem vende ou recruta aqui, o site é lido em alemão e avaliado segundo regras alemãs. Faço migrações de WordPress, Joomla, Drupal ou frameworks antigas para Astro ou Next.js com esse contexto definido antes de escrever código.

#Quando compensa trocar o WordPress por Astro ou Next.js em Köln?

Compensa quando o CMS trava o desempenho, a segurança ou a publicação, e quando arrumar plugins e cache já não resolve. Começo sempre por medir o site atual: tempo de resposta do servidor, peso das páginas principais, plugins com atualizações em atraso. Se o problema se resolve com configuração, digo-o por escrito e a migração não avança.

Escolho Astro para sites de conteúdo: páginas de serviços, blogue, imprensa, documentação, catálogos sem carrinho. Escolho Next.js quando há área de cliente com autenticação, formulários com lógica por utilizador ou páginas que mudam a cada pedido.

#Como evito perder posições no Google com a mudança de URLs?

O mapa de URLs decide a migração. A Google recomenda reunir os URLs antigos a partir de quatro fontes: sitemaps, registos do servidor ou analítica, o relatório de ligações para o seu site na Search Console e a lista do próprio CMS. Junto as quatro numa folha de cálculo que o cliente pode rever, com uma linha por URL antigo e o destino novo ao lado.

As regras que aplico:

• Cada URL antigo aponta diretamente para o destino final. A Google pede que se evitem cadeias de redirecionamentos.
• Uma página sem equivalente recebe 404 ou 410 deliberado, e não um redirecionamento em massa para a página inicial.
• Títulos, descrições, canónicos e dados estruturados são comparados por script entre o site antigo e o ambiente de teste antes do corte.
• Os redirecionamentos ficam ativos pelo menos um ano, como a Google indica, e muitas vezes sem prazo.
• O sitemap novo é submetido na Search Console no dia do lançamento. Se o domínio também muda, faço o pedido de alteração de endereço para todas as variantes verificadas, com e sem www.

Num WordPress antigo, o que costuma escapar ao inventário são as páginas de etiquetas e de autor, os parâmetros de paginação, os anexos de imagem com URL próprio e os PDF ligados de fora. Num Joomla ou Drupal, os URLs com identificador numérico que continuam ligados em artigos de imprensa antigos. Procuro cada um destes padrões nos registos antes de fechar o mapa.

#O site precisa de versões em alemão e em inglês?

Depende de quem compra. Se a sua empresa vende a clientes alemães, a versão em alemão é a principal, com URLs, títulos e exemplos próprios. Se vende a expositores ou visitantes internacionais de feiras, o inglês entra no mapa de idiomas desde o início, e não depois do lançamento.

Para que o Google mostre a versão certa, cada página tem de listar todas as versões de idioma, incluindo ela própria. Se duas páginas não apontam uma para a outra, a Google ignora as anotações. Os códigos seguem a ISO 639-1 para o idioma e, opcionalmente, a ISO 3166-1 para a região: de, de-DE, en, en-GB. Um código de país sozinho não é válido. Uso x-default na página de escolha de idioma, quando existe.

#Que leis alemãs mudam a forma como construo o frontend?

Descrevo o que a lei diz e o que implemento; a avaliação jurídica do seu caso é com o seu jurista.

Cookies e rastreio. O § 25 do TDDDG só permite guardar ou ler informação no equipamento do utilizador com consentimento baseado em informação clara e completa. Há duas exceções: a transmissão de uma mensagem e o que é estritamente necessário para um serviço que o utilizador pediu expressamente. Num frontend em Astro verifico isto no HTML final e no separador de rede do navegador: antes de qualquer clique, nenhum pedido sai para analítica, pixéis ou vídeos incorporados de terceiros.

Impressum. O § 5 do DDG obriga quem presta serviços digitais comerciais a manter disponíveis, de forma fácil de reconhecer e diretamente acessível, o nome e a morada da sede, um contacto eletrónico rápido incluindo endereço de email, o registo comercial com o número e o número de IVA, quando existam. Na migração confirmo que a ligação está no rodapé de todos os modelos de página e que o URL do Impressum não muda sem redirecionamento.

Acessibilidade. A BFSG aplica-se a serviços prestados a consumidores depois de 28 de junho de 2025, incluindo expressamente o comércio eletrónico. Se a sua loja vende a consumidores, construo o novo frontend com HTML semântico, ordem de foco lógica, navegação por teclado e contraste verificados em cada componente.

Em Köln, a autoridade de proteção de dados competente para empresas é a LDI NRW, a Landesbeauftragte für Datenschutz und Informationsfreiheit Nordrhein-Westfalen, que se define como independente e livre de instruções.

#Onde ficam os dados depois da migração?

Um site Astro estático serve HTML a partir de uma rede de distribuição e não expõe base de dados ao público. Os dados pessoais passam a estar nos serviços à volta: formulários de contacto, newsletter, analítica, pesquisa interna. Para cada um registo onde trata os dados e se há contrato de subcontratação, e deixo essa lista na documentação de entrega. Não prometo alojamento na Alemanha ou na UE que o fornecedor não declare por escrito.

#Como decorre o corte e o que verifico nas semanas seguintes?

1. Inventário de URLs, redirecionamentos, dados estruturados e formulários.
2. Ambiente de teste com o mapa 301 aplicado e comparação automática de metadados com o site atual.
3. Data de lançamento escolhida fora das semanas de maior procura do seu negócio.
4. Em sites grandes, corte por secções com regras no edge a dividir o tráfego entre o sistema antigo e o novo. Corte único só em sites pequenos.
5. No dia do lançamento: teste de todos os redirecionamentos por script, robots.txt, sitemap submetido e inspeção de URLs na Search Console.
6. Nas semanas seguintes: relatório de indexação, erros 404 inesperados, impressões por secção e Core Web Vitals com dados reais.

A Google avisa que os alertas sobre URLs antigos que redirecionam são normais nos relatórios. O que procuro são URLs novos que não entram no índice e consultas que perdem impressões sem razão.

#Qual é o próximo passo?

Envie-me o URL atual, o CMS e as fontes de tráfego (Search Console ou analítica, se tiver acesso). Respondo com um âmbito escrito: o que migrar, o que fica fora, os riscos e as verificações de cada fase. No fim, o repositório, as variáveis de ambiente e o pipeline de publicação ficam consigo. A visão geral do método está na página sobre migração para Astro e Next.js, e o trabalho de frontend na página do desenvolvedor Astro.