feat: automatizaciones ronda 2 + app de dashboards /dash

- Escalado: lead asignado sin contactar >48h genera actividad URGENTE
  al coordinador (LEAD_ESCALADO_HORAS, MONDAY_COORDINADOR_USER_ID)
- Oportunidad en Aparto crea item en Apartado (fecha límite +7d);
  en Ganado crea la Venta; ambos con dedup
- GET /api/reportes/resumen: leads, funnel, unidades por desarrollo,
  cobranza y actividades en una respuesta (cache 60s)
- App dashboards (/dash): 8 KPIs + 3 gráficas Recharts, con auth
- Landing: tarjeta Tableros; docs/AUTOMATIZACIONES-MONDAY.md con las
  recetas nativas para activar en la UI
- Tests: api 158, dashboards 7, landing 5 — todo verde
This commit is contained in:
2026-08-27 09:05:09 +00:00
parent de11af985e
commit 04568a5603
34 changed files with 6279 additions and 8 deletions

View File

@@ -0,0 +1,91 @@
import { describe, expect, it } from 'vitest'
import {
datosCobranza,
datosFunnel,
formatoMoneda,
formatoPorcentaje,
unidadesApiladas,
type ResumenReportes,
} from './reportes'
function resumen(overrides: Partial<ResumenReportes> = {}): ResumenReportes {
return {
generadoEn: '2026-08-22T12:00:00.000Z',
leads: { total: 40, nuevosHoy: 3, nuevosSemana: 12, porEstado: {}, porOrigen: {} },
oportunidades: {
total: 20,
activas: 15,
porEtapa: { Afluencia: 8, Cotizador: 5, Aparto: 4, Ganado: 2, Perdido: 1 },
tasaAparto: 0.3,
tasaGanado: 0.1,
},
unidades: {
total: 5,
disponibles: 2,
porDesarrollo: [
{ desarrollo: 'ATELIER', total: 3, porStatus: { DISPONIBLE: 1, VENDIDO: 2 } },
{ desarrollo: 'SOLANA', total: 2, porStatus: { DISPONIBLE: 1, ESCRITURADO: 1 } },
],
},
cobranza: {
planes: { activos: 6, liquidados: 2, cancelados: 1 },
planesAlCorriente: 4,
planesConVencidos: 2,
pagosVencidos: 3,
montoVencido: 125000,
},
actividadesAbiertas: 7,
...overrides,
}
}
describe('unidadesApiladas', () => {
it('mapea desarrollo × status con columnas fijas y agrupa lo desconocido en OTROS', () => {
expect(unidadesApiladas(resumen())).toEqual([
{ desarrollo: 'ATELIER', DISPONIBLE: 1, APARTADO: 0, VENDIDO: 2, BLOQUEADO: 0, OTROS: 0 },
{ desarrollo: 'SOLANA', DISPONIBLE: 1, APARTADO: 0, VENDIDO: 0, BLOQUEADO: 0, OTROS: 1 },
])
})
it('con inventario vacío devuelve arreglo vacío', () => {
expect(unidadesApiladas(resumen({ unidades: { total: 0, disponibles: 0, porDesarrollo: [] } }))).toEqual([])
})
})
describe('datosFunnel', () => {
it('ordena Leads → Oportunidades → Aparto o más → Ganado sin subir', () => {
const funnel = datosFunnel(resumen())
expect(funnel.map((e) => e.etapa)).toEqual(['Leads', 'Oportunidades', 'Aparto o más', 'Ganado'])
expect(funnel.map((e) => e.valor)).toEqual([40, 20, 6, 2]) // Aparto(4) + Ganado(2) acumulados
const valores = funnel.map((e) => e.valor)
for (let i = 1; i < valores.length; i++) expect(valores[i]!).toBeLessThanOrEqual(valores[i - 1]!)
})
it('tolera etiquetas con otra capitalización', () => {
const r = resumen()
r.oportunidades.porEtapa = { aparto: 1, ' GANADO ': 3 }
const funnel = datosFunnel(r)
expect(funnel[2]?.valor).toBe(4)
expect(funnel[3]?.valor).toBe(3)
})
})
describe('datosCobranza', () => {
it('devuelve al corriente vs con vencidos', () => {
expect(datosCobranza(resumen())).toEqual([
{ nombre: 'Al corriente', valor: 4 },
{ nombre: 'Con vencidos', valor: 2 },
])
})
})
describe('formatos', () => {
it('moneda MXN sin centavos', () => {
expect(formatoMoneda(125000)).toBe('$125,000')
})
it('porcentaje desde fracción', () => {
expect(formatoPorcentaje(0.4)).toBe('40%')
expect(formatoPorcentaje(0.333)).toBe('33.3%')
})
})

