# Plan — NOVASIS Inmobiliario (vertical M110–M124)

> **Estado al 10/10/2026**: F0 ✅ · F1 ✅ · F2 sin CRM ✅ · F4 dentro del módulo ✅ · F5 ✅ (backend + frontend + e2e) · desplegados en **test** (Comercial Kety) · **no está en producción**.
> **Ramas**: `feat/inmobiliario` en backend (desde `pos`) y frontend (desde `main`), mergeadas a `pos-dev` (16f7f90) y `dev` (97aa7e8).
> **Spec**: `Novasis_Inmobiliario_Analisis_Spec_v1.docx` · **Análisis de factibilidad y decisiones**: https://claude.ai/artifact/N1MNv7YiPSPwo9WdrWKdAF
> **Detalle técnico del módulo** (reglas, flujo, gotchas): `src/inmobiliario/CLAUDE.md`.
> **Piloto**: Karmar Inmobiliaria (desarrolladora).

## 0. Cómo se usa este documento

Este plan es el registro de **dónde estamos** y, sobre todo, de **qué se tocó del ERP que ya existía**. El
código nuevo del vertical vive aislado en `src/inmobiliario/` y casi no necesita seguimiento; lo que hay que
poder rastrear es cada cambio a un módulo existente, porque afecta a todas las empresas.

Reglas:

1. **Todo cambio a código existente se registra en la sección 4 en el mismo commit que lo hace**: archivo, qué
   cambió, por qué, impacto en el resto del ERP y commit.
2. Todo cambio hecho a mano en un entorno (base de datos, configuración, datos) se registra en la sección 5.
3. Cada fase se cierra con su suite e2e (sección 7) y una entrada en la bitácora (sección 9).

## 1. Dónde estamos

| Fase | Alcance | Estado | Commits clave (backend · frontend) | E2E |
|---|---|---|---|---|
| PRE | Cálculo de IVA en backend, factura USD pagada en Gs. | ✅ | `a07dd23`, `a54bedc` | — |
| F0 Fundaciones | Parámetros, IPC, proyectos, etapas, hitos, numeración, permisos | ✅ | `63169f1` · `dbbd453` | `inmobiliario-f0.real.spec.js` (5) |
| F1 Comercial | Unidades, planes, cotizador, reserva → boleto, cobro con factura, cartera, avisos | ✅ | `1effae6`…`e7c2b62` · `24e86a4`…`35340f7` | `inmobiliario-f1.real.spec.js` (8) |
| F2 Cierre del ciclo (sin CRM) | Adendas (cambio de plan, de unidad, cesión, rescisión), escrituración, entrega con observaciones, comisiones | ✅ | `fc3d726`, `0c798ad` · `744f3fc`…`acf0d62` | `inmobiliario-f2.real.spec.js` (8) |
| F2 con CRM | Reclamos como tickets (CRM-28), portal del comprador (CRM-40) | ❌ espera al CRM | — | — |
| F3 Broker y alquileres | Captaciones, alquileres, liquidación a propietarios | ❌ | — | — |
| F4 Obra (dentro del módulo) | Presupuesto por partidas, certificados de contratistas con fondo de reparo, imputación de compras/gastos/manual a partidas (sin tocar Compras ni Gastos), presupuesto vs ejecutado, costo por unidad | ✅ | `f488627` · `4f2afc4` | `inmobiliario-f4.real.spec.js` (6) |
| F4 integración con el ERP | Proyecto/partida en las líneas de compras, gastos y OP; cuenta por pagar desde el certificado; asiento con centro de costo | ❌ coordinar con Derlis | — | — |
| F5 Inversores y cumplimiento | Legajo de debida diligencia por cliente (beneficiario final, PEP, riesgo, documentos, vencimiento) que bloquea el boleto; registro de operaciones inusuales (efectivo alto, fraccionamiento, PEP, manual, ROS); inversores (aportes, canjes, distribuciones, estado de cuenta); informe de fideicomiso mensual | ✅ | `2d804e0` · `5745204` | `inmobiliario-f5.real.spec.js` (5) |

| Entorno | Qué hay | Desde |
|---|---|---|
| Local | F0 + F1 (base `novasis`) | 10/10/2026 |
| Test (143.198.100.72, `novasiserp`) | F0 + F1 + F2 + F4 + F5 vía `pos-dev`/`dev`; módulo habilitado sólo a Comercial Kety | 10/10/2026 |
| Producción | Nada. Llega con el próximo merge `pos-dev` → `pos` (ver sección 6) | — |

