Module API Reference

import pandas as pd

def cargar_inventario(ruta: str) -> pd.DataFrame:
    """
    Carga el archivo de inventario desde Excel.
    """
    try:
        df = pd.read_excel(ruta)
        print("✅ Inventario cargado correctamente")
        return df
    except Exception as e:
        print(f"❌ Error al cargar inventario: {e}")
        raise

import pandas as pd

def clasificacion_abc(df: pd.DataFrame) -> pd.DataFrame:
    """
    Clasifica productos según el método ABC usando ventas mensuales.
    """
    df = df.copy()

    # Ordenar por ventas
    df = df.sort_values(by="ventas_mensuales", ascending=False)

    # Total de ventas
    total_ventas = df["ventas_mensuales"].sum()

    # Porcentaje acumulado
    df["porcentaje_acumulado"] = df["ventas_mensuales"].cumsum() / total_ventas

    # Clasificación ABC
    def asignar_categoria(p):
        if p <= 0.7:
            return "A"
        elif p <= 0.9:
            return "B"
        else:
            return "C"

    df["categoria_abc"] = df["porcentaje_acumulado"].apply(asignar_categoria)

    print("✅ Clasificación ABC aplicada")
    return df

import pandas as pd

def evaluar_riesgo_y_reposicion(df: pd.DataFrame) -> pd.DataFrame:
    """
    Evalúa el estado del inventario y genera recomendaciones automáticas.
    """
    df = df.copy()

    # Estado de stock
    def estado_stock(row):
        if row["stock_actual"] <= row["stock_minimo"]:
            return "CRITICO"
        elif row["stock_actual"] <= row["stock_minimo"] * 1.2:
            return "RIESGO"
        else:
            return "OK"

    df["estado_stock"] = df.apply(estado_stock, axis=1)

    # Recomendación de reposición
    def recomendar_reposicion(row):
        if row["estado_stock"] in ["CRITICO", "RIESGO"]:
            return max(row["ventas_mensuales"] - row["stock_actual"], 0)
        return 0

    df["reponer_cantidad"] = df.apply(recomendar_reposicion, axis=1)

    print("✅ Riesgo evaluado y reposición recomendada")
    return df

import pandas as pd
from openpyxl import load_workbook
from openpyxl.styles import Alignment

def generar_reporte_excel(df: pd.DataFrame, ruta_salida: str):
    with pd.ExcelWriter(ruta_salida, engine="openpyxl") as writer:
        df.to_excel(writer, sheet_name="Inventario_Completo", index=False)

        criticos = df[df["estado_stock"] == "CRITICO"]
        criticos.to_excel(writer, sheet_name="Productos_Criticos", index=False)

        riesgo = df[df["estado_stock"] == "RIESGO"]
        riesgo.to_excel(writer, sheet_name="Productos_En_Riesgo", index=False)

    wb = load_workbook(ruta_salida)
    for ws in wb.worksheets:
        for col in ws.columns:
            max_length = 0
            column = col[0].column_letter
            for cell in col:
                # Ajustar ancho
                if cell.value:
                    max_length = max(max_length, len(str(cell.value)))
                # Centrar contenido
                cell.alignment = Alignment(horizontal="center", vertical="center")
            ws.column_dimensions[column].width = max_length + 2

    wb.save(ruta_salida)
    print(f"✅ Reporte Excel generado en {ruta_salida}")

import os
import matplotlib.pyplot as plt
import pandas as pd

def generar_graficos(df: pd.DataFrame, carpeta_salida: str):
    os.makedirs(carpeta_salida, exist_ok=True)

    # ---- Gráfico 1: Estado del stock ----
    estado_counts = df["estado_stock"].value_counts()

    plt.figure()
    estado_counts.plot(kind="bar")
    plt.title("Estado del Inventario")
    plt.xlabel("Estado")
    plt.ylabel("Cantidad de Productos")
    plt.tight_layout()
    plt.savefig(os.path.join(carpeta_salida, "estado_inventario.png"))
    plt.close()

    # ---- Gráfico 2: Clasificación ABC ----
    abc_counts = df["categoria_abc"].value_counts()

    plt.figure()
    abc_counts.plot(kind="pie", autopct="%1.1f%%")
    plt.title("Clasificación ABC del Inventario")
    plt.ylabel("")
    plt.tight_layout()
    plt.savefig(os.path.join(carpeta_salida, "clasificacion_abc.png"))
    plt.close()

    print("✅ Gráficos generados correctamente")

import smtplib
from email.message import EmailMessage
import os

def enviar_reporte(
    remitente: str,
    password: str,
    destinatario: str,
    ruta_excel: str,
):
    mensaje = EmailMessage()
    mensaje["Subject"] = "📦 Reporte Automático de Inventario"
    mensaje["From"] = remitente
    mensaje["To"] = destinatario

    mensaje.set_content(
        "Este correo fue generado automáticamente.\n"
        "Se adjunta el reporte actualizado de inventario con alertas y recomendaciones."
    )

    with open(ruta_excel, "rb") as f:
        mensaje.add_attachment(
            f.read(),
            maintype="application",
            subtype="octet-stream",
            filename=os.path.basename(ruta_excel),
        )

    with smtplib.SMTP_SSL("smtp.gmail.com", 465) as smtp:
        smtp.login(remitente, password)
        smtp.send_message(mensaje)

    print("✅ Reporte enviado por correo")