Saltar para o conteúdo

Porque sempre desenvolvemos com componentes, e o que isso poupou a um cliente em seis anos

Arquitetura baseada em componentes do lado do cliente: como os componentes reutilizáveis fizeram com que seis anos de alterações a uma aplicação nunca exigissem uma reconstrução.

Cabeçalho de artigo do blog sobre um fundo em gradiente azul-escuro com uma etiqueta "Blog" e o logótipo da Concealed. À esquerda, uma maqueta simplificada de produto com um espaço reservado para imagem e linhas de texto contém um botão "Quick checkout" com um ícone de relâmpago. Linhas tracejadas ligam esse botão a três cartões à direita, Product page, Product card e Map popup, cada um com o mesmo botão "Quick checkout" ao lado de um ícone de layout de página, de um cartão de produto e de um marcador de mapa.

Photograph of Francisco Lopes, developer at ConcealedFrancisco Lopes

O pedido que volta como uma reconstrução

A maioria dos projetos de software tem um “segundo ato” que não pode ser orçamentado à partida. O produto é lançado, os clientes usam-no e, em poucos meses, o cliente sabe coisas que não podia saber antes, por isso, compreensivelmente, pede alterações, como uma nova forma de pagamento, um filtro que não estava previsto inicialmente ou outro tipo de produto na mesma loja. Em muitos estúdios, o orçamento que chega é surpreendentemente alto aos olhos do cliente, com a explicação de que “mexe em tudo”.

Essa resposta costuma ser honesta, porque descreve a forma como o software foi feito. Se um produto é escrito como um conjunto de páginas, cada uma com a sua própria cópia da lógica de que precisa, então cada alteração mexe mesmo em tudo e, mais cedo ou mais tarde, alguém propõe a reconstrução. Passámos nove anos a trabalhar para nunca estarmos nessa posição, e a forma como o fazemos não é nova nem engenhosa. Desenvolvemos com componentes, do primeiro ficheiro de design à última linha de código, e fizemo-lo em todos os projetos desde que começámos.

A aplicação desktop da simMarket, que desenvolvemos e mantemos desde 2020, é o exemplo que este artigo acompanha: nos seis anos desde o lançamento, o cliente pediu muitas funcionalidades novas, como um checkout rápido, novos filtros no seu Scenery Map e dezenas de alterações mais pequenas: nenhuma delas voltou como uma reconstrução.

O que queremos dizer com arquitetura baseada em componentes

Para nós, a prática começa no design. Um design system é um conjunto de componentes abstratos reutilizáveis (botões, campos, cartões, tabelas, cabeçalhos) e de regras sobre como combiná-los. Quando um designer altera o botão no sistema, todos os ecrãs que o usam mudam com ele, e ninguém tem de abrir 40 ficheiros para fazer a atualização à mão.

No código, a mesma ideia de desenvolvimento de software modular vai muito além das partes visíveis: a forma como a aplicação obtém dados é uma “parte”, a forma como guarda as preferências de um utilizador é outra. No projeto descrito abaixo, as regras para instalar um add-on num simulador de voo são uma parte, uma por simulador, e o resto da aplicação não sabe nem quer saber o que está lá dentro. Cada parte faz uma só tarefa, expõe ao resto uma superfície pequena e acordada, e pode ser alterada ou substituída sem que as outras deem por isso. A disciplina tem de sobreviver à pressão dos prazos, e é por isso que as nossas revisões de código perguntam onde vive uma peça de lógica e não apenas se funciona.

Nada disto é uma tendência recente: David Parnas escreveu em 1972 que um sistema deve ser dividido segundo as decisões com maior probabilidade de mudar, com cada decisão escondida dentro do seu próprio módulo. Robert Glass resumiu décadas de dados da indústria em 2001 e concluiu que a manutenção representa entre 40 e 80 por cento do que o software custa ao longo da sua vida, a maior parte em melhorias e não em correção de erros. A maior parte daquilo que um cliente vai pagar acontece depois do lançamento, e a forma do código original decide quanto.

simMarket, o início

Em 2020, a simFlight pediu-nos para transformar a simMarket, a sua loja online de add-ons de simulação de voo com vinte anos, numa aplicação desktop que pudesse também instalar os add-ons que vendia. Começámos por um design system, e não pelos ecrãs, e o código seguiu a mesma ordem. Nas primeiras semanas, o trabalho foi para um componente de ícone, um botão, uma tabela genérica que as páginas de encomendas, tickets, vouchers e downloads iriam todas partilhar, os campos de formulário, um placeholder de carregamento e um cartão de produto. Depois vieram um serviço para comunicar com a API da loja e um módulo de dados para cada área da loja, para que nenhum ecrã alguma vez obtivesse ou tratasse dados por conta própria.