## 2. Decisiones (09–10/10/2026)

| # | Decisión | Consecuencia |
|---|---|---|
| 1 | La factura de cada cuota se emite **al cobro** | La deuda pendiente vive en `inm_operacion_cuotas`, no en `factura_cuotas`. Cobranzas/mora/cobradores del ERP no ven esas cuotas: la cartera y la mora las lleva el vertical |
| 2 | **CRM primero** en el roadmap, pero F0/F1/F4/F5 no dependen del CRM | Sólo F2 (tickets, portal) y F3 (contratos recurrentes) necesitan CRM F2–F3 |
| 3 | Segmento: **desarrolladora** (piloto Karmar) | Después de F1: F4 (obra) y F2 (postventa) antes que F3 |
| 4 | Cuotas en **USD fijo** o **Gs. ajustado por IPC del BCP** desde la firma | La cuota en USD se factura en USD; el comprador puede pagar en Gs. o USD |
| 5 | Base gravada **30 %**, IVA **5 %**, ajustable | Parámetro por empresa, copiado a cada operación al reservar |
| 6 | Cobro en pozo = **ingreso al cobrar**, en cuenta propia configurable | Conceptos contables `INM_VENTAS_5` / `INM_VENTAS_EXENTAS` |
| 7 | IPC: último publicado al cobro; la cuota nunca baja; una línea en la factura | `src/inmobiliario/common/ajuste-indice.ts` |
| 8 | (11/10, F5) **Debida diligencia exigida por defecto**: el boleto no se firma sin legajo aprobado y vigente de cada comprador y cotitular | Parámetro `exigir_legajo_cliente` (true). Cambia el flujo de F1 para todas las empresas con el módulo: las ventas ya firmadas no se tocan, las reservas abiertas necesitan el legajo antes del boleto. Umbral de efectivo 75.000.000 Gs. (≈ USD 10.000) y ventana de fraccionamiento de 30 días, ajustables |

Fuera de v1 (decidido): interés de financiación, anular un cobro desde el vertical, facturar la mora (hoy se
estima), plano con zonas clicables.

## 3. Lo nuevo (aislado)

- Backend: `src/inmobiliario/` (módulo `InmobiliarioModule`), 5 migraciones (`20261010_inm_base`,
  `20261011_inm_comercial`, `20261012_inm_postventa`, `20261013_inm_obra`, `20261014_inm_inversores_cumplimiento`),
  36 tablas `inm_*`, 11 submódulos de seguridad con 78 privilegios.
- Frontend: `src/pages/inmobiliario/`, `src/components/organismos/inmobiliario/`, `src/api/inmobiliario.service.js`,
  `src/components/_standards/enums/inmobiliario.js`, `e2e/inmobiliario-*`.

El detalle (tablas, endpoints, reglas, flujo) está en `src/inmobiliario/CLAUDE.md`.

## 4. Cambios a lo que ya existía

### 4.1 Backend — código

