Marketplace B2B para o ecossistema de arquitetura

O InterArq Hub é um marketplace B2B que conecta os diferentes atores do ecossistema de arquitetura e decoração: empresas, associações de classe, profissionais e lojistas, numa única plataforma de relacionamento e pontos. A MVP Plus construiu a plataforma completa, do modelo de papéis à infraestrutura de convite de usuário.

O desafio

Um marketplace com quatro tipos de usuário diferentes, empresa, associação, profissional e lojista, enfrenta um problema de modelagem que um produto de papel único não tem: cada tipo de conta precisa de permissão, fluxo de cadastro e tela própria, mas todos compartilham a mesma base de dados e, em vários pontos, interagem entre si dentro da plataforma. Errar essa modelagem cedo significa remodelar permissão e dado depois, com o sistema já em uso pelos primeiros usuários.

Outro ponto que qualquer marketplace multi-papel enfrenta é a entrada de novo usuário: alguém de dentro da plataforma, uma associação, por exemplo, precisa conseguir convidar um profissional ou uma empresa parceira para entrar, sem que isso vire um cadastro manual feito por trás dos panos por quem administra o sistema.

O que construímos

A plataforma organiza o ecossistema em torno de campanhas, pontos e relacionamento entre os quatro papéis de usuário. Cada tipo de conta, empresa, associação, profissional, lojista, tem sua própria área dentro do produto, com permissão e visão de dado adequada ao papel. O fluxo de entrada de novo usuário é resolvido por convite: uma conta já existente convida outra por e-mail, e a aceitação do convite cria a conta já vinculada ao papel e ao relacionamento corretos.

A engenharia por trás

O convite por e-mail é implementado como um conjunto de edge functions dedicadas no Supabase, uma para convidar usuário de associação, outra para empresa e outra para profissional, cada uma com a regra de permissão específica de quem pode convidar quem. O envio do e-mail em si passa por uma camada de abstração de provedor, que permite trocar entre Resend e Brevo sem reescrever a lógica de convite, decisão de engenharia que evita acoplar o fluxo de convite a um fornecedor específico de e-mail transacional.

O projeto tem uma suíte de testes ampla, com mais de vinte e cinco arquivos de teste cobrindo os fluxos principais da aplicação, o tipo de cobertura que se justifica justamente pela quantidade de combinações possíveis entre papel de usuário, permissão e ação dentro da plataforma.

Stack e decisões

Vite com TypeScript e componentes shadcn/ui no front, Supabase cobrindo autenticação, banco e as edge functions de convite no back, formam a stack. A escolha de shadcn/ui para os componentes de interface encaixa bem num produto com várias áreas de usuário diferentes, porque acelera a construção de tela nova mantendo consistência visual entre elas sem reescrever componente do zero a cada novo papel.

Isolar o convite de usuário em edge functions separadas por papel, em vez de uma única função genérica, foi uma decisão que prioriza clareza de permissão sobre economia de código: fica explícito, olhando o próprio nome da function, quem pode convidar quem dentro da plataforma.

Marketplaces com múltiplos papéis de usuário tendem a crescer em complexidade de permissão a cada novo tipo de conta, e esse é o tipo de evolução contínua que o Vibe Squad da MVP Plus acompanha. Para saber mais sobre como planejar um MVP com papéis de usuário diferentes desde o início, veja o artigo sobre como criar um MVP com Vibe Coding.