Durante algumas semanas, o desenvolvimento pareceu lento, porque havia muito pouco em que clicar, e este é o único custo real da prática: as primeiras semanas produzem componentes em vez de ecrãs, o que pede alguma confiança a clientes que querem ver resultados imediatos. Depois, os ecrãs chegaram depressa, já que cada um era sobretudo uma montagem de partes que já existiam, e desde então o ritmo nunca abrandou. Seis anos e bem mais de 100 versões depois, a aplicação tem cerca de 150 componentes para cerca de 45 ecrãs. O componente de ícone do primeiro mês é usado em mais de 70 ficheiros e a tabela continua praticamente igual ao que era. Quando a nossa equipa de design mais tarde alargou o mesmo design system à própria loja, a coerência que o cliente notou entre os dois produtos veio de as mesmas partes serem usadas outra vez.

Scenery Map: uma funcionalidade, quatro alterações

No início de 2024 lançámos o Scenery Map, um mapa-mundo onde os utilizadores podem explorar add-ons de cenários por localização, filtrá-los por tipo e simulador e abrir qualquer produto a partir do seu marcador. Foi uma das maiores funcionalidades que a aplicação tinha lançado, e a maior parte do trabalho foi para o que era novo: dados geográficos, agrupamento de marcadores e lógica de filtros. As partes viradas para o produto, como o popup com o nome, o preço, os selos e a classificação de um produto, eram componentes que a página de produto e o catálogo já usavam, por isso o tempo da equipa foi para os problemas novos.

Depois, o mapa começou a mudar. Sete meses após o lançamento, o cliente quis que cada página de produto mostrasse onde esse produto fica, por isso uma versão mais pequena do mapa passou para a página de produto, com uma ligação de volta para o mapa completo. Quando a Microsoft lançou uma nova versão do seu simulador em novembro de 2024, foi acrescentado ao mapa um filtro para ela, numa alteração que adicionou 24 linhas em 8 ficheiros. Em 2025, os utilizadores pediram para filtrar por mais de um simulador de cada vez, o que se tornou uma alteração ao seletor e ao tratamento dos seus dados em 7 ficheiros, e seguiu-se um pedido de um filtro “em promoção” em 12 ficheiros com apenas 72 linhas adicionadas. Nenhuma destas alterações reabriu o núcleo do mapa, porque cada uma foi um acréscimo a uma parte que tinha sido feita para aceitar acréscimos.

Checkout rápido: uma nova forma de comprar

No final de 2025, o cliente quis um checkout rápido, uma forma prática de um cliente comprar um produto num só passo a partir de onde quer que o veja, sem passar pelo carrinho. Numa base de código organizada por páginas, este é o tipo de pedido que mexe em tudo, porque “onde quer que o veja” significa a página de produto, o catálogo, as listas de mais vendidos, a lista de desejos, o popup do mapa, todo o lado.

Primeiro separámos o fluxo de checkout existente num componente próprio, para que o checkout normal e o novo checkout rápido executassem os mesmos passos, e o módulo de pagamento nem sequer foi tocado. Depois escrevemos um único botão de checkout rápido e colocámo-lo na página de produto (um acréscimo cobre três posições), no cartão de produto (que o leva a todas as listas) e no popup do mapa feito quase dois anos antes, que só precisou de receber o botão. Um único modal envolveu o fluxo existente para o caso de um só passo e é reutilizado em todas estas posições.

Porque é que isto importa para os clientes

O efeito prático para um cliente é que os orçamentos tendem a manter-se proporcionais ao pedido. Um novo filtro é um trabalho do tamanho de um filtro e uma nova forma de comprar é um trabalho do tamanho de um checkout, em vez de cada alteração carregar o custo escondido das páginas a que é acrescentada. É também o que torna possíveis os nossos preços fixos: já escrevemos noutro artigo sobre porque preferimos trabalhar a preço fixo em vez de faturar à hora, e só conseguimos manter um preço fixo porque as alterações ficam contidas. Se cada pedido arriscasse uma reconstrução, não teríamos outra opção senão faturar à hora.