| Archivo | Qué cambió | Por qué | Impacto en el resto del ERP | Commit |
|---|---|---|---|---|
| `src/facturas/facturas.service.ts` | En el armado de `factura_forma_pagos`, nueva rama: **factura en moneda extranjera pagada en PYG**. Antes buscaba una cotización del guaraní, no la encontraba y rechazaba la factura. Ahora el pago queda en Gs. (`dmontipag`, `cmonetipag = PYG`, sin `dticamtipag`) y `montoBase` se convierte con el `dticam` de la factura | Cuotas facturadas en USD que el comprador paga en guaraníes | **Afecta a todas las facturas**. Sólo entra cuando la factura NO es PYG y el pago SÍ es PYG, caso que antes fallaba siempre, así que no cambia nada que hoy funcione. Factura PYG pagada en USD: sin cambios | `a54bedc` |
| `src/facturas/pago-moneda.ts` (nuevo, dentro de facturas) | Función pura de esa conversión, con test | Testear la regla sin montar `FacturasService` | Ninguno fuera de lo anterior | `a54bedc` |
| `src/facturas/sifen-payload.service.ts` | `dTiCamTiPag` va **nulo** cuando la moneda del pago es PYG; antes caía al `dticam` de la factura | El manual SIFEN pide el tipo de cambio del pago sólo si no es PYG; con la rama nueva aparecía un pago en Gs. con TC | Facturas PYG: ya iba nulo (`dticam` es nulo en PYG). Facturas USD pagadas en USD: sin cambios. **Sólo cambia el caso nuevo** | `a54bedc` |
| `src/facturas/calculo-iva.ts` (nuevo, dentro de facturas) | Cálculo NT 13 de ítems y subtotales (incluye afectación 4) en el backend, mismo resultado que `utils/invoiceCalculations.js` del frontend | Los servicios que emiten facturas solos no tenían dónde calcular el IVA | Ninguno: nadie más lo usa todavía. Candidato a reemplazar cálculos ad hoc (p. ej. intereses moratorios) | `a07dd23` |
| `src/contabilidad/services/integracion.service.ts` | En `integrarFacturaVenta`: si la factura tiene un `inm_cobros`, las ventas 5 % y exentas van a `INM_VENTAS_5` / `INM_VENTAS_EXENTAS` (si la empresa no los mapeó, a `VENTAS_5` / `VENTAS_EXENTAS`) y las líneas de ventas llevan el **centro de costo del proyecto**. Nuevo método privado `cuentaConRespaldo` | Decisión 6: el contador puede llevar las cuotas a una cuenta propia (p. ej. anticipos) sin tocar código; resultado por proyecto | **Una consulta más por factura contabilizada** (`inm_cobros.findFirst` por `factura_cab_id`, indexado por índice único). Facturas que no son de cuotas: idéntico a antes | `1effae6` |
| `src/contabilidad/seeds/plan-cuentas-paraguay.seed.ts` | `MAPEO_DEFAULT` suma `INM_VENTAS_5 → 4.1.1.02` e `INM_VENTAS_EXENTAS → 4.1.1.03` (las mismas cuentas que `VENTAS_5`/`VENTAS_EXENTAS`) | Que los conceptos aparezcan en Contabilidad → Configuración para poder reasignarlos | `seedMapeoFaltantes` va a crear esas dos filas en `cont_mapeo_cuentas` a **todas las empresas** cuando se corra. Apuntan a las cuentas de siempre: no cambia ningún asiento | `1effae6` |
| `src/seguridad/seeds/seguridad.seed-data.ts` | Módulo raíz `INMOBILIARIO` con 11 submódulos y 78 privilegios (F2 sumó `INM_POSTVENTA`, `INM_COMISIONES` y 3 privilegios de adendas en `INM_OPERACIONES`; F4 sumó `INM_OBRA` con 11; F5 sumó `INM_CUMPLIMIENTO` con 6 e `INM_INVERSORES` con 11); perfiles de sistema nuevos **"Comercial inmobiliario"**, **"Cobranza inmobiliaria"**, (F4) **"Obra inmobiliaria"** y (F5) **"Oficial de cumplimiento"** (sin `autoProvision`) | Permisos del vertical | Al arrancar, el bootstrap los registra y el perfil Administrador (`*`) los recibe. Nadie ve el menú mientras el módulo no esté en su plan. Los perfiles nuevos sólo aparecen con "Cargar perfiles sugeridos" | `63169f1`, `1effae6`, F2, F4, F5 |
| `src/app.module.ts` | Importa `InmobiliarioModule` | Registrar el módulo | El módulo trae un **cron diario 05:30** (America/Asuncion) que recorre sólo empresas con fila en `inm_parametros` (desde F5 también detecta efectivo fraccionado) y, desde F5, un **cron mensual** (día 1, 06:00) que arma el borrador del informe de los proyectos en fideicomiso | `63169f1`, F5 |
| `prisma/schema.prisma` | Modelos y enums `inm_*` nuevos. En modelos existentes **sólo se agregaron campos de relación inversa** (no columnas): `empresas` (36), `moneda` (6), `cont_centros_costo` (1), `tes_cuentas` (1). `prisma format` realineó espacios en esos modelos. F4 referencia `proveedores`, `compra_cab` y `gasto_cab`, y F5 `clientes` y `proveedores`, **sin relación Prisma** (sólo FK en la base) para no tocar esos modelos | Prisma exige la relación inversa | Ninguno en la base: no hay `ALTER` sobre tablas existentes | `63169f1`, `1effae6`, F2, F4, F5 |

