1. Contexto do Negócio
A Módena Móveis é uma rede de varejo de móveis de design autoral contemporâneo de médio-alto padrão, operando com 5 filiais físicas (Pinheiros, Moema, ABC, Santana e Campinas), 13 consultores de vendas ativos e um portfólio de 28 SKUs distribuídos em 5 categorias de produto.
O projeto contemplou a análise estratégica do biênio 2023–2024, consolidando 1.645 transações comerciais auditadas a partir do
arquivo vendas_modena.csv.
A operação envolve múltiplos canais de distribuição (Loja Física, Online e WhatsApp), segmentação
fiscal (PF e PJ) e cinco modalidades de pagamento.
A necessidade central do negócio foi estabelecer uma arquitetura corporativa integrada de
Analytics e IA, capaz de suportar a tomada de decisão executiva C-Level para o
planejamento estratégico de 2025, com travas contábeis rigorosas e governança sobre métricas
sensíveis como valor_final
e análise Like-for-Like (SSS).
2. Objetivos do Projeto
O escopo analítico foi estruturado para responder a 10 perguntas estratégicas de negócio, com rigor metodológico baseado no framework CRISP-DM:
Objetivo Principal
- Construir uma arquitetura integrada de Data Warehouse, Pipeline de Data Science e Assistente Conversacional (RAG) para subsidiar a reunião de planejamento 2025 com os sócios.
Objetivos Específicos
- Auditar a qualidade dos dados (completude, unicidade e consistência aritmética) sobre 1.645 registros transacionais.
-
Detectar e tratar outliers estatísticos via método IQR de Tukey sobre a métrica
valor_final. - Aplicar a metodologia Same-Store Sales (SSS) / Like-for-Like para neutralizar o efeito de base da inauguração de Campinas em julho/2023.
- Implementar modelos preditivos e de clusterização (K-Means, Prophet, Random Forest) para forecasting 2025 e segmentação comportamental.
- Desenvolver um Copilot local com RAG via FAISS e modelo Qwen3:14B executado on-premise via Ollama.
3. Arquitetura da Solução
A arquitetura foi desenhada em camadas, seguindo o fluxo ERP Transacional → ETL Python → SQL Server Data Warehouse → Modelagem Dimensional / Pipeline Data Science → Power BI / Vetorização FAISS → Copilot Local → Tomada de Decisão C-Level.
Fluxo de Processamento
Camada de IA Generativa (Módena Copilot)
O Copilot foi arquitetado em quatro camadas: (i) camada de dados e contexto (PDFs institucionais +
banco ModenaDW); (ii) camada vetorial com chunking via
RecursiveCharacterTextSplitter
(chunk_size=600, overlap=100) e embeddings
sentence-transformers/all-MiniLM-L6-v2
(384 dimensões); (iii) inferência local com Ollama rodando Qwen3:14B na porta 11434
(Temperature=0.1); (iv) conectividade via Tailscale Mesh VPN com túnel WireGuard ponto a ponto
(latência ~3ms).
4. Dados e Modelagem
A base consolidada (vendas_modena.csv)
apresenta janela histórica de 01/01/2023 a 31/12/2024 (24 meses contínuos), com granularidade no
nível de item/pedido individual faturado.
Modelagem Dimensional (Star Schema)
O Data Warehouse ModenaDW foi
estruturado com a tabela fato
dbo.FatoVendas contendo 15
colunas, incluindo chave primária
id_venda (INT PRIMARY KEY)
e índices nonclustered otimizados para consultas analíticas por data e loja.
CREATE TABLE dbo.FatoVendas(
id_venda INT NOT NULL,
data_venda DATE NOT NULL,
loja VARCHAR(50) NOT NULL,
vendedor VARCHAR(100) NOT NULL,
categoria_produto VARCHAR(50) NOT NULL,
produto VARCHAR(100) NOT NULL,
valor_venda DECIMAL(12,2) NOT NULL,
desconto_pct DECIMAL(5,2) NOT NULL,
valor_final DECIMAL(12,2) NOT NULL,
forma_pagamento VARCHAR(30) NOT NULL,
parcelas INT NOT NULL,
canal VARCHAR(30) NOT NULL,
tipo_cliente VARCHAR(2) NOT NULL,
prazo_entrega_dias INT NOT NULL,
status_entrega VARCHAR(30) NOT NULL,
CONSTRAINT PK_FatoVendas PRIMARY KEY CLUSTERED(id_venda)
);
CREATE NONCLUSTERED INDEX IX_FatoVendas_Data_Loja
ON dbo.FatoVendas(data_venda, loja)
INCLUDE(valor_final, categoria_produto, canal, tipo_cliente);
Dicionário de Dados Corporativo
Principais colunas auditadas: valor_venda (preço nominal de
tabela bruto),
desconto_pct (0,00% a
15,00%) e
valor_final (receita líquida
real efetiva — métrica mandatória).
A fórmula de negócio é:
valor_final = valor_venda × (1 −
desconto_pct/100).
5. Principais KPIs e Medidas
Receita Líquida Real
Valor: R$ 4.821.027,69
Baseada exclusivamente em valor_final.
Representa a entrada de caixa efetiva.
Faturamento Bruto de Tabela
Valor: R$ 4.994.880,00
Preço nominal de vitrine, antes de descontos. Utilizado apenas para cálculo da renúncia.
Renúncia Total de Descontos
Valor: R$ 173.852,31 (+3,61% sobre receita líquida)
Medida crítica para avaliar a disciplina comercial da rede.
Ticket Médio Geral
Valor: R$ 2.930,72
Média aritmética acima da mediana (R$ 2.620,00) devido à assimetria positiva (Right-Skewed).
Crescimento YoY Consolidado
Valor: +17,55% (2023 → 2024)
Faturamento 2023: R$ 2.216.071,61 (780 pedidos) | 2024: R$ 2.604.956,08 (865 pedidos).
Prazo Médio de Entrega
Valor: 15,17 dias úteis
Métrica de SLA logístico. Loja Física: 13,39d | Online: 19,75d | Campinas: 23,67d (gargalo).
// Receita Líquida Real Mandatória
Receita Liquida Real = SUM(FatoVendas[valor_final])
// Ticket Médio Real Efetivo
Ticket Medio Real = DIVIDE([Receita Liquida Real], COUNTROWS(FatoVendas), 0)
// Renúncia Total de Descontos em Reais
Total Desconto R$ = SUMX(FatoVendas, FatoVendas[valor_venda] - FatoVendas[valor_final])
// Crescimento Percentual Homólogo (YoY%)
Crescimento YoY% =
VAR _AnoAtual = [Receita Liquida Real]
VAR _AnoAnterior = CALCULATE([Receita Liquida Real], SAMEPERIODLASTYEAR(dCalendario[Date]))
RETURN DIVIDE(_AnoAtual - _AnoAnterior, _AnoAnterior, BLANK())
6. Visão Geral do Dashboard
O dashboard executivo foi estruturado em 8 páginas, cada uma com foco analítico específico:
Perspectivas Integradas
7. Insights de Negócio
Concentração de Receita: As categorias Quarto (R$ 1.737.981,66 — 36,05%) e Sala de Estar (R$ 1.454.013,41 — 30,16%) respondem por 66,21% da receita total.
Performance de Lojas (SSS): A metodologia Like-for-Like revelou que Moéma liderou a expansão orgânica com +31,83% (23S2 vs 24S2), enquanto Campinas apresentou contração de -14,00%. O crescimento bruto YoY de +52,60% em Campinas foi classificado como "efeito de base" devido à inauguração em 02/07/2023.
Ponto de Atenção: O super-outlier ID#942 (Kit Projeto Hotel, R$ 172.396,00) responde sozinho por 3,58% de toda a receita acumulada e distorceu o Ticket Médio PJ de R$ 2.766,82 para R$ 4.229,14.
8. Perspectiva Contábil e Financeira
Sob a ótica da contabilidade gerencial, o uso indevido de valor_venda
(preço bruto de tabela) violaria as normas contábeis ao superestimar o faturamento real em
R$ 173.852,31.
A disciplina de faturamento foi tratada como mandatória: todas as medidas DAX e Views SQL
Server foram restringidas a valor_final,
garantindo aderência ao princípio da competência efetiva.
A renúncia total de descontos (R$ 173.852,31) representa uma alíquota de 3,61% sobre a receita líquida, sinalizando oportunidade de travas comerciais parametrizadas por nível hierárquico.
9. Perspectiva Jurídica, Risco e Compliance
O projeto incorpora travas de governança explícitas no System Prompt do Copilot e nas Views do Data Warehouse, impedindo que métricas financeiras oficiais sejam calculadas a partir de preços brutos. A segmentação fiscal (PF: 92,95% das vendas | PJ: 7,05%) foi preservada para análises tributárias.
Riscos identificados: (i) dependência estrutural da filial Pinheiros (33,26% do faturamento); (ii) concentração de receitas em consultores líderes (Henrique Dias responde por 52% de Campinas); (iii) inadimplência potencial em contratos PJ a prazo.
Esta análise possui caráter exclusivamente informativo e não substitui aconselhamento jurídico ou tributário especializado.
10. Decisões Técnicas e Justificativas
Decisão 1: Uso Exclusivo de valor_final como Métrica Mandatória
Contexto: A base contém tanto o preço de tabela (valor_venda) quanto a receita líquida efetiva (valor_final).
Justificativa: Utilizar valor_venda violaria normas contábeis gerenciais ao superestimar o faturamento real.
Benefícios: Aderência ao princípio da competência e integridade fiscal.
Limitações: Exige disciplina de modelagem em SQL Server (Views) e DAX para evitar métricas concorrentes.
Impacto Técnico: Travas implementadas em todas as medidas DAX e System Prompt do RAG.
Decisão 2: Metodologia Same-Store Sales (SSS) para Campinas
Contexto: A filial de Campinas foi inaugurada em 02/07/2023, gerando apenas 6 meses de faturamento em 2023.
Justificativa: O crescimento bruto anual YoY (+52,60%) criaria falsa percepção de expansão líder.
Benefícios: Neutraliza o efeito de base e revela a real performance orgânica (-14,00% no 2º semestre comparável).
Limitações: Perda de 6 meses de histórico da unidade para análise comparativa.
Impacto Técnico: Implementado via CTEs SQL e variáveis DAX filtrando semestre ≥ 7.
Decisão 3: Manutenção do Super-Outlier ID#942 no Faturamento Oficial
Contexto: Venda corporativa de R$ 172.396,00 (Kit Projeto Hotel) é outlier estatístico pelo método IQR de Tukey.
Justificativa: Operação comercial legítima e faturada, compondo a receita real da empresa.
Benefícios: Preserva integridade contábil; filtro id_venda ≠ 942 usado apenas para análise de sensibilidade.
Limitações: Exige divulgação de análise de sensibilidade para explicar distorção sazonal de março/2024.
Impacto Técnico: Dual-layer analítica: cenário oficial e cenário expurgado.
Decisão 4: Processamento Local de IA (On-Premise)
Contexto: Dados transacionais sensíveis de clientes PF e PJ.
Justificativa: Reduzir exposição de dados e garantir conformidade com LGPD.
Benefícios: Ollama + Qwen3:14B executado localmente; túnel WireGuard via Tailscale com 3ms de latência.
Impacto Técnico: Frontend Streamlit em PWA Standalone Mode com conectividade Mesh VPN.
11. Qualidade dos Dados e Limitações
Auditoria de Qualidade
- ✓ Completude: zero valores ausentes (nulls) em todas as 15 colunas.
- ✓ Unicidade: 1.645 chaves primárias exclusivas (duplicadas = 0).
- ✓ Consistência aritmética: 100% das linhas satisfazem |valor_final − (valor_venda × (1 − desconto_pct/100))| ≤ 0,01.
Limitações Identificadas
- ⚠ Histórico parcial de Campinas em 2023 (inauguração em 02/07/2023).
- ⚠ Base não possui dados de CAC e ROAS para avaliar canais digitais.
- ⚠ Ausência de dados demográficos externos para inferir poder aquisitivo.
- ⚠ Causas de atraso de entrega são hipóteses operacionais (não constam na base transacional).
Distribuição estatística: A média aritmética (R$ 2.930,72) situa-se acima da mediana (R$ 2.620,00) devido à assimetria positiva (Right-Skewed) provocada por transações corporativas de alto valor monetário. Desvio padrão de R$ 4.463,26 sobre valor_final indica alta dispersão.
12. Performance e Escalabilidade
A base atual contém 1.645 registros transacionais, volume classificado como "small data" no contexto corporativo. As estratégias de otimização implementadas incluem:
- Índices nonclustered em (data_venda, loja) com INCLUDE de valor_final, categoria_produto, canal e tipo_cliente.
- Stored Procedures parametrizadas para detecção automatizada de outliers (IQR de Tukey com multiplicador configurável).
- Vetorização FAISS em disco com busca por similaridade de cosseno (384 dimensões) para embeddings de documentos institucionais.
A arquitetura suporta escala horizontal via Tailscale Mesh VPN para múltiplas filiais e expansão natural do volume transacional.
13. Resultados e Impacto
Os resultados observáveis do projeto incluem:
Auditoria Completa
1.645 transações auditadas com 100% de consistência aritmética validada.
8 Páginas Executivas
Dashboard Power BI de produção cobrindo todas as dimensões estratégicas do negócio.
Copilot Local RAG
Assistente conversacional com Qwen3:14B on-premise para consulta natural em linguagem natural.
Simulação Prescritiva de Cenários para 2025
| Cenário Estratégico | Receita Projetada 2025 | Impacto Líquido |
|---|---|---|
| 1. Trava de Descontos no ERP | R$ 2.678.300,00 | +R$ 76.300,00 |
| 2. Expansão WhatsApp + IA | R$ 2.693.700,00 | +R$ 91.700,00 |
| 3. Reestruturação em Campinas | R$ 2.644.500,00 | +R$ 42.500,00 |
| 4. Módena Corporate (PJ) | R$ 2.749.000,00 | +R$ 147.000,00 |
| 5. Comissionamento por Margem | R$ 2.758.100,00 | +R$ 156.100,00 |
14. Destaques de Engenharia
Travas Contábeis Sistêmicas
Contexto: Prevenir uso indevido de valor_venda em qualquer camada analítica.
Tecnologias: Views SQL Server, DAX measures e System Prompt do Copilot.
Impacto: Governança unificada em 3 camadas (DB, BI, IA) garantindo integridade contábil.
RAG Local com FAISS + Qwen3:14B
Contexto: Consultas em linguagem natural sobre dados sensíveis sem exposição em cloud.
Tecnologias: FAISS, sentence-transformers/all-MiniLM-L6-v2, Ollama, Tailscale VPN.
Impacto: Copilot on-premise com latência ~3ms e embeddings de 384 dimensões.
Pipeline Multi-Modelo (CRISP-DM)
Contexto: Responder 10 perguntas estratégicas com rigor metodológico.
Tecnologias: K-Means (k=3), Prophet (forecast 2025-Q1), Random Forest (driver analysis).
Impacto: Clusterização de consultores, forecasting sazonal e análise de features não-lineares.
Detecção Estatística de Outliers (IQR)
Contexto: Identificar anomalias sem enviesar o faturamento oficial.
Tecnologias: Stored Procedure SQL Server com PERCENTILE_CONT e multiplicador parametrizável (1.5).
Impacto: 8 outliers identificados (Limite Superior = R$ 7.225,00) com análise de sensibilidade dedicada.
15. Código e Fórmulas
Detecção de Outliers (SQL Server)
CREATE OR ALTER PROCEDURE dbo.sp_DetectarOutliersFaturamento
@MultiplicadorIQR DECIMAL(4,2) = 1.5
AS
BEGIN
SET NOCOUNT ON;
WITH Quartis AS (
SELECT
PERCENTILE_CONT(0.25) WITHIN GROUP (ORDER BY valor_final) OVER() AS Q1,
PERCENTILE_CONT(0.75) WITHIN GROUP (ORDER BY valor_final) OVER() AS Q3
FROM dbo.FatoVendas
),
Limites AS (
SELECT DISTINCT Q1, Q3,
(Q3 - Q1) AS IQR,
(Q3 + (@MultiplicadorIQR * (Q3 - Q1))) AS LimiteSuperior
FROM Quartis
)
SELECT v.id_venda, v.loja, v.valor_final, l.LimiteSuperior
FROM dbo.FatoVendas v CROSS JOIN Limites l
WHERE v.valor_final > l.LimiteSuperior;
END;
Pipeline Python (K-Means + Prophet + Random Forest)
# Clusterização Comportamental de Consultores (K-Means k=3)
scaler = StandardScaler()
X_vend = scaler.fit_transform(vendedores_df[['Receita_Total','Ticket_Medio','Volume_Vendas','Desconto_Medio']])
kmeans = KMeans(n_clusters=3, random_state=42, n_init=10)
vendedores_df['Cluster'] = kmeans.fit_predict(X_vend)
# Forecasting Preditivo de Demanda para 2025-Q1 (Prophet)
df_prophet = df.groupby('data')['valor_final'].sum().reset_index()
m = Prophet(yearly_seasonality=True, weekly_seasonality=True, interval_width=0.95)
m.fit(df_prophet.rename(columns={'data':'ds','valor_final':'y'}))
future = m.make_future_dataframe(periods=90)
forecast = m.predict(future)
# Driver Analysis (Random Forest Feature Importance)
X_rf = pd.get_dummies(df[['loja','categoria_produto','forma_pagamento','canal','tipo_cliente','desconto_pct']], drop_first=True)
rf = RandomForestRegressor(n_estimators=100, random_state=42).fit(X_rf, df['valor_final'])
System Prompt do Copilot (travas contábeis)
prompt_completo = f"""
REGRAS MANDATÓRIAS DE NEGÓCIO E COMPLIANCE:
1. O Faturamento e o Ticket Médio são calculados EXCLUSIVAMENTE por 'valor_final' (líquido).
2. NUNCA utilize 'valor_venda' (preço de tabela bruto) como faturamento realizado.
3. A expansão de Campinas inaugurou em Julho/2023. Qualquer análise de crescimento DEVE
considerar o critério Like-for-Like / Same-Store Sales (23S2 vs 24S2).
4. O faturamento oficial de 2023 é R$ 2.216.071,61 e de 2024 é R$ 2.604.956,08 (YoY=+17,55%).
CONTEXTO INSTITUCIONAL (FAISS RAG):
{contexto_docs}
PERGUNTA DO DIRETOR:
{pergunta_usuario}
"""
16. Aprendizados e Evoluções Futuras
Lições Técnicas
- • A padronização de métricas mandatórias (valor_final) exige travas em múltiplas camadas.
- • Análises de expansão de filiais devem sempre considerar efeitos de base (SSS/L4L).
- • Modelos Prophet requerem histórico estável e validação prévia (backtesting).
Lições Estratégicas
- • Super-outliers legítimos devem ser mantidos em cenários oficiais, com análise de sensibilidade paralela.
- • Concentração de receita em pessoas-chave configura risco operacional relevante.
- • IA local (on-premise) viabiliza analytics conversacional em setores com dados sensíveis.
Roadmap Evolutivo de Maturidade em IA
17. Conclusão
Este case demonstra uma arquitetura corporativa integrada de Analytics, Data Science e IA Generativa aplicada ao varejo de móveis. Ao combinar rigor metodológico CRISP-DM, travas contábeis em múltiplas camadas (SQL Server, DAX e System Prompt) e processamento local via RAG com Ollama, o projeto entregou uma plataforma analítica capaz de sustentar decisões executivas de alto impacto.
A aplicação da metodologia Same-Store Sales para neutralizar o efeito de base de Campinas, a dual-layer analítica sobre o super-outlier ID#942, e o pipeline multi-modelo (K-Means + Prophet + Random Forest) demonstram como a engenharia de dados, quando ancorada em princípios contábeis e de governança, transforma informação bruta em inteligência estratégica.
O projeto segue em evolução conforme o roadmap de maturidade em IA, com próximos passos voltados à implementação de agentes autônomos para reposição de estoque e compras — avançando do nível 6 (Conversational) para o nível 7 (Autonomous).