Operaciones en Mapaprop — Guía Completa

PARTE 1 — Manual del Usuario

1. ¿Qué son las Operaciones?

Una operación es el registro de una transacción comercial sobre una propiedad: una reserva, una venta, un alquiler, una permuta, o una caída. Es el "qué pasó, cuándo, con quién y a qué precio" de cada movimiento del inmueble.

Ejemplo concreto

Tu asesor María toma una reserva de un departamento por USD 130.000 con seña de USD 5.000. Una semana después, el comprador firma boleto y se cierra la venta por USD 128.000 (negoció USD 2.000 menos). Mapaprop guarda una sola operación que pasó por dos estados: primero Reservada, después Vendida. Esa operación queda registrada con: precio de publicación (USD 139.000), oferta del comprador (USD 130.000), seña (USD 5.000), precio de cierre (USD 128.000), comprador, propietario, asesor responsable, sucursal, fechas. Todo eso alimenta tus reportes de gestión y tu historial comercial.

2. ¿Para qué te sirve?

Las Operaciones existen porque, antes, Mapaprop solo guardaba el estado actual de cada propiedad (vendida, alquilada, etc) sin contexto. Con Operaciones ahora podés:

3. Cómo se compone una operación

Cada operación tiene 4 piezas de información:

3.1 Estado

Indica en qué momento del ciclo está la operación. Solo puede ser uno de estos:

⚠️ Una operación cerrada (Vendida / Alquilada / etc) NO se puede revertir. Si después la operación se cae, hay que crear una operación nueva con estado Caída. La cerrada queda como historial.

3.2 Tipo

Indica de qué tipo de transacción es. Se deriva automáticamente del tipo de operación que tenga la propiedad cargada (Venta, Alquiler, Temporario, Permuta).

3.3 Datos económicos

3.4 Participantes

• Vendedor / Propietario: quien estaba dueño del inmueble (de tu lista de contactos).
• Comprador / Inquilino: quien hizo la operación (de tu lista de contactos).
• Asesor responsable: el usuario de Mapaprop que abrió la operación.
• Sucursal: la sucursal a la que pertenece la operación (se hereda de la propiedad).

4. Dos modos para registrar una operación: Simple y Stats

Cuando cerrás una operación desde la ficha de una propiedad, se abre la ventana "Cierre de Operación". Ahí podés elegir entre 2 formas de registrarla:

4.1 Modo Simple

• ¿Qué hace? Solo cambia el estado de la propiedad (Reservada / Vendida / Alquilada / Suspendida) y opcionalmente registra un precio de cierre.
• ¿Qué NO hace? No guarda contactos, ni comisión, ni historial detallado. No genera operación trackeable en los reportes.
• ¿Quién lo usa? Inmobiliarias chicas que solo necesitan marcar el estado de sus propiedades sin preocuparse por reportes de gestión.
• Plan requerido: cualquiera (Free, Plus, Pro+, Business).

4.2 Modo Stats (recomendado)

• ¿Qué hace? Crea una operación completa con todos los datos: contactos, oferta, seña, cierre, comisión, comentarios. Después aparece en todos los reportes.
• Plan requerido: Business o Business Manager (planes 56 y 57).

4.3 Tabla comparativa

💡 Recomendación: si tenés Business, usá siempre Stats. Es la única forma de aprovechar los reportes de gestión.

4.4 Decisión por plan

5. Cómo registrar una operación paso a paso

5.1 Crear una reserva

1. Entrá a la ficha de la propiedad → botón "Cierre de Operación".
2. La ventana abre. Elegí "Reservada" entre las opciones de estado.
3. Si tenés Business, vas al wizard de 4 pasos:
   • Estado: ya elegiste Reservada.
   • Montos: ingresá la oferta del comprador. Si hubo seña, marcá el checkbox y poné el monto.
   • Participantes: vinculá vendedor y comprador desde tus contactos. Si todavía no están, podés crearlos en el momento.
   • Comentarios: opcional, para dejar contexto interno.
4. Click Guardar Operación.

La propiedad queda marcada como Reservada y aparece un chip rojo "Operación en proceso" en su ficha.

5.2 Cerrar la operación (Vendida / Alquilada / etc)

Hay 2 formas de llegar al cierre:

Opción A — Desde la ficha de la propiedad:

1. Click en "Gestionar Operación" (botón rojo). Te lleva al detalle de la operación reservada.
2. Ahí elegís el estado destino: Cerrar como Vendida / Cerrar como Alquilada / etc.
3. La ventana te pide solo el Precio de cierre (las otras secciones quedan colapsadas porque ya tenías los datos cargados).
4. Click Actualizar Operación.

Opción B — Desde la ficha de la propiedad directo:

1. Click en "Cierre de Operación".
2. Elegís el estado terminal directamente (ej: Vendida).
3. La ventana abre con los datos de la reserva pre-cargados. Completás cierre.
4. Guardar.

Después del cierre:

• La operación queda con estado terminal y fecha de cierre.
• La propiedad queda marcada como Vendida (o Alquilada si fue rent / temp / exchange).
• Se registra en el historial de precios de la propiedad.
• Aparece en el reporte de "Mis Operaciones" del asesor que cerró.

5.3 Cancelar una reserva (Caída)

Cuando una reserva no se concreta:

1. Desde la ficha de la propiedad → "Gestionar Operación" → estado Caída.
2. O desde el detalle de la operación → botón rojo "Cancelar reserva".
3. Guardar.

La operación pasa a Caída (no se puede revertir), la propiedad vuelve a Disponible automáticamente, y queda registrada como caída en los reportes (aporta a la "tasa de caída" del asesor).

5.4 Editar mientras la operación está en curso

Mientras la operación esté Reservada, podés editar todos los datos (montos, contactos, comisión, comentarios) sin cambiar el estado. Click "Gestionar Operación" → la ventana abre con secciones colapsables (Estado / Montos / Participantes / Comentarios) para editar lo que necesites.

5.5 Volver una propiedad a "Disponible"

Si una propiedad está reservada y el cliente cambió de opinión sin formalizar caída, NO podés mandarla directo a Disponible mientras tenga una operación en curso. Mapaprop te bloquea con un mensaje:

"Hay una operación reservada en curso. Para cambiar el estado de la propiedad tenés que resolverla desde Gestionar Operación o marcarla Caída."

Dos caminos:

• Click en "Marcar como caída" desde el mensaje de bloqueo → cancela la reserva y libera la propiedad de un solo click.
• Click en "Gestionar Operación" → resolver manualmente (cierre concretado o caída).

Esto evita que queden operaciones huérfanas (reservadas en el sistema pero la propiedad ya fue puesta a la venta de nuevo).

5.6 Cambiar el estado de una propiedad ya vendida/alquilada

Si la propiedad está vendida (operación cerrada) y querés volver a ponerla a la venta, podés:

1. Marcarla como Disponible desde la ficha (esto NO afecta la operación cerrada — sigue ahí como historial).
2. Crear una nueva operación cuando llegue otra reserva. El histórico te quedará con: deal viejo (vendido) + deal nuevo (reservado/cerrado/caído).

6. Los 6 reportes de operaciones

Todos accesibles desde el menú Panel → Reportes.

6.1 Todas las operaciones (/deals)

Listado completo y filtrable de todas las operaciones de tu cuenta.

• Filtros: período (desde/hasta), tipo de operación, estado, parte (vendedora/compradora — ver §7.9), origen (propia/externa/eliminada — ver §7.11), sucursal, asesor.
• Mini-cards arriba con 12 KPIs en vivo (ver §6.7) que respetan los filtros aplicados.
• Tabla con columnas: Propiedad, Contacto, Tipo, Parte (badge verde Vendedora / morado Compradora / gris Ambas), Origen (badge gris 🏠 Propia / morado 🔗 Externa / rojo 🗑️ Eliminada), Estado, Oferta, Cierre, Comisión, Fecha.
• Chips de filtros activos con X para quitar individualmente.
• Botón "+ Agregar operación" (admins): crea operación manual sin propiedad asociada (ver §7.10).
• Exportar a CSV para análisis externo (respeta los filtros).
• Mobile: cards en lugar de tabla.
• Quién lo ve: admins (main / manager). Los vendors son redirigidos automáticamente a "Mis Operaciones".

6.2 Mis Operaciones (/panel/deals/my-deals)

