Como projetar um site Astro + Cloudflare que cresce por funcionalidade

Ao começar com Astro e Cloudflare Pages, normalmente basta publicar páginas estáticas rápidas e seguras.

Depois surgem novas necessidades: edição pelo navegador, páginas localizadas, orientação com chat de IA, contexto do serviço no formulário e comentários.

Este artigo é um índice de implementação: ajuda a decidir em qual camada cada função fica, em que ordem adicionar e qual guia detalhado ler depois. O exemplo é o site da Acecore, mas o padrão funciona em outros sites Astro + Cloudflare.

Resumo

A arquitetura separa responsabilidades:

Camada	Responsabilidade
Astro	Páginas, blog, OGP, RSS, sitemap e UI
Cloudflare	Pages, Pages Functions, D1 e Turnstile
GitHub	PRs, diffs de CMS, traduções e histórico
Sveltia CMS	Fonte japonesa, autores, tags e imagens
OpenAI API	Respostas do chat de contato
Pagefind	Índice de busca para HTML revisado

O que pode ser estático fica estático. O que precisa de runtime vai para pequenas APIs.

APIs pequenas no Cloudflare

Chat com IA e comentários seguem o mesmo padrão.

Astro renderiza a UI. Pages Functions cuida da fronteira de API. Secrets, bindings D1, Turnstile, Origin checks e rate limit ficam fora do navegador.

CMS como interface de edição

Sveltia CMS não é banco de dados em runtime. Ele cria mudanças no Git.

Conteúdo japonês, autores, tags, imagens e JSON passam por PR, build e review antes de produção.

Tradução como conteúdo estático

Localização não é só traduzir a tela no navegador.

Cada idioma tem URL, title, description, OGP, JSON-LD, RSS, sitemap e hreflang próprios.

Canais de contato separados

O chat com IA ajuda quem ainda está escolhendo. O CTA de serviço preserva contexto. O formulário registra a consulta formal.

Cada um tem uma função.

Saída de IA não é HTML confiável

Links Markdown vindos da IA são tratados como texto até serem validados.

Só links permitidos por allowlist viram nós DOM seguros.

Comentários dentro do Cloudflare

Os comentários não usam widget externo.

Pages Functions recebe GET/POST, D1 guarda comentários e Turnstile protege envios. Para um blog institucional pequeno, isso é suficiente.

Ler por objetivo

Não é preciso ler tudo primeiro. Comece pela função que você quer adicionar.

Objetivo	Leia primeiro
Editar artigos e imagens pelo navegador	Guia de instalação do Sveltia CMS
Publicar páginas multilíngues indexáveis	Como operar um blog multilíngue com Sveltia CMS
Orientar visitantes com chat de IA	Design técnico do chat de contato com IA
Renderizar links seguros em respostas de IA	Renderização segura de links Markdown em respostas de IA
Levar contexto do serviço ao formulário	Passar contexto do CTA para o formulário
Adicionar comentários sem serviço externo	Comentários de blog Astro usando só Cloudflare

Ordem de implementação

Para um site parecido, a ordem prática é:

1. Consolidar páginas estáticas, blog, RSS, sitemap e OGP com Astro.
2. Adicionar Sveltia CMS para editar a fonte japonesa.
3. Gerar páginas localizadas como HTML estático.
4. Adicionar orientação com chat de IA e CTAs de serviço.
5. Proteger links Markdown, prefill de formulário, Origin checks e rate limits.
6. Adicionar comentários dentro do Cloudflare só quando forem necessários.

Conclusão

Astro + Cloudflare permite ampliar um site institucional sem perder as vantagens da entrega estática.

Use esta página como entrada e adicione apenas as partes que seu site precisa, sem enfraquecer a base estática.