Voltar para a página inicial
⚡ Estudo de Arquitetura Enterprise & Fintech Microfrontends

Itaú Store Microfrontends

E-commerce corporativo desacoplado utilizando Webpack 5 Module Federation, comunicação orientada a eventos nativos do navegador e tolerância a falhas em tempo de execução.

Propósito Estudo Prático de Arquitetura
Padrão Arquitetural Module Federation + Event Bus
Divisão de Serviços 1 Host Shell + 4 Microfrontends + API REST
Backend Integrado Node.js, Express & MySQL

01 O que é o Projeto

O Desafio em Grandes Organizações

Em empresas gigantes como o Itaú, dezenas de equipes de desenvolvedores trabalham simultaneamente no mesmo produto web.

Se todo o sistema estiver dentro de um único projeto ("monólito"), cada deploy se torna demorado e arriscado: uma alteração simples no catálogo de produtos pode derrubar o fluxo de login ou quebrar o checkout de pagamentos.

A Abordagem com Microfrontends

A Itaú Store foi desenvolvida para solucionar esse problema na prática. O sistema é dividido em aplicações independentes que rodam de forma autônoma e são unificadas de forma transparente no navegador do cliente:

Cada microfrontend possui seu próprio ciclo de desenvolvimento, repositório e deploy, comunicando-se de forma leve sem gerar acoplamento rígido de código.

02 Como os Módulos foram Divididos

Host / Shell (Porta 6001)

A "casca" principal da aplicação. Gerencia o roteamento central, layout (cabeçalho e rodapé), proteção de rotas e coleta de métricas (telemetria desacoplada via GA4).

MFE Produtos (Porta 6002)

Responsável pelo catálogo de itens, busca em tempo real e categorias. Dispara o evento quando o usuário deseja adicionar um item ao carrinho.

MFE Carrinho (Porta 6003)

Núcleo de negócio do carrinho de compras: cálculo de totais, quantidades e persistência independente sincronizada nativamente com o navegador.

MFE Autenticação (Porta 6004)

Gerencia telas de Login e Cadastro de clientes, emissão de tokens JWT e controle seguro de sessão compartilhada entre as telas.

MFE Checkout (Porta 6005)

Etapa final de compra: endereço de entrega, cálculo de frete, escolha de pagamento (PIX, Cartão, Boleto) e fechamento do pedido.

Backend API & MySQL (Porta 3001)

Servidor Node.js Express com autenticação de senhas criptografadas, endpoints REST de produtos e banco MySQL populado automaticamente.

04 Destaques da Arquitetura Explicados

Comunicação sem Acoplamento (Event-Driven)

Em vez de carregar bibliotecas pesadas de sincronização entre os bundles, os microfrontends conversam através de Custom Events nativos do navegador (como ITEM_ADICIONADO e CARRINHO_ATUALIZADO).

Isso permite que um microfrontend seja completamente reescrito ou atualizado sem que os outros precisem ser recompilados.

Resiliência e Tolerância a Falhas

Cada módulo remoto é encapsulado por React.lazy, Suspense e ErrorBoundary no Shell.

Se o serviço de catálogo ficar fora do ar por alguns instantes, o restante da aplicação permanece funcionando sem que a tela do usuário fique toda em branco.

05 Tecnologias Utilizadas

Frontend

React 19 & Webpack 5

Renderização moderna e o plugin nativo Module Federation para compartilhamento de dependências em tempo de execução.

Backend

Node.js & Express 4

API REST leve com controle de CORS de origens cruzadas e pool de conexões assíncronas.

Banco de Dados

MySQL 2 & Migrations

Inicialização e migração automatizada de tabelas (users e products) com seeds de dados em ambiente local.

DevOps & Orquestração

Concurrently

Script unificado para inicialização coordenada de todos os 6 serviços (5 frontends + 1 backend) em um único comando.

Conhecer Também

Maquinato — SaaS em Produção →

Ver Plataforma Maquinato