View File

@@ -0,0 +1,119 @@
/**
* Tipos del endpoint GET /api/reportes/resumen y transformaciones puras para
* las gráficas del tablero. Toda la lógica de forma de datos vive aquí para
* probarla sin renderizar componentes.
*/
export interface ResumenReportes {
generadoEn: string
leads: {
total: number
nuevosHoy: number
nuevosSemana: number
porEstado: Record<string, number>
porOrigen: Record<string, number>
}
oportunidades: {
total: number
activas: number
porEtapa: Record<string, number>
tasaAparto: number
tasaGanado: number
}
unidades: {
total: number
disponibles: number
porDesarrollo: { desarrollo: string; total: number; porStatus: Record<string, number> }[]
}
cobranza: {
planes: { activos: number; liquidados: number; cancelados: number }
planesAlCorriente: number
planesConVencidos: number
pagosVencidos: number
montoVencido: number
}
actividadesAbiertas: number
}
// Status de inventario que se grafican por separado; el resto se agrupa en OTROS
export const STATUS_UNIDAD = ['DISPONIBLE', 'APARTADO', 'VENDIDO', 'BLOQUEADO'] as const
export interface RenglonUnidades {
desarrollo: string
DISPONIBLE: number
APARTADO: number
VENDIDO: number
BLOQUEADO: number
OTROS: number
}
/** Filas para la barras apiladas: unidades por desarrollo × status */
export function unidadesApiladas(resumen: ResumenReportes): RenglonUnidades[] {
return resumen.unidades.porDesarrollo.map((d) => {
const renglon: RenglonUnidades = {
desarrollo: d.desarrollo,
DISPONIBLE: 0,
APARTADO: 0,
VENDIDO: 0,
BLOQUEADO: 0,
OTROS: 0,
}
for (const [status, n] of Object.entries(d.porStatus)) {
if ((STATUS_UNIDAD as readonly string[]).includes(status)) {
renglon[status as (typeof STATUS_UNIDAD)[number]] = n
} else {
renglon.OTROS += n
}
}
return renglon
})
}
export interface EtapaFunnel {
etapa: string
valor: number
}
/**
* Datos del funnel comercial: Leads → Oportunidades → Aparto o más → Ganado.
* "Aparto o más" es acumulado (Aparto + Ganado) para que el funnel no suba.
*/
export function datosFunnel(resumen: ResumenReportes): EtapaFunnel[] {
const porEtapa = resumen.oportunidades.porEtapa
const conteo = (etapa: string): number =>
Object.entries(porEtapa)
.filter(([k]) => k.trim().toUpperCase() === etapa)
.reduce((acc, [, v]) => acc + v, 0)
const apartoOMas = conteo('APARTO') + conteo('GANADO')
return [
{ etapa: 'Leads', valor: resumen.leads.total },
{ etapa: 'Oportunidades', valor: resumen.oportunidades.total },
{ etapa: 'Aparto o más', valor: apartoOMas },
{ etapa: 'Ganado', valor: conteo('GANADO') },
]
}
export interface Rebanada {
nombre: string
valor: number
}
/** Rebanadas de la gráfica de cobranza: planes activos al corriente vs con vencidos */
export function datosCobranza(resumen: ResumenReportes): Rebanada[] {
return [
{ nombre: 'Al corriente', valor: resumen.cobranza.planesAlCorriente },
{ nombre: 'Con vencidos', valor: resumen.cobranza.planesConVencidos },
]
}
const formatoMXN = new Intl.NumberFormat('es-MX', { style: 'currency', currency: 'MXN', maximumFractionDigits: 0 })
/** Formato monetario MXN sin centavos: $1,250,000 */
export function formatoMoneda(valor: number): string {
return formatoMXN.format(valor)
}
/** Fracción (0.4) a texto porcentaje (40%) */
export function formatoPorcentaje(fraccion: number): string {
return `${(fraccion * 100).toLocaleString('es-MX', { maximumFractionDigits: 1 })}%`
}