bfiguei's picture
Update src/main.py
7fb4944 verified
"""
Aplicação Streamlit para visualizar dados, treinar modelos
e avaliar a previsão de reclamações de clientes.
"""
import argparse
import logging
from typing import List
import matplotlib.pyplot as plt
import pandas as pd
import seaborn as sns
import streamlit as st
from utils import (
carregar_dados,
preparar_base,
treinar_modelo,
avaliar_modelo,
calcular_curva_roc,
obter_importancias,
)
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
def interpretar_importancias(df_imp: pd.DataFrame, top_n: int = 3) -> str:
"""
Gera um texto simples de interpretação com base nas variáveis mais importantes.
Parâmetros:
df_imp: DataFrame com colunas 'Variavel' e 'Importancia'.
top_n: número de variáveis a destacar.
Retorno:
Texto em português com interpretação básica.
"""
if df_imp.empty:
return "Não foi possível identificar variáveis importantes para este modelo."
top_vars: List[str] = df_imp.head(top_n)["Variavel"].tolist()
texto = (
"Com base nas importâncias do modelo, as variáveis mais relevantes para "
"prever reclamações foram: "
+ ", ".join(top_vars)
+ ". Isso indica que clientes com perfis associados a essas variáveis "
"tendem a ter maior probabilidade de registrar insatisfações e devem "
"ser priorizados em ações de atendimento preventivo."
)
return texto
def executar_dashboard() -> None:
"""
Executa a interface Streamlit do dashboard.
Observação:
Esta função é chamada quando o script é rodado via 'streamlit run'.
"""
st.set_page_config(page_title="Tarefa 4 - Reclamações", layout="wide")
st.title("Dashboard - Previsão de Reclamações de Clientes")
st.sidebar.header("Configurações")
st.sidebar.write("Carregue a base `marketing_campaign.csv` e selecione as opções.")
arquivo = st.sidebar.file_uploader(
"Selecione o arquivo CSV", type=["csv"], help="Use a base marketing_campaign.csv"
)
aplicar_smote = st.sidebar.checkbox(
"Aplicar SMOTE (balancear classes)", value=True
)
nome_modelo = st.sidebar.selectbox(
"Escolha o modelo",
["Regressão Logística", "Random Forest", "LightGBM"],
)
if arquivo is None:
st.info("Faça o upload do arquivo CSV para iniciar a análise.")
return
try:
df = carregar_dados(arquivo)
except Exception as exc:
st.error(f"Erro ao carregar dados: {exc}")
return
st.subheader("Pré-visualização dos dados")
st.dataframe(df.head())
# Filtros simples por estado civil e educação, se existirem
filtros = {}
if "Marital_Status" in df.columns:
opcoes_ms = ["(Todos)"] + sorted(df["Marital_Status"].dropna().unique().tolist())
escolha_ms = st.selectbox("Filtrar por estado civil", opcoes_ms)
if escolha_ms != "(Todos)":
filtros["Marital_Status"] = escolha_ms
if "Education" in df.columns:
opcoes_ed = ["(Todos)"] + sorted(df["Education"].dropna().unique().tolist())
escolha_ed = st.selectbox("Filtrar por nível educacional", opcoes_ed)
if escolha_ed != "(Todos)":
filtros["Education"] = escolha_ed
df_filtrado = df.copy()
for coluna, valor in filtros.items():
df_filtrado = df_filtrado[df_filtrado[coluna] == valor]
st.write(f"Linhas após filtros: {df_filtrado.shape[0]}")
st.dataframe(df_filtrado.head())
# Preparar base (usando df_filtrado se não ficar muito pequeno)
try:
df_para_modelo = df_filtrado if df_filtrado.shape[0] > 50 else df
X_train, X_test, y_train, y_test, feature_names, scaler = preparar_base(
df_para_modelo, aplicar_smote=aplicar_smote
)
except Exception as exc:
st.error(f"Erro ao preparar dados: {exc}")
return
# Seleção dinâmica de variáveis
st.subheader("Seleção de variáveis")
features_selecionadas = st.multiselect(
"Selecione as variáveis explicativas para o modelo",
feature_names,
default=feature_names,
)
if not features_selecionadas:
st.warning("Selecione ao menos uma variável para treinar o modelo.")
return
# Precisamos descobrir os índices das features selecionadas
indices = [feature_names.index(f) for f in features_selecionadas]
X_train_sel = X_train[:, indices]
X_test_sel = X_test[:, indices]
# Treinar modelo
st.subheader("Treinamento e avaliação do modelo")
if st.button("Treinar modelo e calcular métricas"):
try:
modelo = treinar_modelo(nome_modelo, X_train_sel, y_train)
except Exception as exc:
st.error(f"Erro ao treinar modelo: {exc}")
return
# Métricas
metricas = avaliar_modelo(modelo, X_test_sel, y_test)
st.write("**Métricas de desempenho:**")
st.table(pd.DataFrame([metricas]))
# Curva ROC
fpr, tpr, auc = calcular_curva_roc(modelo, X_test_sel, y_test)
fig, ax = plt.subplots(figsize=(6, 4))
ax.plot(fpr, tpr, label=f"AUC = {auc:.3f}")
ax.plot([0, 1], [0, 1], linestyle="--", color="gray")
ax.set_xlabel("False Positive Rate")
ax.set_ylabel("True Positive Rate")
ax.set_title("Curva ROC")
ax.legend()
st.pyplot(fig)
# Matriz de confusão
st.write("**Matriz de confusão:**")
from sklearn.metrics import confusion_matrix
y_pred = modelo.predict(X_test_sel)
cm = confusion_matrix(y_test, y_pred)
fig2, ax2 = plt.subplots(figsize=(4, 3))
sns.heatmap(cm, annot=True, fmt="d", cmap="Blues", cbar=False, ax=ax2)
ax2.set_xlabel("Previsto")
ax2.set_ylabel("Real")
st.pyplot(fig2)
# Importância de variáveis
df_imp = obter_importancias(modelo, features_selecionadas)
st.write("**Importância das variáveis:**")
st.dataframe(df_imp.head(15))
fig3, ax3 = plt.subplots(figsize=(8, 5))
sns.barplot(data=df_imp.head(10), x="Importancia", y="Variavel", ax=ax3)
ax3.set_title("Top variáveis mais importantes")
st.pyplot(fig3)
# Interpretação automática
st.subheader("Interpretação automática")
texto_interpretacao = interpretar_importancias(df_imp)
st.write(texto_interpretacao)
def processar() -> None:
"""
Função principal de processamento para uso via linha de comando.
Observação:
Aqui apenas exibimos uma mensagem orientando a usar o Streamlit.
"""
print(
"Este projeto foi feito para rodar via Streamlit.\n"
"Use o comando:\n"
" streamlit run src/main.py\n"
)
def main() -> None:
"""
Ponto de entrada para a linha de comando com argparse.
Exemplos:
python -m src.main --modo cli
"""
parser = argparse.ArgumentParser(
description="Dashboard de previsão de reclamações."
)
parser.add_argument(
"--modo",
type=str,
default="cli",
help="Modo de execução: 'cli' apenas imprime instruções.",
)
args = parser.parse_args()
if args.modo == "cli":
processar()
else:
print("Erro: modo inválido. Use '--modo cli'.")
if __name__ == "__main__":
main()