Dashboard personal del asesor. Pensado para que cada vendedor mida su performance.

• Identificación de tu sucursal arriba (logo o ícono + nombre + dirección + contacto).
• KPIs: reservas abiertas, cerradas en el período, comisiones ARS, comisiones USD.
• Tasas: cierre y caída.
• Listas rápidas: reservas abiertas + últimos cierres con click para ver detalle.
• Botón "+ Agregar operación": permite registrar una operación manual sobre una propiedad externa (ver sección 7.10).
• Quién lo ve: todos. Los vendors ven solo lo suyo automáticamente.

6.3 Oficina (/panel/deals/branch)

Stats consolidadas de tu inmobiliaria con ranking de asesores.

• Identificación de tu oficina arriba (logo + nombre + datos del customer).
• KPIs globales: reservas, cierres, comisiones, tasas.
• Ranking de agentes: tabla ordenada por cierres con volumen y tasa de cierre.
• Distribución por tipo de operación: barras visuales (venta / alquiler / etc).
• Cierres por mes: tabla de evolución temporal.
• Quién lo ve: admins (main / manager / adminMain). Los vendors no.

6.4 Red (/panel/deals/network)

Vista cross-office para gestores de redes de franquicias. Solo disponible en plan BusinessManager.

• KPIs agregados de toda la red.
• Ranking de franquicias: tabla con drill-down (click en una franquicia te lleva a su "Oficina").
• Quién lo ve: solo customer:manager (BusinessManager) + admin:main (soporte Mapaprop).

6.5 Captaciones (/panel/deals/captations)

Reporte de propiedades aprobadas por moderación y pendientes en el período.

• Captaciones aprobadas: cuántas propiedades nuevas pasaron el control de moderación.
• Pendientes: cuántas están esperando aprobación.
• Efectividad: % de captaciones que terminaron en cierre (cálculo aproximado).
• Cierres del período: para contraste.
• Tabla: detalle por propiedad.
• Quién lo ve: todos los roles.

ℹ️ Nota sobre efectividad: el cálculo es aproximado — divide cierres del período sobre captaciones del período sin verificar si los cierres corresponden realmente a las propiedades captadas. Es una guía, no un funnel exacto.

6.6 Brecha de Negociación (/panel/deals/brecha)

Tres métricas clave de tu negociación:

• Publicación a oferta: cuánto menos ofrecen los compradores respecto del precio publicado (en promedio).
• Oferta a cierre: cuánto se ajusta entre la oferta inicial y el cierre.
• Descuento final total: brecha total entre publicación y cierre.
• Seña promedio: % del cierre que se cobra como seña.

Solo cuenta operaciones con los 3 precios (publicación, oferta, cierre) en la misma moneda. Si tus operaciones tienen mix de monedas, el conteo será bajo.

• Quién lo ve: admins (main / manager / adminMain). Los vendors no.

6.7 Mini-cards de KPIs (en todos los reportes)

Arriba de cada listado de operaciones (/deals, my-deals, branch, network) hay una grilla de 12 mini-cards con métricas en vivo. Todas respetan los filtros aplicados (período, sucursal, etc.). Cada card tiene tooltip al hacer hover con la fórmula exacta del cálculo.

Fila 1 — Volumen y conteos:

Fila 2 — Performance + mix (solo aparece si hay deals cerrados):

💡 La fila 2 es nueva (mayo 2026). Si el período no tiene cierres, solo se muestra la fila 1.

7. Reglas importantes

7.1 Una sola reserva por propiedad

Cada propiedad puede tener una sola operación en estado Reservada al mismo tiempo. Si intentás crear una segunda reserva, el sistema usa la existente.

7.2 Las operaciones nunca se borran

Política firme. Una vez creada una operación, queda en el sistema para siempre. Razones:

• Las migraciones de plan no afectan tu historial (si pasás de Business a Free y volvés, recuperás todo).
• Los reportes de gestión necesitan series temporales largas.
• Auditoría comercial completa.

Si cargaste una operación por error, podés cambiarla a estado Caída con un comentario aclaratorio. No hay borrado físico.

7.3 Estados terminales no se reabren

Una vez que una operación pasa a Vendida / Alquilada / Caída / etc, ese estado queda fijo. Si necesitás registrar una nueva negociación sobre la misma propiedad, creás una operación nueva.

