⚽ Liga La Virginia

Shippear #3 · Desafío Ranking de Vendedores

Los reportes mensuales de 135 vendedores y 15 sucursales, convertidos en un BI visual que se juega y en agentes de IA que hacen el trabajo administrativo por el vendedor, para que el vendedor solo venda.

• Producción: https://liga-la-virginia.vercel.app
• Repo: https://github.com/GeronimoTrossero/liga-la-virginia
• Demo: usuarios V052 (vendedor) y sup-pintos (gerente de equipo). PIN 1234.
• Identidad visual: paleta, tipografía y logotipo de La Virginia, con fuentes y aproximaciones documentadas en DECISIONS.md (V3).

---

1. Propuesta de valor

Hoy	Con Liga La Virginia
Una planilla mensual con 7 KPIs que nadie mira hasta el cierre	Una carta de jugador con semáforos, que el vendedor mira en la calle todos los días
"Estás 82% en cobranzas"	"Cobrá a estos 3 clientes → +0,4 pts, subís al #50 y desbloqueás Oro"
El gerente descubre los problemas a fin de mes	Mapa de calor del equipo, rachas en riesgo y misión colectiva en vivo
El vendedor pierde horas mandando recordatorios y llenando encuestas	Un agente de cobranzas por WhatsApp y un agente de relevamiento que lee la foto de la góndola
Competencia que desmotiva a la mitad de abajo	Ligas de 10 de nivel parecido, rachas, MVP del que más mejoró y misiones colectivas

Tres pilares:

1. Núcleo de negocio: BI visual y scorecard. Los 7 KPIs oficiales con su fórmula exacta, semáforos, cartas estilo FIFA, mapa de calor, filtros por mes, sucursal, regional, tipo y KPI.
2. Gamificación avanzada (Duolingo + figuritas). Temporadas trimestrales con niveles por percentil, ligas de ~10 con ascensos y descensos, rachas con protector, misiones individuales y colectivas, derbis, MVP, DT del Mes y Muro de la Fama.
3. Agentes de IA autónomos. Comodín Dibu, que redacta el WhatsApp de cobranza. El Agente de Cobranzas Autónomo recuerda, escucha el "ya pagué" e impacta el KPI. El Agente de Relevamiento Visual convierte una foto de góndola en encuestas completas.

2. Arquitectura

Browser (mobile-first)  ──SWR polling 2s──▶  /api/live (firma de cambios filtrada por sesión)
        │                                              │
        ▼                                              ▼
Next.js 15 App Router ── Server Components / Server Actions / API routes ── service role ──▶ Supabase Postgres
        │                     │                                                          (RLS ON, 0 políticas anon)
   middleware JWT       lib/scoring.ts  ← única fuente de verdad del Puntaje Oficial
   (cookie firmada)     lib/game.ts     ← Puntos de Liga, rachas, temporadas, ligas
                        lib/acciones.ts ← "Mejorá tu carta" (acciones = deltas sobre datos crudos)
                        lib/automation.ts ← agentes (cobranza, góndola, Dibu)

• Login real: tabla usuario (rol VENDEDOR o SUPERVISOR, que en pantalla se llama Gerente) con PIN hasheado con scrypt. La sesión es un JWT HS256 en una cookie httpOnly y un middleware redirige según el rol. El vendedor solo ve su carta. El gerente ve a su equipo, el detalle de sus vendedores, la Liga nacional y la Temporada.
• Sin acceso anónimo: RLS activado y ninguna política para anon (probado: la API REST con la anon key devuelve []). Todas las lecturas pasan por el servidor con la service role, filtradas por la sesión.
• Tiempo real sin Realtime: SWR consulta /api/live cada 2 segundos. Cuando cambia la firma (ajustes, bandeja, reconocimientos), refresca los Server Components.
• Las dos monedas nunca se mezclan:
  • Puntaje Oficial: los 7 KPIs, en lib/scoring.ts. Define ranking, podio y Balón de Oro.
  • Puntos de Liga: en lib/game.ts. Alimentan beneficios y desempates.
• Datos: scripts/extract-pdf.mjs genera data/dataset.json (el dataset vino en PDF). scripts/seed.ts valida la fórmula y carga todo; scripts/seed-usuarios.ts carga los usuarios.

Fórmula oficial (intocable)

KPI	Real	Objetivo	Sentido	Peso
VTA Venta vs OV	Kilos_Vendidos / Kilos_Objetivo	100%	↑	30%
PRD Productividad	Pedidos / Visitas	65%	↑	10%
ACT No compradores	(Cartera − Compradores) / Cartera	15%	↓	15%
LAN Últ. lanzamientos	Con_Lanzamiento / Compradores	40%	↑	15%
ENT No entregados	No_Entregados / Pedidos	3%	↓	10%
COB Cobranzas	Cobros_en_Plazo / Cobros_Mes	90%	↑	15%
REL Relevamientos	Realizadas / Asignadas	100%	↑	5%

• Cumplimiento: con tope de 110%. Puntaje = Σ(peso × cumplimiento) / 1,10 × 100.
• Validación de la fórmula (2026-10): Farías 97,99 · Rojas 97,46 · Moyano 96,29. ✅
• Semáforo: 🟢 ≥ 100% · 🟡 85–99,9% · 🔴 < 85%.
• Nivel mensual: 💎 ≥ 95 · 🥇 ≥ 90 · 🥈 ≥ 85 · 🥉 < 85.
• Candado: con VTA o COB en rojo no podés ser Oro ni Diamante. La carta muestra "🔒 Bloqueado en Plata".

This is the beginning of the README. Read the rest at the original. Read the full README ↗