**Módulos que el vertical USA sin modificarlos** (si cambian, revisar el vertical): `FacturasService.create`
(emite la factura de cada cobro, como `cobranzas/intereses-moratorios.service.ts`), `PersonasService.validatePersonaById`
(valida al comprador al reservar), `MonedasService.getCotizacionVigente` (cotización del cobro y, desde F4, de la imputación de
comprobantes en otra moneda; el respaldo 1 se rechaza), `AlertasEmpresaService` (avisos diarios), `AuditService`, `NumeracionInmService` (propio, copia del patrón
de `NumeracionCrmService` sin depender del CRM).

**Servicios de infraestructura que el vertical usa (F5)**: DigitalOcean Spaces con las mismas variables `DO_SPACES_*`
que RRHH, mismo bucket, ruta propia `inmobiliario/{empresa}/legajos/{cliente}/…`, objetos privados y URL firmada de
10 minutos (`src/inmobiliario/cumplimiento/inm-storage.service.ts`). El servicio de RRHH no se reutiliza porque
arma rutas por empleado.

**Tablas existentes que el vertical LEE** (F4, sin escribirlas): `compra_cab` y `gasto_cab` (total, IVA, moneda,
cotización, número, fecha, anulado/estado) para imputar su base sin IVA a partidas, y `proveedores` + `personas`
(contratistas). Si Compras o Gastos cambian el significado de `total`, `total_iva`/`iva_total`, `cotizacion`,
`anulado` o `estado = 'anulada'`, revisar `src/inmobiliario/obra/costos-obra.service.ts`. Una compra o gasto
anulado **después** de imputado sigue imputado: la imputación no se borra sola (pendiente, sección 8).

### 4.2 Frontend — código

| Archivo | Qué cambió | Impacto | Commit |
|---|---|---|---|
| `src/routers/routes.jsx` | 13 rutas `/inmobiliario/*` (lazy). F5: `/inmobiliario/cumplimiento`, `/inmobiliario/cumplimiento/legajos/:clienteId` (con `INM_CUM_LEGAJO_VER`) e `/inmobiliario/inversores`, las dos primeras gateadas por dentro como Obra. F4: `/inmobiliario/obra` sólo con `modulo` (sin `permission`): sus pestañas tienen permisos distintos y la página se gatea por dentro | Ninguno: rutas nuevas protegidas por `modulo="INMOBILIARIO"` | `dbbd453`, `24e86a4`, `4f2afc4` |
| `src/utils/dataEstatica.jsx` | 9 entradas de menú (Proyectos, Cotizador, Ventas inmobiliarias, Cartera inmobiliaria, Comisiones, Obra, Cumplimiento, Inversores, Configuración inmobiliaria). "Obra", "Cumplimiento" e "Inversores" usan `permisosAlguno` | Sólo visibles con el módulo y el submódulo en el plan | `dbbd453`, `24e86a4`, F2, `4f2afc4` |
| `src/hooks/useMenuAcceso.js` | `MODULO_RAIZ_META.INMOBILIARIO` (grupo del menú) | Ninguno | `dbbd453` |
| `src/utils/screenSubmoduloMap.js` | Patrones de breadcrumb y etiquetas `INMOBILIARIO`, `INM_*` (F4: `/inmobiliario/obra` → `INM_OBRA`; F5: cumplimiento, legajo del cliente e inversores, y etiquetas `INM_CUMPLIMIENTO`/`INM_INVERSORES` en `SUBMODULO_LABELS`) | Ninguno | `dbbd453`, `24e86a4`, `4f2afc4`, `5745204` |
| `src/components/_standards/enums/index.js` | Re-exporta `enums/inmobiliario.js` | Ninguno | `dbbd453` |
| `package.json` | Script `e2e:inm` | Ninguno | `8a0185d` |
| `src/components/organismos/inmobiliario/obra/ContratistaAutocomplete.jsx` (del propio módulo, F4) | Props opcionales `label` y `required` (defaults iguales) para reusarlo con el proveedor del inversor | Ninguno | `5745204` |

Componentes y servicios existentes **reutilizados sin cambios**: `searchProveedores` (contratistas, F4; inmobiliaria externa, F2), `searchClientes` (`/clientes/search`, ids de la
tabla `clientes`; la pantalla de clientes del ERP usa ids de Supabase y no sirve), `useMediosPagoActivosQuery`,
`getReferenciales`, `useSesionActivaQuery`, `BancoSelect`, `getNumeracionesBySucursal`, `buscarProductos`,
`getCentrosCosto`, `getTesCuentas`, `getMonedas`, todo `_standards`.