7.4 Las propiedades eliminadas conservan sus operaciones

Si eliminás una propiedad del sistema, las operaciones asociadas no se borran. Quedan accesibles desde el listado global con un snapshot de los datos básicos del inmueble (dirección, código, zona) pero marcadas como "(eliminada)".

7.5 Brecha de negociación: completá siempre el precio de cierre

Para que la brecha funcione bien, asegurate de siempre completar el campo "Precio de cierre" al cerrar una operación (es obligatorio en el flow Stats). El precio de oferta es opcional pero recomendado.

7.6 Operación en proceso bloquea cambios de estado de la propiedad

Si una propiedad tiene una reserva activa, no podés cambiar su estado a Disponible o Suspendida sin antes resolver la reserva (cerrarla como Vendida/Alquilada/etc o marcarla Caída). El sistema te avisa con un mensaje y te ofrece marcarla como caída en un solo click.

7.7 Tipo de operación se deriva del tipo de la propiedad

Cuando creás una nueva operación sobre una propiedad de alquiler, la operación nace con tipo "Alquiler" automáticamente. No tenés que elegirlo. Si la propiedad es de venta, nace como "Venta". Esto evita inconsistencias entre tipo de propiedad y tipo de operación.

7.8 Todo cierre nace desde una reserva

Regla: no podés cerrar una operación como Vendida / Alquilada / Permutada / Alquiler temporario directamente sobre una propiedad que está Disponible o Suspendida. Primero tenés que crear una Reserva, y desde ahí cerrarla.

Por qué: la reserva es el momento donde se registra la oferta, la seña (si hay), los participantes (vendedor + comprador) y la cotización del dólar al abrir. Sin esa info la operación cerrada queda incompleta y se pierde trazabilidad para reportes (brecha de negociación, comisiones, captaciones, etc).

Cómo funciona en la UI:

• En el modal "Cierre de Operación" sobre una propiedad disponible o suspendida, los cards de estados terminales (Vendida / Permutada / etc) aparecen deshabilitados en gris.
• Solo podés clickear Reservada o Suspendida desde una propiedad disponible.
• Una vez creada la reserva, vas a Ver Operación (/deals/[id]) y desde ahí encontrás el botón "Cerrar como X" (Vendida / Alquilada / Permutada / Temporario).

Excepción posible (en evaluación): alquiler temporario podría permitir cierre directo en el futuro porque suele cerrarse rápido sin negociación previa. Por ahora la regla aplica universal. Esta decisión queda anotada en el roadmap del producto.

Si necesitás registrar un cierre sobre una operación que ya pasó "fuera del sistema" (ej: cargás una venta histórica para reportes): creá la reserva con datos mínimos (oferta = precio de cierre, seña 0) y luego cerrala como Vendida. El proceso es de 2 clicks.

7.9 Punta vendedora vs compradora (pd_side)

Cada operación tiene un campo punta (pd_side) que indica el rol de tu inmobiliaria en esa transacción:

Cómo se asigna automáticamente al crear:

• Modal abierto desde la ficha de una propiedad de tu cuenta (o de tu agente) → la operación nace como seller_side.
• Modal abierto como operación manual sin propiedad (property externa) → la operación nace como buyer_side.

No hace falta que el usuario elija la punta: el sistema la infiere del contexto. Si en el futuro necesitás registrar ambas puntas, ese flujo quedará disponible.

Dónde lo ves en la UI: en la página /deals/[id] hay un chip que muestra "Punta vendedora", "Punta compradora" o "Ambas puntas" según el valor del campo.

Impacto en reportes: por ahora el campo es informativo. El cálculo de comisiones por punta (ej: media comisión para punta compradora, media para punta vendedora) es roadmap Fase E y no está implementado todavía.

7.10 Operación manual con propiedad externa

Cuándo usar: cuando la propiedad que estás trabajando no está cargada en tu cuenta Mapaprop. Por ejemplo:

• Llevás a un comprador a ver una propiedad de otra inmobiliaria.
• Trabajás en cobrokerage informal con un colega y querés dejar track de la operación.
• Registrás una venta histórica de una propiedad que nunca se publicó en tu plataforma.

