informe-comercial-alfa/CLAUDE.md

4.9 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/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".

⚠️ Publicar y git — leer antes de tocar el repo local (2026-10-27)

  • publish_changes publica lo que hay en esta carpeta y sube su propio commit a Forgejo (fuerza el push). El git local de esta carpeta queda desfasado (rama «adelante 1, atrás 1») y con cambios sin commit: es normal. No hacer git pull, git reset ni git checkout . sin revisar: perderías trabajo que ya está en producción.
  • Rutina después de cada publicación (acordada con Marco el 2026-11-06): correr git fetch origin y luego git reset origin/main (sin --hard). Mueve solo el historial local al de Forgejo y no toca ningún archivo, así el git no queda «adelante/atrás». Antes, comprobar que la carpeta coincide con origin/main (ignorando fin de línea: git archive origin/main a una carpeta temporal y diff -rq --strip-trailing-cr). Solo git reset sin --hard; git pull y git checkout . siguen prohibidos sin revisar.
  • Para saber si algo está publicado, no fiarse de git status: comparar los archivos con origin/main (git fetch y comparar hashes) o leer el commit desplegado en get_logs. El 2026-10-27 se comprobó así que los 104 archivos coinciden con el commit 0a51fac.
  • Dos sesiones pueden trabajar en paralelo en esta misma carpeta (el 2026-10-27: una en Previsión de Ventas, otra en Plan del Día / enlaces). Como comparten el árbol de trabajo, lo que publique una incluye lo de la otra: avisar antes de publicar y revisar git status para no subir trabajo a medias.
  • Enlaces para crear actividades en Dynamics (nuevaActividadUrl en app/lib/constants.js): el tipo del «Referente a» va en regardingobjectidtype=opportunity. Con regardingobjecttypecode el formulario se ve bien pero al guardar falla con 0x80040217. Los correos de Power Automate usan el mismo enlace (corregidos el 2026-10-27).

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.