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:
91
apps/dashboards/src/lib/reportes.test.ts
Normal file
91
apps/dashboards/src/lib/reportes.test.ts
Normal 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%')
|
||||
})
|
||||
})
|
||||
119
apps/dashboards/src/lib/reportes.ts
Normal file
119
apps/dashboards/src/lib/reportes.ts
Normal 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 })}%`
|
||||
}
|
||||
Reference in New Issue
Block a user