### 4.3 Base de datos

- **Ninguna tabla existente fue alterada.** Las migraciones del vertical sólo crean tablas `inm_*` y tipos `inm_*`.
- Tablas nuevas con **FK hacia tablas existentes**: `empresas`, `moneda`, `clientes`, `productos`,
  `numeraciones_documento`, `factura_cab`, `cont_centros_costo`, `tes_cuentas`, desde F2 `proveedores`
  (inmobiliaria externa de una venta y beneficiario de su comisión; desde F4 también el contratista de un
  certificado; desde F5, el inversor al que se le paga), `clientes` también desde F5 (legajo de debida diligencia,
  operación inusual) y desde F4 `compra_cab` y `gasto_cab` (comprobante imputado a una partida, factura del contratista
  vinculada a un certificado). Sin relación Prisma, para no tocar esos modelos. Consecuencia: no se puede borrar
  físicamente una de esas filas si un registro del vertical la referencia (el ERP usa baja lógica, así que en la
  práctica no pasa).
- Las migraciones habilitan **RLS** (policy `ai_tenant_isolation`) en las tablas `inm_*` para el rol del Chat IA,
  igual que `20260804_ai_rls_tenant_isolation`.

**Datos que el vertical escribe en tablas existentes, en uso normal**:

| Tabla existente | Cuándo | Qué |
|---|---|---|
| `cont_centros_costo` | Al crear un proyecto sin centro de costo | Crea `INM-<código del proyecto>` (o reusa uno con ese código) |
| `factura_cab`, `factura_det`, `factura_forma_pagos`, `factura_subtotales` (+ caja si hay sesión) | Cada cobro de cuota | Vía `FacturasService.create`: factura de contado, afectación 4 |
| `numeraciones_documento` | Cada cobro | Avanza el número del timbrado configurado (lo hace `FacturasService`) |
| `audit_logs` | Toda escritura del vertical | Entradas con `entity_type = inm_*` |
| `pg_advisory_xact_lock` (no es tabla) | Cada imputación de compra o gasto | Lock transaccional por comprobante para que dos imputaciones simultáneas no pasen su base. No bloquea filas de Compras/Gastos |
| DigitalOcean Spaces (bucket compartido, no es tabla) | Al subir un documento al legajo de un cliente (F5) | Objeto privado en `inmobiliario/{empresa}/legajos/{cliente}/{año}/{id}.{ext}`. Nunca se borra (archivo de 5 años) |
| `ai_alertas` | Cron diario | Claves `inm:reserva:*`, `inm:rescision:*`, `inm:escritura:*`, `inm:garantia:*` (F2) |
| `modulos`, `submodulos`, `privilegios`, `perfiles`, `perfiles_privilegios` | Arranque del backend | Catálogo de seguridad (sección 4.1) |
| `cont_mapeo_cuentas` | Cuando se corre `seedMapeoFaltantes` | Filas `INM_VENTAS_5` / `INM_VENTAS_EXENTAS` |

## 5. Cambios hechos a mano en los entornos

