Compare commits

..

No commits in common. "6dade84d37671bc403f58b75260568f678e56ecb" and "e919715871d4cec31a7a6334175e1716b4b9793e" have entirely different histories.

View file

@ -1,43 +1 @@
@AGENTS.md @AGENTS.md
# Informe Comercial ALFA+ — app Next.js (Dataverse en vivo)
Dashboard comercial de **ALFA+** (Alfanumeric Nicaragua), consulta Dynamics 365 en vivo por OAuth
de vendedor (`dynamic = "force-dynamic"`, sin caché) — reemplaza al sitio HTML estático que vive en
`Proyectos/Analitica de CRM/App Informe/`. Publicado en
`https://informe-comercial.apps.online.com.ni`.
## ⚠️ Esta es la carpeta que corre en producción
**`C:\dev\informe-comercial` es la fuente real de lo publicado**, aunque no tenga `.git`.
`C:\Mis Aplicaciones\informe-comercial` sí está enlazada a Forgejo pero **queda desactualizada
frente a esta** — confirmar fechas de archivo antes de asumir cuál es la vigente si ha pasado
tiempo. Corregido el 2026-09-28 tras diagnosticar un bug sobre la carpeta equivocada; detalle
completo en `Proyectos/Analitica de CRM/sesion.md`, entrada "2026-09-28".
## Reglas de negocio — viven en el proyecto de análisis, no acá
**No duplicar aquí** la definición de tipos de oportunidad, tuberías, forecast category, motivos de
cierre, ejecutivos de venta, ni las lecciones aprendidas de interpretación de datos. Esa es la
fuente de verdad y cambia con el negocio — leerla ahí:
📘 `C:\Users\marco.montenegro\OneDrive - Alfanumeric\Claude\Proyectos\Analitica de CRM\CLAUDE.md`
De ahí en particular:
- Estructura de tuberías y tipos de oportunidad (`alfa_typeopportunity`)
- **Cumplimiento de meta — qué cuenta**: solo Venta - Cliente Nuevo, Up-Selling, Cross-Selling,
Plan de Cuenta (`TIPOS_META` en `app/lib/derive.js` es el espejo en código de esa lista)
- Ejecutivos de venta reales — Gabriela Sánchez y Ashley Bermúdez aparecen en los datos pero **no**
son ejecutivas de venta (`EJECUTIVOS_VENTA` en `app/lib/derive.js`)
- Forecast category con escala propia de ALFA+ (no la estándar de Dynamics)
- El mapa de motivos de cierre (`MOTIVO_MAP`) — Dynamics reetiquetó el optionset en sep-2026
- Las advertencias de interpretación (WhatsApp no está en el CRM, promedio ≠ techo, etc.)
Si una regla de negocio de código acá (`app/lib/derive.js`, `app/lib/queries.js`) no cuadra con lo
que dice ese `CLAUDE.md`, **ese archivo manda** — el código se ajusta a él, no al revés.
## Entorno técnico (ALFA+, común a todos los proyectos)
Ver también el `CLAUDE.md` raíz de ALFA+ (`Claude/CLAUDE.md`) para Dynamics
(`alfanumeric.crm.dynamics.com`), convenciones de trabajo (todo en español, no inventar números,
cambios acotados) y marca.