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,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 })}%`
}