Cómo crear una operación manual:

El botón abre el mismo modal de operación, pero en modo "manual" (sin propiedad de la cuenta vinculada).

Cómo se ve el modal en modo manual:

• Header: ícono morado 🔗 + título "Operación Externa" + badge morado "Punta compradora".
• Banner explicativo morado arriba: "Operación sobre una propiedad que no está en Mapaprop. Sos punta compradora..."

Qué pide el modal — campos obligatorios marcados con *:

1. Tipo de operación  (4 botones tipo card con ícono):
   • 🏷️ Venta
   • 🔑 Alquiler
   • 📅 Alquiler Temporario
   • 🔄 Permuta

   Los labels y orden vienen del sistema multi-país (mismo selector que ves al cargar una propiedad). Si en el futuro Mapaprop opera en otros países, los labels se traducen automáticamente.

2. Dirección de la propiedad  (input texto libre, max 255 caracteres). Ejemplo: "Av. Cabildo 1234, CABA". Sirve para identificar la operación en listados y reportes — sin esto el deal queda como "Sin dirección registrada".
3. Estado  (cards): solo aparecen Reservada y los terminales (Vendida / Alquilada / etc según el tipo elegido). Los cards Disponible y Suspendida se ocultan: no aplican a propiedades externas.
4. Oferta y montos: ídem operación normal (oferta, seña/reserva, cierre, comisión).
5. Participantes: selector de contactos para Vendedor/Propietario (la contraparte, suele ser un broker o el dueño directo) y Comprador/Inquilino (tu cliente). Ambos opcionales pero recomendados para trazabilidad. En modo externo el "vendedor" se cargan como contactos locales sin vincularse formalmente a una propiedad (no hay property en el sistema).
6. Comentarios: campo libre.

Limitaciones según rol:

Caso de uso típico para el vendor: "Acompañé a un comprador a ver un departamento de otra inmobiliaria, quedó interesado, lo reservé de manera informal. Quiero dejar track para no perder la operación." → creá una operación manual Reservada desde "Mis Operaciones". Cuando la operación se concrete, avisale a tu admin para que la cierre como Vendida o Alquilada.

Tip: si la contraparte es otra inmobiliaria o un broker colega, podés cargar ese contacto con tipo "Broker" (ver sección 8.5) y vincularlo al campo Vendedor de la operación. Así tenés trazabilidad de con quién trabajaste el cobrokerage.

7.11 Origen de la operación: Propia / Externa / Eliminada

Cada operación tiene un campo "Origen" que la clasifica en uno de tres tipos. Permite filtrar y entender de un vistazo qué tipo de operación estás mirando.

Filtrar por origen: en /deals el dropdown "Origen" tiene 4 opciones: Todos / Propia / Externa / Eliminada. Útil para:

• Ver solo operaciones manuales del período (origen Externa) y medir tu volumen de cobrokerage informal.
• Auditar operaciones huérfanas (origen Eliminada) y decidir si limpiarlas o conservarlas.
• Filtrar solo operaciones internas (origen Propia) para reportes "limpios" sin manuales ni huérfanas.

Ejemplo concreto:

• Llevaste un comprador a un departamento de Remax en marzo. Cargaste una operación manual desde "Mis Operaciones" → operación con origen Externa, punta Compradora.
• En abril cerraste una venta de tu propiedad código MP007 con un comprador habitual → origen Propia, punta Vendedora.
• En mayo eliminaste la propiedad MP007 del catálogo (decidiste no relistarla) → la operación de abril cambia a origen Eliminada automáticamente, pero conserva el código MP007 como dato histórico (snapshot).

💡 El origen lo asigna el sistema automáticamente. No es algo que cargues manualmente.

8. Casos especiales

8.1 Asesor sin sucursal asignada

Si un vendor del sistema no tiene sucursal asignada, puede acceder a Operaciones pero verá toda la cuenta (no se aplica el filtro por sucursal). Recomendación: siempre asignar sucursal al alta del asesor.

8.2 Bajaste de plan Business a Free/Plus

• Tus operaciones existentes no se borran, siguen en el sistema.
• Perdés acceso a los reportes de operaciones y al modo Stats.
• No podés crear operaciones nuevas (volvés al modo Simple, que solo cambia estado de propiedad).
• Si volvés a Business, recuperás el acceso completo y todas tus operaciones históricas.

