Estudo de caso
Plataforma de Experiência do Desenvolvedor
Uma plataforma de micro-frontends em que cada time publica no seu próprio ritmo.
- Papel
- Arquitetura e implementação
- Período
- jan. de 2025 — Atual
- Stack
- Module Federation
- Webpack 5
- Rsbuild
- TypeScript
- Turborepo
- React
Resumo
- Um shell host em Webpack 5 compõe remotes Rsbuild em tempo de execução, então um time faz deploy do seu remote sem redeploy de ninguém.
- Um contrato de federação tipado transforma uma mudança incompatível entre host e remote em erro de compilação, não em incidente em produção.
- Roteamento orientado a registro, RBAC e error boundaries por remote são responsabilidades da plataforma, resolvidas uma vez e não por cada time.
Números-chave
- Remotes independentes
- 5
- Coordenação de deploy entre times
- 0
O problema
Um frontend compartilhado, uma hora, deixa de ser um problema técnico e vira um problema de coordenação. Quando vários times contribuem para uma mesma aplicação, cada release é a release de todo mundo: a mudança inacabada de um time bloqueia a correção de outro, e a fila de deploy vira o verdadeiro gargalo.
A Plataforma de Experiência do Desenvolvedor é a minha resposta à pergunta que esse problema sempre faz — como cinco times fazem deploy de forma independente sem quebrar uns aos outros? É um projeto pessoal que modela uma plataforma interna do jeito que uma organização grande a operaria, construído como um sistema que funciona, e não como um diagrama num slide, e é open source.
Restrições
- Cada time controla o próprio ritmo de release. Nada que um time publique pode exigir que outro time refaça build ou deploy.
- Continua sendo um produto só. Navegação, permissões e linguagem visual precisam parecer uma única aplicação, e não cinco sites costurados.
- Uma falha fica local. Um bug no código de um time não pode derrubar a página para todos os outros.
Arquitetura
Um shell host, construído com Webpack 5, é dono das responsabilidades da
plataforma: autenticação, navegação, orquestração de rotas, controle de acesso
por papéis, error boundaries e telemetria. O mapa estático de remotes dele é
vazio de propósito. Em tempo de execução, ele busca um registro — a fonte
da verdade de rota, URL, versão, permissões e estado de cada remote — e
carrega cada remote via Module Federation na primeira vez que sua rota é
visitada.
Cinco remotes, cada um construído com Rsbuild, são donos do produto:
feature flags, experimentos, logs, um explorador de API e documentação. Cada
um expõe exatamente uma coisa, uma função mount(container, props), e nada
mais atravessa a fronteira.
Três pacotes compartilhados mantêm o sistema coerente sem acoplar os times entre si: os contratos de federação, um pacote de UI com primitivas e design tokens, e um wrapper de observabilidade que registra quanto tempo cada remote leva para carregar. A plataforma inteira vive num monorepo Turborepo.
Decisões e trade-offs
Composição em tempo de execuçãoem vez dePacotes em tempo de build
Se o código de cada time fosse um pacote npm, o host teria que refazer build e deploy para receber qualquer mudança, o que coloca todos os times de volta no mesmo trem de release. Aqui o shell não importa nenhum remote de forma estática: adicionar, desativar ou apontar um remote para outro lugar é uma mudança no registro, e não no shell. O custo é que a integração passa a acontecer no navegador — e é para isso que serve a próxima decisão.
Contratos verificados duas vezesem vez deConfiar na fronteira
Em tempo de execução, uma incompatibilidade entre host e remote é uma tela em branco. Os contratos são interfaces TypeScript, que pegam uma mudança incompatível na compilação, e schemas Zod, que verificam os dados que de fato chegam: o registro é validado antes de o shell lê-lo, e a função de mount de cada remote é validada antes de o shell chamá-la.
Router e cache isolados por remoteem vez deEstado global compartilhado
Cada remote é montado com um router próprio em memória, para que o shell siga sendo o único dono da URL, e com um cache de queries novo, para que nenhum remote leia ou corrompa os dados de outro. Desmontar libera os dois. Os times perdem a conveniência de mexer em estado compartilhado — e esse é justamente o objetivo.
Falha isolada por remoteem vez deUm error boundary para a aplicação
Cada remote carrega com timeout e nova tentativa, renderiza dentro do próprio error boundary e, se falhar, cai numa tela de nova tentativa só dele. Um remote quebrado degrada uma rota; o shell, a navegação e todos os outros remotes continuam funcionando.
Uma CLI de scaffoldingem vez deCopiar o último remote
O create-mfe gera um remote novo já configurado com Rsbuild, Module
Federation, os contratos, os design tokens compartilhados e uma estrutura de
testes com limites de cobertura. Depois, uma entrada no registro o coloca no
ar. As convenções da plataforma ficam codificadas numa ferramenta, e não em
conhecimento tribal.
Resultados
Cinco remotes fazem deploy de forma independente, e publicar um não exige nenhuma coordenação com os outros: os dois números no topo desta página são propriedades da arquitetura, e não de uma semana boa. Responsabilidades que cada time resolveria por conta própria — roteamento, permissões, tratamento de falhas, telemetria, linguagem visual — são resolvidas uma vez, na plataforma.
A barra de qualidade faz parte do design, porque frontends distribuídos falham nas fronteiras: TypeScript estrito, um teste do contrato de mount em cada remote, limites de 80% de cobertura e uma CI rodando lint, tipos, testes e builds em todo o monorepo.