Associado

O problema e as restrições

O Associado existe para formalizar algo que associações de classe já fazem informalmente e de forma inconsistente: um associado pergunta por aí por um encanador, um contador, um fotógrafo, alguém do grupo indica outro associado específico, os dois se conectam, um negócio acontece e, em tese, a associação era devedora de uma pequena comissão por ter feito a apresentação em primeiro lugar. Na prática, essa última parte quase nunca acontece, porque ninguém acompanha quem indicou quem, se deu em algo, ou quanto valeu.

A primeira restrição é que o único fato do qual o modelo de negócio inteiro depende (o negócio de fato fechou, e por quanto) acontece inteiramente fora do software, numa conversa e num aperto de mão entre duas pessoas. A plataforma pode perguntar sobre isso, mas não pode observar diretamente, e está perguntando a duas pessoas sem incentivo simétrico para responder com honestidade: quem teria que pagar uma comissão tem todo motivo para dizer menos que a verdade, enquanto quem não pagaria nada não tem motivo particular para corrigir.

A segunda restrição é a forma do próprio pedido. Associado não digita nome de categoria. Digita “quem conserta um vazamento”, e um sistema que só entende um termo exato de catálogo como “encanador” vai falhar em silêncio no momento em que o vocabulário de alguém não bater com o que foi digitado na lista de categorias. Mas um sistema que responde só por similaridade semântica vaga produz um resultado que ninguém consegue auditar, e a reclamação mais previsível que essa plataforma jamais vai receber é um prestador perguntando por que ele, especificamente, não foi o indicado. O que quer que resolva um pedido precisa ser flexível o bastante para entender linguagem real e preciso o bastante para se explicar numa frase.

A terceira restrição é lidar com dinheiro num sistema cujo mecanismo central é um agente de IA lendo mensagem de WhatsApp sem estrutura. Texto de um associado é exatamente o tipo de entrada que consegue manobrar um modelo de linguagem, de propósito ou não, e a única parte desse sistema que absolutamente não pode ser manobrada é o que é cobrado de quem. A arquitetura construída precisava tornar estruturalmente impossível qualquer coisa que o modelo toque decidir diretamente uma comissão, uma garantia que nenhuma política sozinha entregaria.

A quarta restrição foi evitar um erro específico já vivido de verdade. Uma plataforma irmã (um CRM de WhatsApp já em produção) resolve um problema de forma parecida com uma ferramenta visual de workflow orquestrando dezenas de passos de integração, e essa ferramenta tem um custo real e contínuo: credencial que não transfere entre ambientes, ordem de execução que depende de onde uma caixa está posicionada no canvas em vez de qualquer coisa versionada, e um arquivo de workflow salvo que diverge do que de fato roda. O volume esperado deste projeto é algumas centenas de solicitações por mês para uma associação, bem aquém da escala de SaaS multi-tenant que justificou a complexidade daquele outro sistema. Trazer a mesma arquitetura para cá significaria pagar custo operacional que o tamanho real deste projeto não pede.

A última restrição foi o tempo em si. Uma indicação que nunca expira vira uma comissão devida sobre uma relação comercial da qual a associação parou de fato de fazer parte no momento em que a apresentação virou um arranjo contínuo entre duas pessoas. Um encanador indicado uma vez que passa a fazer a manutenção mensal de um cliente por anos é um resultado real que essa plataforma precisa não interpretar como trinta e seis eventos separados merecedores de comissão.

Arquitetura

Um associado manda uma mensagem de WhatsApp descrevendo o que precisa. Um agente de IA (Claude, usando tool use em vez de geração livre) lê e tenta resolver para uma categoria no catálogo de serviços, primeiro por correspondência exata e trigram contra termos e sinônimos conhecidos, depois, só se isso não resolver com confiança, por busca semântica por vetor sobre os embeddings das categorias. Se nenhum dos dois caminhos resolve de forma limpa, o agente faz uma pergunta de esclarecimento em vez de chutar: uma solicitação não resolvida é registrada como lacuna no catálogo em vez de descartada em silêncio, o que eventualmente é o que diz à associação onde falta um sinônimo ou uma categoria inteira.

Depois que uma categoria resolve, o mesmo agente consulta prestadores que oferecem aquele serviço (filtrado, estruturalmente, só para quem ligou o consentimento de indicação) e devolve uma lista curta ao associado, avisando cada prestador indicado de que foi indicado. Tudo até aqui é trabalho do agente: entender linguagem, casar intenção com um item de catálogo, formatar uma resposta útil. Nada disso toca dinheiro.

Dinheiro vive inteiramente num caminho separado e determinístico ao qual o agente não tem acesso. Dias depois de uma indicação sair, um worker de agendamento (rodando como parte do mesmo processo, sobre uma tabela de banco comum em vez de uma fila de tarefas) manda um acompanhamento ao solicitante e ao prestador, de forma independente, perguntando se o negócio fechou e por quanto. Só quando as duas respostas descrevem o mesmo negócio, dentro de uma pequena tolerância para arredondamento, o backend gera uma comissão automaticamente. Divergência de valor, silêncio de um lado só, ou qualquer ambiguidade não é resolvida com mais automação: vira um item na fila do painel administrativo para uma pessoa olhar, na teoria de que uma cobrança gerada indevidamente custa mais confiança à associação do que uma perdida custa dinheiro.

Essa comissão, uma vez gerada, é limitada no tempo nas duas pontas. Uma solicitação que passa 30 dias sem um fechamento confirmado simplesmente expira. Não existe indicação aberta para sempre. E se o mesmo solicitante e prestador fecham outro negócio na mesma categoria dentro de 90 dias do último, o sistema ainda registra a nova indicação e ainda avisa todo mundo, mas grava o negócio resultante como isento em vez de gerador de comissão, visivelmente, como um registro de valor zero e explicitamente isento, em vez de uma entrada que simplesmente não existe. As duas janelas são valores de configuração em vez de constante fixada na lógica, e as duas são deliberadamente números de primeiro chute que o desenho espera revisar assim que existir dado real de conversão para revisar com ele.