Estudo de caso

Rota do Perfume

Lakehouse na Databricks que transforma 10 CSVs de ERP e CRM numa fila semanal de 200 ligações, com o diretor na tela.

Distribuidora fictícia. Dados gerados para o estudo, no formato que aparece em empresa real.

Fila da semana: 200contatos recomendados pelo modelo, para 36 vendedores
Conversão real: 41,7%5 pedidos em 12 ligações já trabalhadas
Ganho sobre o acaso: 4,1x10,1% era a taxa ligando às cegas
Receita esperada: R$ 559 milchance de compra vezes ticket médio

O dado que existe em qualquer empresa

O ponto de partida foram 10 arquivos CSV de ERP e CRM, com mais de 300 mil linhas. Datas em dois formatos na mesma coluna. CNPJ com espaço. Duplicatas. O tipo de sujeira que quebra relatório e, pior, quebra decisão.

A resposta foi um pipeline em camadas (raw, bronze, silver, gold), inteiro como código via Databricks Asset Bundles. Schemas, jobs, dashboard e os espaços do Genie são versionados e sobem no mesmo deploy.

Três decisões que eu defendo

A limpeza não pode mudar o negócio

O faturamento de R$ 102 milhões fecha idêntico da bronze à gold. Testes de qualidade derrubam o pipeline quando algo diverge. A regra é corrigir a transformação, nunca o teste.

Metadado é contrato

Toda coluna que uma IA consulta tem comentário de negócio auditado. Uma tarefa do job falha se faltar um. É isso que faz o Genie responder "quanto vale a fila?" com o número certo e a palavra "estimativa".

Dado vira ação

Um modelo de propensão de compra (scikit-learn e MLflow, lift de 4x sobre uma fila aleatória) alimenta a fila da semana. O time registra o desfecho de cada contato no Databricks App em React. Na primeira semana, a conversão real ficou em 41,7%, contra 41,5% que o modelo previu.

O app que o diretor usa na segunda

Três telas. A semana (quem ligar), o acompanhamento (se o modelo se confirma) e o perguntar (Genie com a permissão do usuário no Unity Catalog).

App Rota do Perfume na aba A semana, com KPIs da fila e a tabela de clientes a ligar — **A semana.** 200 contatos, receita esperada de R$ 559 mil, conversão prevista de 42% contra 10,1% ligando às cegas. A fila traz chance, motivo da ligação, o que oferecer (com estoque) e o registro do desfecho: vendeu, vai pensar, sem interesse, não atendeu.

Aba Acompanhamento com conversão real de 41,7% contra 41,5% prevista pelo modelo e 10,1% ligando às cegas — **O modelo está se confirmando?** 41,7% real, 41,5% previsto, 10,1% baseline. A amostra ainda é pequena (intervalo de confiança de 19,3% a 68,0%). O painel trata o alinhamento como sinal, não como prova fechada.

Gráfico de barras com fila versus ligações trabalhadas por vendedor e tabela de desfecho — **Quem tem carteira grande está trabalhando ela?** Os 12 vendedores com mais contatos na fila, lado a lado com o que já foi ligado. O agrupamento é por ID, não só por nome, para não colidir homônimos.

Aba Perguntar do app, com o Genie listando os cinco próximos clientes a ligar — **Perguntar.** Linguagem natural sobre a fila, o modelo e os clientes. A consulta roda com as permissões do Unity Catalog de quem pergunta. O SQL gerado fica visível para conferência antes de levar o número para a reunião.

Genie no workspace, não só no app

O mesmo contrato de metadado responde fora do app, no espaço Genie do Databricks. A pergunta de negócio vira número conferível.

Genie no Databricks respondendo quantas ligações foram registradas e quantas viraram pedido — **Quantas ligações já foram registradas?** 12 ligações, 5 viraram pedido, 41,67% de conversão, com a distribuição por status (vendeu, não atendeu, vai pensar, sem interesse).

Genie no Databricks mostrando Débora Souza como a vendedora que mais ligou, com 4 chamadas — **Qual vendedor mais ligou até agora?** Débora Souza, com 4 ligações registradas. O gráfico compara com Henrique Oliveira (3). A pergunta de gestão cai no mesmo dado da fila.

Deploy como código, app no ar

O app rotaperfume-direcao sobe via Databricks Asset Bundles. Warehouse serverless, espaço Genie e o React compartilham o mesmo pacote.

Overview do Databricks App rotaperfume-direcao em execução, com warehouse serverless e espaço Genie ligados — **Overview.** App em execução, compute ativo, origem em .bundle. Recursos ligados: SQL Warehouse serverless e o espaço Genie Rota do Perfume - Direção.

Aba Insights do Databricks App com 100% de uptime e zero incidentes nos últimos sete dias — **Insights.** 100% de uptime no período, zero incidentes. Observabilidade do app no mesmo workspace em que o dado vive.

O que vem a seguir

O projeto segue em evolução. Os próximos passos são extrair as transformações para módulos Python testáveis fora do notebook, e migrar o provisionamento da infraestrutura para Terraform, para o mesmo ambiente subir de forma reproduzível em qualquer workspace.

Código no GitHub Voltar aos projetos