feat(unidades): pipeline de 10 etapas por unidad + sync desde Reporte_EstatusVenta

- Columna Etapa en Monday Unidades (10 labels oficiales), 155 unidades pobladas - sync-etapas.ts idempotente (--archivo/--dry-run/--semilla) con traspasos Vendido→Escrituración y Escriturado→SAC como actividades (sin retroactivas) - API: etapa en unidades + porEtapa en /api/reportes/resumen - Dashboard: gráfica pipeline por etapa + KPI en notaría; cotizador muestra etapa - 28 cambios aplicados desde Reporte_EstatusVenta (8 avances, 20 nuevas); contradicciones retenidas para revisión humana (documentadas) - Tests: api 168, dashboards 9, cotizador 71
2026-08-28 04:43:02 +00:00
parent 04de7d703f
commit 9e04b76616
16 changed files with 697 additions and 4 deletions
--- a/apps/cotizador/src/components/UnitInfoCard.tsx
+++ b/apps/cotizador/src/components/UnitInfoCard.tsx
@@ -18,14 +18,30 @@ function Fila({ etiqueta, valor }: { etiqueta: string; valor: string }) {
 const formatoM2 = (v: number | null): string =>
  v === null ? '—' : `${v.toLocaleString('es-MX')} m²`

+// Status grueso → etiqueta legible en femenino ("la unidad está …")
+const ETIQUETA_STATUS: Record<string, string> = {
+  APARTADO: 'Apartada',
+  APARTADA: 'Apartada',
+  VENDIDO: 'Vendida',
+  VENDIDA: 'Vendida',
+  ESCRITURADO: 'Escriturada',
+  BLOQUEADO: 'Bloqueada',
+}
+
 /** Tarjeta con la ficha técnica de la unidad seleccionada */
 export function UnitInfoCard({ unidad, numMeses }: Props) {
  const extras = unidad.extras ?? {}
+  const etiquetaStatus = ETIQUETA_STATUS[unidad.status]
  return (
    <section className="border border-neutral-200 bg-white p-6">
      <h2 className="mb-4 text-xs font-bold tracking-widest text-neutral-900 uppercase">
        Unidad {unidad.codigo}
      </h2>
+      {etiquetaStatus !== undefined && unidad.etapa != null && unidad.etapa !== '' && (
+        <p className="mb-4 text-xs text-neutral-500">
+          {etiquetaStatus} — en {unidad.etapa.toLowerCase()}
+        </p>
+      )}
      <dl className="divide-y divide-neutral-200">
        <Fila etiqueta="Modelo" valor={unidad.modelo} />
        {extras['prototipo'] != null && <Fila etiqueta="Prototipo" valor={String(extras['prototipo'])} />}
--- a/apps/cotizador/src/types/index.ts
+++ b/apps/cotizador/src/types/index.ts
@@ -22,6 +22,8 @@ export interface Unidad {
  precioLista?: number | null
  /** Plazo de mensualidades cuando lo fija el inventario (SOLANA: meses para firma) */
  mesesParaFirma?: number | null
+  /** Etapa del pipeline de venta (Apartado, Reserva, Vendido, … PostVenta); null si no aplica */
+  etapa?: string | null
  /** Datos extra del inventario: prototipo, manzana, lote, etapa, cajones, etc. */
  extras?: Record<string, string | number | null>
 }
--- a/apps/dashboards/src/lib/reportes.test.ts
+++ b/apps/dashboards/src/lib/reportes.test.ts
@@ -2,9 +2,11 @@ import { describe, expect, it } from 'vitest'
 import {
  datosCobranza,
  datosFunnel,
+  datosPipeline,
  formatoMoneda,
  formatoPorcentaje,
  unidadesApiladas,
+  unidadesEnEtapa,
  type ResumenReportes,
 } from './reportes'

@@ -26,6 +28,18 @@ function resumen(overrides: Partial<ResumenReportes> = {}): ResumenReportes {
        { desarrollo: 'ATELIER', total: 3, porStatus: { DISPONIBLE: 1, VENDIDO: 2 } },
        { desarrollo: 'SOLANA', total: 2, porStatus: { DISPONIBLE: 1, ESCRITURADO: 1 } },
      ],
+      porEtapa: [
+        { etapa: 'Apartado', total: 1 },
+        { etapa: 'Reserva', total: 0 },
+        { etapa: 'Vendido', total: 0 },
+        { etapa: 'Integración', total: 0 },
+        { etapa: 'En Análisis', total: 0 },
+        { etapa: 'Autorizado', total: 0 },
+        { etapa: 'Notaría', total: 2 },
+        { etapa: 'Escriturado', total: 1 },
+        { etapa: 'Entrega', total: 0 },
+        { etapa: 'PostVenta', total: 0 },
+      ],
    },
    cobranza: {
      planes: { activos: 6, liquidados: 2, cancelados: 1 },
@@ -48,7 +62,35 @@ describe('unidadesApiladas', () => {
  })

  it('con inventario vacío devuelve arreglo vacío', () => {
-    expect(unidadesApiladas(resumen({ unidades: { total: 0, disponibles: 0, porDesarrollo: [] } }))).toEqual([])
+    expect(unidadesApiladas(resumen({ unidades: { total: 0, disponibles: 0, porDesarrollo: [], porEtapa: [] } }))).toEqual([])
+  })
+})
+
+describe('datosPipeline', () => {
+  it('devuelve las 10 etapas en el orden oficial con sus totales', () => {
+    const pipeline = datosPipeline(resumen())
+    expect(pipeline.map((e) => e.etapa)).toEqual([
+      'Apartado',
+      'Reserva',
+      'Vendido',
+      'Integración',
+      'En Análisis',
+      'Autorizado',
+      'Notaría',
+      'Escriturado',
+      'Entrega',
+      'PostVenta',
+    ])
+    expect(pipeline.find((e) => e.etapa === 'Notaría')?.valor).toBe(2)
+    expect(pipeline.find((e) => e.etapa === 'Escriturado')?.valor).toBe(1)
+  })
+})
+
+describe('unidadesEnEtapa', () => {
+  it('devuelve el total de la etapa pedida y 0 si no aparece', () => {
+    expect(unidadesEnEtapa(resumen(), 'Notaría')).toBe(2)
+    expect(unidadesEnEtapa(resumen(), 'Reserva')).toBe(0)
+    expect(unidadesEnEtapa(resumen({ unidades: { total: 0, disponibles: 0, porDesarrollo: [], porEtapa: [] } }), 'Notaría')).toBe(0)
  })
 })

--- a/apps/dashboards/src/lib/reportes.ts
+++ b/apps/dashboards/src/lib/reportes.ts
@@ -24,6 +24,8 @@ export interface ResumenReportes {
    total: number
    disponibles: number
    porDesarrollo: { desarrollo: string; total: number; porStatus: Record<string, number> }[]
+    /** Conteo por etapa del pipeline de venta, en el orden oficial de las 10 etapas */
+    porEtapa: { etapa: string; total: number }[]
  }
  cobranza: {
    planes: { activos: number; liquidados: number; cancelados: number }
@@ -74,6 +76,19 @@ export interface EtapaFunnel {
  valor: number
 }

+/**
+ * Datos de la gráfica "Pipeline de ventas por etapa": las 10 etapas del
+ * pipeline de unidad en su orden oficial (el API ya las manda ordenadas).
+ */
+export function datosPipeline(resumen: ResumenReportes): EtapaFunnel[] {
+  return resumen.unidades.porEtapa.map((e) => ({ etapa: e.etapa, valor: e.total }))
+}
+
+/** Unidades actualmente en una etapa dada del pipeline (p. ej. 'Notaría'); 0 si no hay */
+export function unidadesEnEtapa(resumen: ResumenReportes, etapa: string): number {
+  return resumen.unidades.porEtapa.find((e) => e.etapa === etapa)?.total ?? 0
+}
+
 /**
 * 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.
--- a/apps/dashboards/src/pages/DashboardPage.tsx
+++ b/apps/dashboards/src/pages/DashboardPage.tsx
@@ -19,9 +19,11 @@ import KpiCard from '../components/KpiCard'
 import {
  datosCobranza,
  datosFunnel,
+  datosPipeline,
  formatoMoneda,
  formatoPorcentaje,
  unidadesApiladas,
+  unidadesEnEtapa,
  type ResumenReportes,
 } from '../lib/reportes'
 import { fetchResumen } from '../services/reportes'
@@ -73,6 +75,8 @@ export default function DashboardPage() {
  const unidades = resumen ? unidadesApiladas(resumen) : []
  const funnel = resumen ? datosFunnel(resumen) : []
  const cobranza = resumen ? datosCobranza(resumen) : []
+  const pipeline = resumen ? datosPipeline(resumen) : []
+  const sinPipeline = pipeline.every((e) => e.valor === 0)
  const sinCobranza = resumen !== null && resumen.cobranza.planesAlCorriente + resumen.cobranza.planesConVencidos === 0

  return (
@@ -139,6 +143,11 @@ export default function DashboardPage() {
              detalle={`${resumen.cobranza.planes.liquidados} liquidados · ${resumen.cobranza.planes.cancelados} cancelados`}
            />
            <KpiCard titulo="Actividades abiertas" valor={resumen.actividadesAbiertas} />
+            <KpiCard
+              titulo="En notaría"
+              valor={unidadesEnEtapa(resumen, 'Notaría')}
+              detalle="unidades en etapa Notaría"
+            />
            <KpiCard
              titulo="Leads por contactar"
              valor={resumen.leads.porEstado['NUEVO'] ?? 0}
@@ -168,6 +177,25 @@ export default function DashboardPage() {
            )}
          </section>

+          <section aria-label="Pipeline de ventas por etapa" className="mt-12">
+            <TituloSeccion>Pipeline de ventas por etapa</TituloSeccion>
+            {sinPipeline ? (
+              <EstadoVacio mensaje="Sin unidades en el pipeline" />
+            ) : (
+              <div className="h-80">
+                <ResponsiveContainer width="100%" height="100%">
+                  <BarChart data={pipeline} layout="vertical" margin={{ top: 8, right: 24, left: 24, bottom: 0 }}>
+                    <CartesianGrid strokeDasharray="3 3" horizontal={false} />
+                    <XAxis type="number" allowDecimals={false} tick={{ fontSize: 11 }} />
+                    <YAxis type="category" dataKey="etapa" width={90} tick={{ fontSize: 11 }} />
+                    <Tooltip />
+                    <Bar dataKey="valor" name="Unidades" fill="#1B4332" isAnimationActive={false} />
+                  </BarChart>
+                </ResponsiveContainer>
+              </div>
+            )}
+          </section>
+
          <div className="mt-12 grid gap-12 lg:grid-cols-2">
            <section aria-label="Embudo comercial">
              <TituloSeccion>Embudo: leads → oportunidades → ganado</TituloSeccion>