58 lines
4.3 KiB
Markdown
58 lines
4.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".
|
||
|
|
|
||
|
|
## ⚠️ 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.
|
||
|
|
- 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.
|