informe-comercial-alfa/CLAUDE.md

50 lines
3 KiB
Markdown

@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/Análisis e Informes/Analitica de CRM/App Informe/` (archivado, solo referencia; los comentarios del
código que citan `herramientas/…` o `App Informe/…` apuntan a ese material). Publicado en
`https://informe-comercial.apps.online.com.ni`.
## ⚠️ Esta es la carpeta que corre en producción
**`C:\dev\informe-comercial` es la única carpeta de trabajo y la fuente real de lo publicado.** Es un
repo git (rama `main`) sincronizado con Forgejo (`MarcoMontenegro/informe-comercial-alfa`). La copia
anterior en `C:\Mis Aplicaciones\informe-comercial` se eliminó el 2026-09-28. Historial del tema en
`Proyectos/Análisis e Informes/Analitica de CRM/sesion.md`, entrada "2026-09-28".
## Filtro de propietario persistente y Plan del Día (2026-10-26)
Cómo quedaron hechos (archivos, reglas de clasificación, PDF Carta horizontal, decisiones) y cómo reutilizarlos:
`Proyectos/Análisis e Informes/Analitica de CRM/referencia-implementacion-plan-del-dia.md` — la especificación funcional
está en `requerimientos-plan-del-dia.md` de esa misma carpeta. Código: `app/plan/`, `app/lib/plan.js`,
`app/components/plan/`, `app/components/OwnerControl.js`.
## 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\Análisis e Informes\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.