Existe um marketplace de bairro rodando em cinco cidades brasileiras: Mauá, Capanema, Vinhedo, Itariri e Palmas. Todas rodam o mesmo commit. O que muda de uma para outra são variáveis de ambiente e o que o administrador salva no painel.
Não começou assim. Começou como o marketplace de uma cidade só. A versão que virou base foi extraída em 6 de agosto de 2026, e de lá até 15 de setembro a plataforma recebeu 104 commits.
A regra que fez a diferença
Uma só, e ela cabe em sete palavras: o código não conhece nenhuma cidade. Nome, estado, domínio, contatos, logotipo e textos legais saem todos da configuração. Não existe um if de cidade em lugar nenhum, e quando aparece a vontade de escrever um, o que está faltando é um campo de configuração.
A segunda regra é de sentido. Toda melhoria nasce na plataforma e depois é levada ao deploy mais antigo, nunca o contrário. Sem isso, em três meses você tem cinco sistemas parecidos e nenhum produto.
O dinheiro não passa por aqui
A decisão mais importante da arquitetura não foi técnica. Cada venda cai direto na conta do vendedor, por uma conexão que ele mesmo autoriza. Não existe comissão, taxa, retenção, repasse nem saque. Sem essa conexão o vendedor simplesmente não vende, porque a cobrança é recusada.
Isso tira da plataforma a obrigação de guardar dinheiro de terceiro, com tudo o que vem junto. Tem um preço visível: o carrinho aceita uma loja por vez, já que um pagamento não pode cair em duas contas. Preferimos explicar essa limitação a administrar repasse.
A dívida que a padronização cobra
Consolidar cinco sistemas num só revela as decisões que nunca foram tomadas. O caso que me marcou: existiam seis definições diferentes de “vendedor com pagamento conectado”, espalhadas pelo código, e elas discordavam entre si. O mesmo vendedor podia aparecer apto numa tela e inapto na seguinte.
Hoje há uma, num arquivo só. Junto com ela saíram, de propósito, o cálculo de taxa, o repasse automático e o saque. Existiam pela metade e ninguém usava.
O que eu diria para quem está no primeiro cliente
Não construa para cinco cidades no dia um. Construa para uma, e mantenha a disciplina de não escrever o nome dela dentro do código. É uma regra barata no começo e muito cara de aplicar depois que o segundo cliente já está no ar.
Precisa resolver isso na sua empresa?
Uma conversa de vinte minutos costuma bastar para saber se faz sentido, e você fala direto com o engenheiro que constrói.