informe-comercial-alfa/CLAUDE.md
Marco A. Montenegro Mercado 390fd02a2a Re-crea el repo desde C:\dev\informe-comercial — versión real en producción
La carpeta con .git (C:\Mis Aplicaciones\informe-comercial) quedó desactualizada
frente a lo que corre hoy en Coolify (deploy directo por Foundry desde esta
carpeta, sin paso por git). Este commit fija esta carpeta como fuente de verdad
del repo, con Renovaciones, Actividades, Agenda, Admin/Metas y Nuevas
Oportunidades que la copia vieja no tenía.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-28 10:38:16 -06:00

2.4 KiB

@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.