SaleShow (Business Inteligence)
Plataforma integral para transformar ventas, compras e inventarios en información accionable. SaleShow combina dashboards, reportes, control de accesos, carga automatizada de datos, alertas multicanal e integración conversacional mediante MCP.
SaleShow
SaleShow es una plataforma de analítica y gestión operativa diseñada para transformar datos de ventas, compras, inventarios, proveedores y sucursales en información clara, accionable y fácil de consultar.
El sistema centraliza indicadores comerciales en dashboards, reportes y módulos administrativos, permitiendo que equipos internos, compradores y proveedores trabajen con mayor visibilidad sobre el estado del negocio.
Además de la aplicación principal, SaleShow cuenta con un ecosistema de servicios complementarios que fortalecen su operación: un procesador de archivos CSV, un servicio de notificaciones multicanal y una capa MCP para consultas asistidas por IA.
El problema
Muchas empresas operan con datos comerciales dispersos en archivos, sistemas externos o reportes manuales. Esto dificulta responder preguntas críticas como:
- ¿Qué productos tienen inventario bajo?
- ¿Qué proveedor tiene mayor participación?
- ¿Cómo se comportan las ventas por sucursal?
- ¿Qué órdenes de compra necesitan seguimiento?
- ¿Qué información debe ver cada usuario o proveedor?
- ¿Cómo detectar y comunicar alertas de inventario a tiempo?
Cuando estos procesos dependen de revisiones manuales, la toma de decisiones se vuelve lenta, reactiva y propensa a errores.
La solución
SaleShow centraliza datos operativos y los convierte en una plataforma web de análisis, administración y automatización.
La solución permite visualizar ventas, inventarios, compras, promociones y proveedores desde un solo lugar. También controla permisos por usuario, registra importaciones de datos, gestiona proveedores y habilita flujos automatizados para mantener la información actualizada y enviar alertas cuando existen productos críticos.
Ecosistema SaleShow
Aunque SaleShow se presenta como un solo producto, internamente está compuesto por varios componentes que trabajan juntos.
| Componente | Rol dentro del ecosistema |
|---|---|
| SaleShow App | Aplicación principal para dashboards, reportes, usuarios, proveedores, permisos, importaciones y suscripciones. |
| Saleshow Uploader | Servicio auxiliar para detectar, validar, procesar e insertar archivos CSV en la base de datos. |
| Saleshow Sender | Servicio de notificaciones para enviar alertas de inventario por email, SMS y WhatsApp. |
| Saleshow MCP | Servidor MCP que permite consultar inventario, productos críticos, sucursales y clasificaciones desde asistentes compatibles con IA. |
Aplicación principal
La aplicación principal de SaleShow está construida como una plataforma web para analizar y administrar la operación comercial.
Sus módulos principales incluyen:
| Módulo | Descripción |
|---|---|
| Dashboard | Vista principal de indicadores y métricas del negocio. |
| Participación | Análisis de participación de proveedores y evolución comercial. |
| Sellout | Consulta de ventas a usuarios finales y rendimiento de productos. |
| Promociones | Gestión y análisis de promociones y descuentos. |
| Órdenes de compra | Seguimiento de compras y relación con proveedores. |
| Stock de productos | Monitoreo de inventario disponible por sucursal. |
| Proveedores | Administración de cuentas de proveedores. |
| Usuarios | Gestión de usuarios y permisos. |
| Compradores | Administración de compradores y relaciones con proveedores. |
| Importaciones | Registro de cargas de datos de sellout, participación, órdenes de compra, promociones y existencias. |
| Suscripción | Gestión de planes y estado de suscripción. |
Control de acceso
SaleShow incluye un sistema de permisos por módulo. Esto permite separar la experiencia de administradores, usuarios internos, compradores y proveedores.
Cada rol puede acceder únicamente a la información que le corresponde, lo que hace posible operar con datos segmentados sin exponer información sensible de toda la plataforma.
Algunas áreas controladas por permisos son:
| Área | Capacidades |
|---|---|
| Sellout | Ver ventas, consultar proveedores propios o todos los proveedores, exportar. |
| Stock | Consultar inventario, segmentar por proveedor y exportar información. |
| Órdenes de compra | Ver, filtrar y exportar órdenes. |
| Promociones | Consultar y exportar información promocional. |
| Proveedores | Ver, crear y editar cuentas de proveedores. |
| Usuarios | Ver, crear, editar y eliminar usuarios. |
| Importaciones | Ver registros y crear importaciones de datos. |
| Dashboard | Acceder a indicadores principales. |
Importación y procesamiento de datos
Uno de los elementos más importantes del ecosistema es la carga de información externa.
SaleShow puede recibir datos de ventas, stock, órdenes de compra, promociones y participación. Para facilitar este proceso, el ecosistema incluye Saleshow Uploader, una herramienta especializada en procesar archivos CSV y llevarlos a la base de datos de forma robusta.
Saleshow Uploader
Saleshow Uploader es un complemento backend creado para automatizar la carga de archivos CSV hacia la base de datos.
Su función es detectar archivos, validarlos, procesarlos e insertarlos en las tablas correspondientes. Puede trabajar con archivos locales o descargarlos desde FTP en entornos productivos.
Entre sus capacidades se encuentran:
- Detección automática de archivos CSV.
- Procesamiento de archivos locales.
- Descarga de archivos desde FTP.
- Validación de archivos antes de cargarlos.
- Conversión de codificación a UTF-8.
- Limpieza selectiva de tablas.
- Inserción masiva en MySQL.
- Procesamiento paralelo para archivos pequeños.
- Procesamiento secuencial para archivos grandes.
- Locks de ejecución para evitar procesos concurrentes.
- Notificaciones a Discord sobre inicio, éxito, error o validaciones.
Este componente permite que SaleShow se mantenga actualizado sin depender de cargas manuales dentro del dashboard.
Saleshow Sender
Saleshow Sender es el servicio encargado de enviar alertas automáticas cuando existen productos con inventario crítico o situaciones que requieren atención inmediata.
El servicio recibe información de inventario, normaliza los datos y envía notificaciones por el canal correspondiente.
| Canal | Uso |
|---|---|
| Alertas detalladas con productos, proveedores, sucursales, stock, urgencia y métricas globales. | |
| SMS | Mensajes cortos para alertas urgentes. |
| Alertas por WhatsApp Business usando templates o mensajes simples. |
Este componente convierte los datos de inventario en comunicación accionable, ayudando a que compradores o responsables operativos reaccionen más rápido ante problemas de stock.
Saleshow MCP
Saleshow MCP agrega una capa conversacional al ecosistema mediante Model Context Protocol.
Este componente permite consultar información de inventario desde asistentes compatibles con MCP, como herramientas internas, copilotos o clientes de desarrollo. En lugar de navegar manualmente por dashboards, un usuario puede hacer preguntas operativas y recibir respuestas estructuradas en lenguaje natural.
Sus herramientas principales incluyen:
| Herramienta MCP | Función |
|---|---|
get_branch_inventory | Consulta inventario de una sucursal específica con filtros opcionales. |
get_critical_stock | Obtiene productos con inventario crítico o bajo stock. |
search_product | Busca productos por nombre o SKU dentro de una sucursal. |
get_products_by_classification | Filtra productos por clasificación A, B, C, M, O o N. |
list_branches | Lista sucursales disponibles para consultar inventario. |
Este componente abre la puerta a experiencias asistidas por IA, donde la operación puede consultarse de forma conversacional sin depender únicamente de interfaces visuales.
Flujo general
El ecosistema completo de SaleShow funciona de la siguiente manera:
- La empresa genera o recibe archivos operativos de ventas, inventarios, órdenes de compra, promociones y participación.
- Saleshow Uploader detecta esos archivos localmente o los descarga desde FTP.
- El uploader valida, procesa e inserta los datos en MySQL.
- SaleShow App muestra dashboards, reportes y módulos administrativos con información actualizada.
- Saleshow Sender envía alertas cuando detecta productos críticos o situaciones importantes.
- Saleshow MCP permite consultar datos operativos desde asistentes compatibles con IA.
- Los usuarios toman decisiones con información actualizada, segmentada y accionable.
Características principales
| Característica | Descripción |
|---|---|
| Dashboards operativos | Visualización de ventas, compras, inventarios y proveedores. |
| Gestión de proveedores | Administración de cuentas y permisos para proveedores. |
| Control de stock | Consulta de inventario por sucursal y producto. |
| Sellout | Análisis de ventas a consumidor final. |
| Órdenes de compra | Seguimiento de compras y abastecimiento. |
| Promociones | Gestión y análisis de descuentos y campañas. |
| Importaciones | Registro y control de cargas de datos. |
| Permisos por rol | Segmentación de acceso según usuario, proveedor o área. |
| Alertas multicanal | Notificaciones por email, SMS y WhatsApp. |
| Consultas asistidas | Integración MCP para preguntas operativas en lenguaje natural. |
Tech stack
| Área | Tecnologías |
|---|---|
| Backend principal | Laravel, PHP 8.2 |
| Frontend | React, Inertia.js, Vite |
| UI y estilos | Tailwind CSS, Material UI, HeroUI, Headless UI |
| Gráficas | Recharts, MUI X Charts, Lightweight Charts |
| Base de datos | MySQL |
| Autenticación y API | Laravel Sanctum |
| Suscripciones | Laravel Cashier |
| Permisos | Spatie Laravel Permission |
| Importación y exportación | Maatwebsite Excel, OpenSpout |
| PDFs | DomPDF |
| Storage | S3-compatible storage |
| Uploader | Python, Pandas, mysql-connector-python, Paramiko |
| Notificaciones | Supabase Edge Functions, Deno, Resend, Twilio |
| MCP / IA | FastMCP, TypeScript, Bun, Zod |
| Observabilidad auxiliar | Loguru, Rich, Discord Webhooks |
Seguridad y arquitectura
Para la versión pública del proyecto, SaleShow puede describirse sin exponer URLs internas de API, tokens, endpoints específicos o credenciales. La arquitectura puede comunicarse como una integración entre servicios internos, API privada, workers de carga, notificaciones y servidor MCP.
Esto permite explicar el valor técnico del proyecto sin aumentar la superficie de exposición de un sistema real en producción.
Resultado
SaleShow transforma procesos comerciales dispersos en una plataforma integrada para análisis, gestión y automatización.
La combinación de la aplicación principal con sus componentes complementarios permite cubrir el ciclo completo de operación:
- Recibir datos externos.
- Procesarlos automáticamente.
- Visualizarlos en dashboards y reportes.
- Controlar accesos por usuario o proveedor.
- Detectar inventario crítico.
- Enviar alertas multicanal.
- Consultar datos mediante asistentes compatibles con IA.
El resultado es un sistema más eficiente para tomar decisiones comerciales, reducir trabajo manual y reaccionar con mayor velocidad ante cambios en ventas, inventarios y comportamiento de proveedores.