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

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)
   })
 })
 

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.

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>