8.3 Asesor de una sucursal mira propiedad de otra

Esto es común en redes con múltiples sucursales. El asesor:

• Sí puede ver el historial de operaciones de cualquier propiedad de la cuenta (lectura cross-branch).
• No puede ver el detalle de operaciones que no son de su sucursal (en su lugar ve "🔒 Nombre de la otra sucursal").
• No puede crear ni cerrar operaciones sobre propiedades de otras sucursales.

8.4 Migración de datos viejos sin tipo correcto

Si tenés operaciones cargadas antes de abril 2026, el campo "tipo" puede estar como "Venta" aunque la propiedad sea de alquiler (era un bug). Hay un script SQL que recalcula los tipos de operaciones viejas en base al tipo de la propiedad. Si necesitás que se aplique en tu cuenta, contactá a soporte.

8.5 Contactos broker (colegas inmobiliarios)

Cuando creás un contacto nuevo desde el CRM o desde el modal de operación, hay un selector "Tipo de contacto" con dos opciones:

Casos de uso del tipo Broker:

• Una inmobiliaria amiga que te trae compradores a propiedades tuyas (cobrokerage).
• Un colega de otra cuenta Mapaprop con quien compartís operaciones de vez en cuando.
• La contraparte vendedora en una operación manual: la property es de ellos, vos llevás el comprador.

Cómo aparece en el CRM: el tag "Broker" aparece automáticamente en el filtro de etiquetas del CRM junto con los tags habituales (Inquilino, Dueño, Interesado, etc). Podés filtrar todos tus brokers rápidamente para ver con quiénes tenés relaciones activas.

El tag Broker no reemplaza a los demás. Si un broker también es comprador en alguna operación, puede tener ambas etiquetas (la de Broker asignada al crear el contacto, y la de Interesado asignada al vincularlo a una propiedad).

9. Preguntas frecuentes

¿Por qué no puedo ver el botón "Cierre con Stats"? Tu plan no incluye Operaciones. Necesitás Business (servicio 56) o BusinessManager (servicio 57).

¿Por qué un asesor no ve "Todas las operaciones" en el menú? Por diseño. Los vendors ven solo "Mis Operaciones" (su versión filtrada por su sucursal y autoría). El listado global es para admins.

¿Por qué la brecha me da 0%? El reporte solo cuenta operaciones que tengan los 3 precios (publicación, oferta, cierre) en la misma moneda. Si tus operaciones tienen monedas mezcladas o falta alguno de los precios, no se cuenta. Asegurate de cargar siempre los 3 precios y mantener consistencia de moneda.

¿Puedo borrar una operación cargada por error? No. Cambiala a estado Caída con un comentario aclaratorio. Las operaciones nunca se borran.

Marco una propiedad como Vendida sin Stats. ¿Pierdo algo? Sí. El cambio queda en la propiedad (estado y precio de cierre) pero no genera operación trackeable: no aparece en los reportes, no aporta a la brecha, no hay registro de comprador/vendedor. Para gestión real, usá modo Stats.

¿Por qué el tipo de mis operaciones nuevas dice "Alquiler" cuando creo desde una propiedad de alquiler? Es el comportamiento esperado: el tipo se deriva del tipo de la propiedad. Antes de abril 2026 todas nacían como "Venta" (bug), ahora se infiere correctamente.

¿Puedo ver operaciones de propiedades que ya borré? Sí. En el listado global aparecen con un snapshot de los datos del inmueble y la nota "(eliminada)".

¿Cuándo aparece el botón "Marcar como caída" automático? Cuando intentás cambiar el estado de una propiedad reservada a Disponible o Suspendida sin cerrar la operación. El sistema lo detecta y te ofrece resolver con un click.

¿Para qué sirve el tipo de contacto "Broker"? Para distinguir a tus colegas inmobiliarios de tus clientes finales en el CRM. Un broker es alguien con quien co-trabajás, no un comprador o propietario. Al marcarlo como Broker al crear el contacto, se le asigna automáticamente la etiqueta "Broker" y aparece en el filtro de etiquetas del CRM.