| Fecha | Entorno | Qué | Cómo deshacerlo |
|---|---|---|---|
| 10/10 | Local (`novasis`) | `prisma migrate deploy` aplicó **16 migraciones de `pos` que faltaban** (CRM, cotizaciones, privilegios de remisión, etc.) además de las del vertical | No aplica: alinea la base con el código |
| 10/10 | Local | Datos de prueba en "Derlis Empresa Holding": proyectos TORRE-SOL, LOTE-NORTE, KAR*, LOT*, E2E-*/E2V-*, productos "Cuota inmobiliaria …", ventas y facturas (no enviadas: el backend local corrió con `MIDDLEWARE_SIFEN_URL` apuntando a un puerto muerto) | Base local, descartable |
| 10/10 | Test | `feat/inmobiliario` mergeada a `pos-dev` (16f7f90) y `dev` (97aa7e8); deploy: migraciones `20261010_inm_base` y `20261011_inm_comercial` aplicadas en `novasiserp` | Revertir los merges y bajar las tablas `inm_*` |
| 10/10 | Test | F2: merge a `pos-dev` (66ec62d) y `dev` (d4c7e6d); migración `20261012_inm_postventa` aplicada | Revertir los merges y bajar las tablas nuevas |
| 10/10 | Test | F4: merge a `pos-dev` (1b0a9f6) y `dev` (f603c56); migración `20261013_inm_obra` aplicada; `INM_OBRA` (11 privilegios) sembrado al arrancar | Revertir los merges y bajar las 3 tablas nuevas y la columna `inm_parametros.pct_fondo_reparo` |
| 10/10 | Test | Kety: proyectos `E2O-*` de la corrida e2e F4 (partidas, un certificado anulado, un costo manual). Ninguna compra quedó imputada | Dar de baja los proyectos |
| 11/10 | Test | F5: merge a `pos-dev` (d6dbe3a) y `dev` (bf297b5); migración `20261014_inm_inversores_cumplimiento` aplicada; `INM_CUMPLIMIENTO` (6) e `INM_INVERSORES` (11) sembrados. **Desde acá el boleto exige el legajo de debida diligencia** de cada comprador en Kety (las reservas A-0101 y B-0302 de KARMAR-DEMO lo necesitan antes de firmar) | Revertir los merges; para sólo quitar la exigencia, `exigir_legajo_cliente = false` en Configuración inmobiliaria |
| 11/10 | Test | Kety: legajo aprobado de "QA Cuotas Novasis" con una cédula de prueba de pocos bytes en Spaces (lo creó la e2e), proyectos `E2F-*` (fideicomiso de prueba con inversor, distribución pagada e informe emitido) e inusuales manuales descartadas | Dar de baja los proyectos; el legajo y las inusuales no se borran (archivo 5 años) |
| 10/10 | Test | **Comercial Kety**: fila en `suscripcion_modulos` (INMOBILIARIO, `Incluido`) | `DELETE` de esa fila (id `6d7c922f-3cf1-4f41-a408-8feaa4c90bca`) |
| 10/10 | Test | Kety: USD agregado a `empresa_monedas` y **cotización de demo 7.250 / 7.300 del 10/10/2026 (no es la real)** | Corregir o borrar la cotización en Facturación → Monedas |
| 10/10 | Test | Kety: producto de servicio "Cuota inmobiliaria" (afectación 4, 5 %, 30 %) y parámetros del vertical (producto, timbrado 001-001 `19abe001…`, descuento máx. 5 %, mora 3 %) | Configuración inmobiliaria |
| 10/10 | Test | Kety: proyecto de demo **KARMAR-DEMO** "Torre Karmar (demo)" (32 unidades, 3 planes, 2 reservas, 1 venta con boleto; comprador "QA Cuotas Novasis", CI 9999999) | Dar de baja el proyecto (las facturas de la venta no se borran) |
| 10/10 | Test | Kety: proyectos `E2V-*` (F1) y `E2P-*` (F2) de las corridas e2e, con ventas, facturas (aprobadas localmente: Kety tiene `sifen_activo=false`), adendas, escrituras, entregas y comisiones liquidadas | Dar de baja los proyectos (las facturas quedan) |
| 11/10 | Spaces (bucket `smart-voice-bucket`, compartido) | Prueba local de F5: un PDF de 125 bytes "cédula de prueba" en `inmobiliario/3b327470-…/legajos/4a903c46-…/2026/` (cliente local Derlis Dacosta). Las corridas e2e F1/F2/F5 suben uno por cliente de prueba la primera vez | Borrar los objetos bajo `inmobiliario/` del bucket si molestan (son privados) |
| — | Producción | Nada | — |

## 6. Camino a producción

`pos-dev` ya contiene el vertical, así que **viaja con el próximo merge `pos-dev` → `pos`**. Queda inerte
(el módulo no está en ningún plan), pero antes de ese deploy:

- [ ] Avisar a Derlis de los cambios en núcleo (sección 4.1): `facturas.service.ts`, `sifen-payload.service.ts`,
      `integracion.service.ts`, seed de mapeo y catálogo de seguridad.
- [ ] `npx prisma migrate deploy` aplica `20261010_inm_base`, `20261011_inm_comercial`, `20261012_inm_postventa` y
      `20261013_inm_obra` (sólo tablas nuevas y columnas en `inm_parametros`).
- [ ] Verificar después del deploy: 401 en `/api/v1/inmobiliario/proyectos` sin token y los 9 submódulos `INM_*`
      en `submodulos`.
