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_changespublica 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 hacergit pull,git resetnigit 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 originy luegogit 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 conorigin/main(ignorando fin de línea:git archive origin/maina una carpeta temporal ydiff -rq --strip-trailing-cr). Sologit resetsin--hard;git pullygit checkout .siguen prohibidos sin revisar. - Para saber si algo está publicado, no fiarse de
git status: comparar los archivos conorigin/main(git fetchy comparar hashes) o leer el commit desplegado enget_logs. El 2026-10-27 se comprobó así que los 104 archivos coinciden con el commit0a51fac. - 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 statuspara no subir trabajo a medias. - Enlaces para crear actividades en Dynamics (
nuevaActividadUrlenapp/lib/constants.js): el tipo del «Referente a» va enregardingobjectidtype=opportunity. Conregardingobjecttypecodeel 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_METAenapp/lib/derive.jses 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_VENTAenapp/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.