Estes efeitos são ampliados por ser a mesma equipa a desenhar e a desenvolver aqui, sem passagem de testemunho entre as duas. As partes no ficheiro de design e as partes no código têm os mesmos nomes e os mesmos limites, por isso uma conversa sobre alterar uma delas é a mesma conversa nos dois lados.

Os componentes não tornam todas as alterações gratuitas, e um produto que continua a crescer vai precisar, por vezes, de uma alteração grande. Quando passámos a aplicação para uma nova versão principal da sua framework em 2023, quase todos os componentes tiveram de ser mexidos. O que fazem é manter essas alterações raras e, acima de tudo, manter as pequenas pequenas, para que o orçamento vá para o crescimento do produto e não para reconstruir o mesmo terreno.

A simMarket começou em 2020 como uma aplicação desktop. As mesmas partes levaram-na desde então a uma plataforma de vendedores, onde os criadores que vendem na loja gerem os seus produtos, e ao redesign da própria loja.

Se isto lhe parece bem e quer que o desenvolvimento do seu produto seja planeado para nunca precisar de uma reconstrução, fale connosco sobre o seu projeto.

Perguntas frequentes

O que é a arquitetura baseada em componentes, em termos simples?

É uma forma de construir software como um conjunto de partes independentes, cada uma com uma só tarefa e uma forma pequena e acordada de comunicar com as outras, para que um produto seja montado a partir de partes em vez de escrito página a página.

Porque é que a arquitetura do código importa para o software de uma pequena empresa?

Porque uma pequena empresa raramente tem orçamento para uma segunda versão. A maior parte do que o software custa é gasta depois do lançamento, em alterações e não em correção de erros, e a arquitetura decide se cada alteração custa o tamanho do pedido ou o tamanho do produto. Partes bem separadas também permitem que uma equipa pequena mantenha o produto a avançar durante anos, e essa é a diferença entre software que cresce com a empresa e software que é substituído.

Desenvolver com componentes é mais lento ou mais caro no início?

Ligeiramente, nas primeiras semanas, porque as primeiras partes levam tempo antes de haver ecrãs para mostrar. Depois disso, os ecrãs são sobretudo montados a partir de partes que já existem, por isso o ritmo acelera, e cada alteração após o lançamento fica mais barata a partir daí.

Quão pequena pode ser uma alteração depois do lançamento?

Na simMarket, substituir o scroll infinito do catálogo por páginas numeradas em 2026 alterou 4 ficheiros. Ativar ou desativar o instalador para cada simulador é controlado por uma única definição que 3 componentes leem. Remover uma secção do ecrã inicial são 2–5 linhas de código.

O que acontece quando a alteração vem de fora?

Essas são as alterações para as quais não é possível planear, e tendem a atingir as partes escondidas de um produto. Quando a Microsoft lançou uma nova versão do seu simulador em novembro de 2024, suportá-la significou acrescentar uma versão às regras do simulador, uma segunda pasta de instalação nas definições, e um selo e um filtro no mapa onde os produtos aparecem. A versão ficou pronta no dia de lançamento do simulador. O trabalho ocupou as semanas anteriores e o resto da aplicação não precisou de saber dele.

Isto aplica-se a websites, ou só a aplicações à medida?

A ambos. Os nossos websites em Framer são feitos com componentes reutilizáveis pela mesma razão, por isso alterar um atualiza todas as páginas que o usam, e o retorno chega dentro do próprio projeto e não anos depois. Partilhar o mesmo design system entre a aplicação e a loja da simMarket é a mesma ideia aplicada a estes dois tipos de produto.

Como decidem o que se torna um componente?

Perguntamos o que tem maior probabilidade de mudar ou de ser reutilizado. Uma decisão que outra pessoa controla, como a forma como um simulador espera receber os seus ficheiros, recebe um limite à sua volta, tal como tudo o que é usado em mais do que um sítio. O que evitamos é abstrair logo na primeira utilização, antes de uma segunda utilização mostrar o que a parte realmente é.

A arquitetura baseada em componentes é o mesmo que microsserviços?

Não. Os microsserviços dividem um sistema em serviços implementados separadamente, o que traz o seu próprio custo operacional. A arquitetura baseada em componentes divide o código dentro de um só produto em partes com limites claros. A simMarket é uma única aplicação com uma única implementação, e os componentes vivem dentro dela.

Escrito por Francisco Lopes, programador na Concealed — uma agência Framer Expert sediada em Lisboa que cria websites rápidos e escaláveis e ferramentas internas à medida para empresas.