- [ ] Para habilitarlo a un cliente: fila en `suscripcion_modulos` + configurar producto, timbrado y cotización
      del USD (Configuración inmobiliaria → Facturación y ventas). Sin eso el cobro responde 422 diciendo qué falta.
- [ ] Antes del primer cliente real: aprobación de una factura de cuota por SIFEN en test (criterio del spec;
      hasta ahora sólo se probó con SIFEN apagado), y validar con su contador el mapeo `INM_VENTAS_*`.

## 7. Pruebas

| Qué | Dónde | Cómo |
|---|---|---|
| Unitarios del vertical (82) | `src/inmobiliario/**/*.spec.ts` | `npx jest src/inmobiliario` |
| Multiempresa (criterio del spec) | `src/inmobiliario/inmobiliario-multitenancy.spec.ts` | Incluido en lo anterior |
| IVA y pago en otra moneda | `src/facturas/calculo-iva.spec.ts`, `pago-moneda.spec.ts` | `npx jest src/facturas` |
| E2E F0, F1, F2, F4 y F5 (32) | frontend `e2e/inmobiliario-f{0,1,2,4,5}.real.spec.js` | `pnpm run e2e:inm` con `E2E_BASE_URL`, `E2E_API_URL`, credenciales o `E2E_TOKEN`, `E2E_INM_CLIENTE` |

**Regla: cada fase se cierra con su suite e2e de Playwright.** Las de F1 y F2 emiten facturas reales: nunca contra producción. La de F4 no emite
documentos: imputa 1.000 de una compra existente y lo quita al final, y anula su certificado. Desde F5, F1 y F2
necesitan el legajo de debida diligencia del comprador: el helper `asegurarLegajoCliente` lo carga y aprueba por API
la primera vez (sube un PDF de pocos bytes a Spaces); la de F5 recorre el legajo por la pantalla.

## 8. Pendientes y próximas fases

**Pendientes de F2 (decididos fuera de esta fase porque tocan módulos compartidos)**
- Comisiones de vendedores empleados → liquidación de RRHH (`rrhh_comisiones_pendientes`: habría que sumar un
  origen nuevo al enum `rrhh_comision_origen_tipo`). Hoy la liquidación se registra a mano con una referencia.
- Comisiones de inmobiliarias externas → cuenta por pagar (Compras / pagos a proveedores).
- Devolución de la rescisión → notas de crédito sobre las facturas de cuotas: hoy el resumen de la adenda dice el
  monto a devolver y la NC se emite a mano desde Ventas.
- Cargo por cesión de derechos facturado: no está; la cesión sólo cambia el titular.

**Pendientes de F4 (tocan Compras, Gastos y Tesorería: coordinar con Derlis)**
- Elegir proyecto y partida **al cargar** la compra, el gasto o la orden de pago (hoy se imputa después, desde
  Inmobiliario → Obra → Costos). Requiere columnas en las líneas de esos módulos (PRE-I5).
- Cuenta por pagar desde el certificado aprobado, con el fondo de reparo y las retenciones como pasivo aparte.
  Hoy: la factura del contratista se carga en Compras, se vincula al certificado y se paga desde Tesorería; la
  devolución del fondo de reparo sólo se registra (fecha).
- Asiento contable de las compras/gastos imputados con el centro de costo del proyecto (hoy el centro de costo
  sólo lo llevan los cobros de cuotas).
- Anular una compra o un gasto imputado no borra la imputación: hoy hay que quitarla a mano. Con la integración,
  Compras/Gastos deberían avisar al vertical.

**Pendientes de F5 (tocan Tesorería o servicios externos)**
- Pago a inversores y aportes en dinero → órdenes de pago / ingresos de Tesorería. Hoy se registra la referencia del
  pago o del aporte; el movimiento se hace a mano en Tesorería.
- ROS: se presenta en el sistema de la SEPRELAD; el vertical sólo registra número y fecha.
- Cobros anteriores a F5 no tienen medio de pago guardado (`inm_cobros.medio_pago_codigo` en NULL): no entran en la
  detección de efectivo fraccionado.
- IA del vertical (spec F5/M124): no entra en esta fase; depende de la API key del cliente y de WhatsApp del CRM.