¿Puedo crear una operación si la propiedad no está en mi cuenta? Sí. Es la operación manual (ver sección 7.10). La usás cuando trabajás de punta compradora sobre una propiedad de otra inmobiliaria o que no está publicada en Mapaprop.

PARTE 2 — Referencia Operativa (soporte / admins de cuenta)

Esta parte está pensada para soporte de Mapaprop, comercial, y admins de cuenta que necesitan responder consultas de clientes con precisión: quién puede hacer qué, qué requiere cada plan, y cómo se comportan las pantallas según el rol.

Para detalles técnicos (vendor isolation interno, backfills SQL, edge cases con SQL, changelog de commits), ver:

• mapaprop-deals-flow.md — flujo del código y casos límite técnicos
• mapaprop-deals-changelog.md — historial de cambios por sprint
• mapaprop-deals-architecture.md — decisiones de arquitectura

10. Roles del sistema

Mapaprop tiene 4 perfiles de acceso. La columna "rol del código" sirve solo para soporte que necesite leer logs o el sistema interno.

En esta doc, "admin" sin prefijo significa Admin Principal o Gestor de Red (ambos roles tienen permisos de gestión sobre la cuenta). "Admin Mapaprop" se llama explícitamente cuando aplica.

11. Matriz de permisos por acción

Reglas clave:

• El asesor solo abre reservas. No cierra ni cancela — esas decisiones las toma el admin de la cuenta.
• Las operaciones nunca se borran (política firme — ver §7.2). Para "anular" se usa estado Caída.
• El asesor puede leer historial de cualquier sucursal pero no puede modificar deals fuera de la suya.

12. Permisos por pantalla

Hub /panel/deals

Las cards del hub se gatean por rol:

Las cards aparecen visualmente para todos los planes (incluido Free), pero al hacer click sin Business se dispara el modal de upgrade.

/deals (Todas las operaciones)

/panel/deals/my-deals (Mis Operaciones)

Para el asesor, al usar "+ Agregar operación", el branchId se asigna automáticamente a su sucursal y el estado inicial solo puede ser Reservada.

/deals/[id] (Detalle de una operación)

Panel "Operaciones" en ficha de propiedad

El asesor lee el historial de cualquier propiedad de la cuenta, pero solo modifica deals de su sucursal.

Modal "Cierre de Operación"

¿Qué entry points lo abren y quién los ve?

¿Qué muestra el modal según plan y rol?

Detalles del comportamiento del modal:

• Tags en el header: el modal muestra el tipo de operación (Venta/Alquiler/etc.) y el tipo de propiedad (Departamento/Casa/etc.) como chips, derivados de la propiedad.
• "Oferta de reserva" + "Monto de reserva": al cerrar una reserva existente, la sección Montos muestra estos 2 campos (con fondo ámbar) como referencia.
• "Origen del Comprador": aparece dentro de Montos al cerrar una operación. Es opcional.
• "Cerrar como X" abre directo en Montos: al entrar desde un botón de cierre, la sección Estado queda colapsada (la decisión ya está tomada) y se abre directamente Montos para confirmar el precio de cierre.

Sub-reportes del hub

my-deals y branch tienen una franja de identificación arriba:

• my-deals: sucursal del asesor (logo o ícono + nombre + dirección + contacto).
• branch: oficina / customer (logo + nombre + datos).

13. Plan requerido

13.1 Sistema completo de Operaciones

Requiere plan Business (servicio 56) o BusinessManager (servicio 57).

Para Free / Plus / Pro+:

• El menú "Reportes de Operaciones" se ve, pero al click se dispara modal de upgrade.
• El botón "Cierre con Stats" en el modal de operación se bloquea con modal de upgrade.
• El backend rechaza endpoints del módulo de deals.

13.2 Modo Simple del modal

No requiere plan — disponible para todos. Es la única función del módulo de operaciones que es free. Solo cambia el estado de la propiedad (Reservada / Vendida / Alquilada / Suspendida) y opcionalmente registra precio de cierre. No genera deal trackeable, no aporta a reportes.

13.3 Por qué la decisión

El sistema de Operaciones existe principalmente para gestión comercial profesional: medir performance, ranking, brecha. Eso justifica el plan Business. Customers chicos que solo necesitan marcar una propiedad como vendida tienen el modo Simple.