Base de datos en pausa

La base de datos de este demo está actualmente pausada para reducir costos, por lo que los datos visualizados pueden no estar disponibles o estar desactualizados. Si deseas acceder a los datos en vivo, contáctame en rodrigoalvarezdalmas@gmail.com.

Escribir un correo

Anexos

Documentación y referencias técnicas

Tech Stack

Next.js 15
Framework React con App Router y Server Components
TypeScript
Tipado estático para mayor confiabilidad
Tailwind CSS v4
Estilos utilitarios con tema personalizado
shadcn/ui
Componentes accesibles y personalizables
Supabase
Base de datos PostgreSQL con RLS
GPT-4o
LLM para análisis en lenguaje natural
Recharts
Visualizaciones de datos interactivas
Framer Motion
Animaciones fluidas y profesionales

Estructura de Datos

Tablas Principales
  • • sku_master — 10,032 productos
  • • farmatodo_sales_consolidated — 95,715 registros de ventas
  • • market_provider_1 — 1,056 productos (nivel nacional)
  • • market_provider_2_ciudades — 10,712 registros (nivel ciudad)
  • • competidor_canonico — 59 mapeos de nombres
  • • market_price_outliers — 7,361 outliers flaggeados
Vistas Analíticas
  • • vw_price_gaps_summary — KPIs de brechas de precio
  • • vw_regional_kpis — KPIs regionales agregados
  • • vw_oportunidades_kpis — KPIs de oportunidades comerciales
  • • vw_price_gaps — Brechas de precio por producto/ciudad
  • • vw_pareto — Análisis 80/20 de ventas
  • • vw_regional — Desempeño por ciudad
  • • vw_oportunidades_pareto — Oportunidades en productos top
  • • vw_oportunidades_regionales — Oportunidades por ciudad
  • • vw_oportunidades_expansion — Productos para expansión de catálogo

Pipeline Analítico

Sales + Market (Provider 2)
vw_price_gaps_summary
API: /api/gaps/summary
UI: Vista Gaps
Sales Consolidated
vw_pareto
API: /api/pareto
UI: Pareto / Top 80%
Regional + Market
vw_regional
API: /api/regional
UI: Regional / Cobertura
Oportunidades derivadas
vw_oportunidades_pareto
API: /api/oportunidades/pareto
UI: Oportunidades

Proceso QA del Agente IA

QA Automático
Hasta 2 reintentos
El agente analiza el error, corrige SQL y reejecuta
Metadata
qa_status + attempts
Se guarda en chat_messages y se muestra en UI

Los errores SQL se capturan y se reintenta automáticamente hasta 2 veces. El estado del proceso (qa_status) se refleja en la UI del chat para transparencia.

Decisiones Clave

Usar medianas en lugar de promedios
Los promedios se distorsionan por outliers extremos. Las medianas (P50) son más robustas.
No filtrar outliers, solo flaggearlos
Transparencia total. Los outliers pueden ser errores o realidades del mercado.
Vistas SQL pre-computadas
Consultas complejas ejecutadas una vez. APIs rápidas y confiables.
SQL read-only para el agente IA
Seguridad. El agente nunca puede modificar datos, solo consultarlos.
Persistencia de conversaciones
Permite retomar análisis previos y construir contexto incremental.

Limitaciones Conocidas

  • •Cobertura temporal: Solo Enero 2025 y Enero 2026
  • •Cobertura geográfica: 5 ciudades principales de Venezuela
  • •Moneda: Valores en UM (Unidad Monetaria) sin conversión específica
  • •Outliers: 948 registros flaggeados pero incluidos en análisis
  • •Competidores: Datos de 2 proveedores con cobertura variable

Timeline de Auditoría

Fase 1
Migración
Carga inicial desde fuentes heterogéneas
Fase 2
Refinamiento
Normalización de nombres y estructuras
Fase 3
Auditoría
Detección y corrección de problemas
Fase 4
Certificación
Validación final y documentación