Soamee.com: 996 páginas em 5 idiomas com uma equipa boutique

O caso de estudo mais incómodo de publicar é o próprio. Não há cliente a quem atribuir o mérito nem números de negócio alheios atrás dos quais se esconder: apenas um repositório que qualquer pessoa pode auditar. Esta é a história de como soamee.com passou de site institucional normal a teste de campo da nossa metodologia.

O desafio

Uma agência boutique tem um problema de aritmética. Os nossos clientes internacionais chegam de Espanha, Portugal, Itália, Alemanha e do mundo anglófono, e cada mercado quer ler no seu idioma. O site de que precisávamos não era um site de cinco páginas: era um catálogo completo de serviços, setores, integrações, comparativos e produto próprio, multiplicado por cinco.

Feitas as contas pelo método clássico, o projeto não fechava. Traduzir e manter cada landing à mão consome o tempo que devia ir para os projetos de cliente, e todos sabemos como acaba essa história: o espanhol atualiza-se, o alemão fica congelado dois anos, e acaba com um site que dá pior impressão do que não ter versão alemã.

Os três problemas concretos eram:

• Paridade multilingue: cada conteúdo novo tinha de sair em cinco idiomas ou não sair. Sem exceções «temporárias» que duram para sempre.
• Qualidade técnica constante a alta velocidade: publicar depressa é fácil; publicar depressa sem deixar metadados partidos, imagens fantasma nem links mortos, não.
• Custo de oportunidade: nem uma hora da equipa dedicada a tarefas que uma máquina pode fazer e verificar.

A nossa solução

Aplicámos à nossa própria casa o pipeline que usamos com clientes: o processo CRAFT (Consult, Research, Architect, Forge, Track) com uma camada de agentes de IA por baixo e um conjunto de portas de qualidade automáticas por cima.

As decisões continuam humanas

A arquitetura do site, o sistema de design, a taxonomia de conteúdos e o critério editorial foram decididos pela equipa. Os agentes não escolhem o que construir: executam o que já está decidido. Cada alteração passa por revisão humana antes do merge, sem exceção.

A camada de agentes trata do repetitivo

Onde o trabalho é mecânico e verificável, delegamos:

• Traduções para quatro idiomas de cada artigo e cada landing, com revisão posterior
• Andaime de páginas a partir de templates e dados já estruturados
• Migrações em massa e refactors que tocam centenas de ficheiros de uma vez
• Scripts de verificação e automações de CI

As portas de qualidade não se saltam

Aqui está a parte que torna a velocidade sustentável. Toda alteração atravessa verificações automáticas antes de chegar a produção, e as mesmas verificações correm localmente através de um hook de pre-push:

• Cobertura de traduções: se um conteúdo sai em espanhol sem as quatro traduções, o push falha
• Verificação de imagens: toda imagem referenciada existe, e dois conteúdos distintos não reutilizam a mesma
• Auditoria SEO: títulos, descrições, h1, canónicas e hreflang de cada URL construído
• Validação de Schema.org: o JSON-LD de cada template, verificado
• Miniaturas sociais: cada URL tem o seu cartão com o seu próprio copy, gerado a pedido

A isto somam-se as auditorias agendadas: Lighthouse, detetor de links partidos, vigilância de metadados e snapshots de posicionamento. 22 automações no total.

Os cartões sociais, um exemplo da abordagem

Um detalhe pequeno ilustra bem a diferença. Cada URL do site tem a sua própria miniatura social, com o título e a descrição dessa página concreta e com o design da sua secção. Não há uma única imagem guardada no repositório: são geradas a pedido com satori e resvg, sem navegador, e ficam em cache na memória.

Fazer isso à mão para mil páginas é inviável. Automatizado, é um template por família de conteúdo e um endpoint. É esse o tipo de trabalho que muda de categoria quando o custo marginal da execução desaba.

Resultados

• 996 páginas publicadas e mantidas, sem contar rotas dinâmicas
• 5 idiomas em paridade real: espanhol, inglês, português, italiano e alemão
• 635 artigos de blog (127 originais em espanhol com as suas quatro traduções)
• 130 casos de sucesso publicados (26 casos × 5 idiomas), sempre sincronizados
• 67 componentes de um sistema de design próprio, sem templates comprados
• 22 automações de CI a vigiar traduções, imagens, SEO, Schema.org, links e desempenho

O dado que mais nos importa não é o volume, mas a paridade. Manter cinco idiomas alinhados é a primeira coisa que qualquer equipa sem capacidade abandona: é o indicador honesto de se um pipeline funciona ou apenas soa bem numa landing.

O que não funcionou

Publicamos também as letras miúdas, porque um caso de sucesso sem elas não vale nada.

O design visual original foi o terreno onde menos ajuda obtivemos: o gerado tendia para o genérico e foi preciso refazê-lo à mão até acertar na identidade. As decisões de produto e a lógica de negócio complexa continuaram integralmente humanas e consumiram o tempo que seria de esperar. E nas primeiras semanas subestimámos a revisão: sem as portas de qualidade, a velocidade produzia dívida mais depressa do que produzia páginas. As automações nasceram precisamente daí.

Stack técnica

• Framework: Astro 5 em modo híbrido (SSR com @astrojs/node)
• Estilos: Tailwind CSS v4 com sistema de design próprio
• Interatividade: ilhas de React onde são necessárias
• Conteúdo: Content Collections em Markdown para blog e casos
• Imagens sociais: satori + resvg, geradas a pedido
• CI/CD: GitHub Actions e deploy em Dokku
• Qualidade: verificadores próprios em Node executados na CI e em hooks de git