**Pendientes de F1 / operación**
- Aprobación SIFEN de una factura de cuota en test (activar SIFEN en una empresa de test o usar otra).
- Que Karmar tenga un usuario en test, o una empresa de demo propia (hoy ve los datos de prueba de Kety).
- Cotización real del USD en Kety (la cargada es de demo).

**Lo que va a tocar del ERP cada fase futura** (para anticipar coordinación):

| Fase | Código existente que va a tocar |
|---|---|
| F4 integración | **Compras, gastos, órdenes de pago y tesorería** (`proyecto_id` y `partida_id` en las líneas, PRE-I5), asientos con centro de costo del proyecto, cuentas por pagar de certificados con retención. Son módulos donde trabaja Derlis: coordinar antes. La parte de obra que vive en el vertical ya está (F4) |
| F2 Cierre del ciclo | NC sobre facturas de cuotas (rescisión), tickets y portal del **CRM** (CRM-28, CRM-40) |
| F3 Broker y alquileres | Contratos recurrentes del **CRM** (CRM-33 a 35) |
| F5 integración | Tesorería: pagos a inversores y aportes como movimientos (hoy sólo referencia) |

## 9. Bitácora

| Fecha | Qué |
|---|---|
| 09/10/2026 | Análisis de factibilidad; rama `feat/inmobiliario` y worktrees `backend-inmobiliario` / `frontend-inmobiliario` |
| 09–10/10/2026 | Decisiones 1–7 (sección 2) |
| 10/10/2026 | PRE: factura USD pagada en Gs. (`a54bedc`), IVA en backend (`a07dd23`) |
| 10/10/2026 | F0 backend + frontend (`63169f1`, `dbbd453`) |
| 10/10/2026 | F1 backend (`1effae6`), frontend (`24e86a4`…`35340f7`); probado por API (12 pasos) y en navegador |
| 10/10/2026 | Correcciones tras las pruebas: cliente `[Circular]` y saldo antes del boleto (`17169f1`), cotización vigente unificada (`e7c2b62`) |
| 10/10/2026 | Suites e2e F0 y F1 (`8a0185d`); desplegado en test y verificado con 13/13 e2e; demo KARMAR-DEMO en Kety |
| 10/10/2026 | Plan de seguimiento (este documento, `9845b00`) |
| 10/10/2026 | F2 sin CRM, backend: adendas, escrituración, entrega, comisiones; migración `20261012_inm_postventa`; probado por API (9 pasos) |
| 10/10/2026 | F2 frontend (detalle de la venta y pantalla de comisiones), suite e2e F2 (8/8 en local), desplegado en test |
| 10/10/2026 | F4 dentro del módulo, backend: partidas, certificados, imputación de compras/gastos/manual, presupuesto vs ejecutado, costo por unidad; migración `20261013_inm_obra`; probado por API (25 pasos) |
| 10/10/2026 | F4 frontend (`/inmobiliario/obra`, `4f2afc4`); ajustes de backend tras la prueba en navegador (fechas `AAAA-MM-DD`, margen nulo sin superficie, `proveedor_id` en imputables, listado liviano de partidas y facturas vinculables con permiso de certificado); suite e2e F4 6/6 y regresión F0–F4 27/27 en local |
| 10/10/2026 | F4 desplegado en test (pos-dev `1b0a9f6`, dev `f603c56`); e2e F0 + F4 contra test 11/11 |
| 11/10/2026 | F5 backend: legajo de debida diligencia por cliente que bloquea el boleto, operaciones inusuales (efectivo alto, fraccionamiento, PEP, manual, ROS), inversores (aportes, canjes, distribuciones, estado de cuenta) e informe de fideicomiso con borrador mensual; migración `20261014_inm_inversores_cumplimiento`; probado por API (40 pasos). Suites e2e F1 y F2 preparan el legajo del comprador por API |
| 11/10/2026 | F5 frontend (`5745204`): cumplimiento, legajo del cliente, inversores y fideicomiso; ajustes de backend tras la prueba en navegador (riesgo pedido a mano guardado aparte, ROS sube el riesgo, "" = null al comparar datos de fondo, anular un documento requerido devuelve el legajo a revisión, moneda en distribuciones); e2e F5 5/5 y regresión F0–F5 32/32 en local |
| 11/10/2026 | F5 desplegado en test (pos-dev `d6dbe3a`, dev `bf297b5`); e2e F0–F5 contra test 32/32 (F5 necesitó dos ajustes de espera por listas que se refrescan) |
