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:
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