Propuesta funcional — Sistema de gestión inmobiliaria

v2 · incorpora el flujograma del cliente

Pessi: mapa del sistema

Revisamos el flujograma (Excel) que nos pasó el cliente y lo cruzamos con la v1. La estructura general se mantiene — nube, app web + Android, dashboard gerencial — pero el cliente separa el negocio en tres líneas con reglas propias: Alquiler, Administración de propiedades y Venta, cada una con su propia ficha, acuerdo y estados. Esta versión lo incorpora.

Qué cambia respecto a la v1

Se mantiene

  • Nube como base única de datos
  • App Web + Android + dashboard gerencial
  • Publicación en portales, redes y MercadoLibre
  • Agenda por usuario + vista gerencial

Se agrega

  • Línea de negocio "Administración de propiedades" (cobro para terceros)
  • CRM de Clientes, separado del maestro de propiedades
  • Ficha de carga en dos pasos: ingreso preliminar → ficha completa
  • Máquina de estados por operación (Ingresado → … → Liquidado)
  • Autogestión: el propietario ve sus liquidaciones online

Se ajusta

  • "Comisiones" se abre en dos modelos: comisión (venta/alquiler) vs. tarifa de cobro (administración)
  • El contrato pasa a ser un "Acuerdo" tipado por línea de negocio, no genérico
  • Cliente y Propietario dejan de ser maestros separados: son roles de una misma Persona

1. Arquitectura general

Sigue siendo válida: agentes (web/Android) y gerencia (dashboard) leen y escriben sobre la misma base en la nube. Lo que cambia puertas adentro del núcleo se detalla en el diagrama 2.

USUARIOS PLATAFORMA CENTRAL — NUBE CANALES EXTERNOS App Web Agentes comerciales App Android Uso en terreno / visitas Dashboard gerencial Vista consolidada sincronización en tiempo real Propiedades y personas Maestro de propiedades Personas (con roles) Un registro, no propietario ≠ cliente Negocio Alquiler · Administración · Venta Acuerdos, estados, comisiones → ver diagrama 2 Agenda y flujo de trabajo Agenda por usuario Agenda visible p/ gerencia Avisos de vencimiento Marketing digital Descripciones y placas Campañas y posicionamiento Medición de resultados Almacenamiento en la nube — sin servidor propio publica leads Sitio web propio Redes sociales Portales (InfoCasas, Gallito…) MercadoLibre
El núcleo ahora tiene un módulo "Propiedades y personas" y un módulo "Negocio". El primero agrupa el maestro de propiedades y un único registro de personas — la misma persona puede ser propietaria de una propiedad y, a la vez, cliente interesada en otra, sin duplicar la ficha. El segundo abre en las tres líneas que exige el cliente — alquiler, administración y venta.

2. Tres líneas de negocio, un mismo origen

Esto es lo que trae el flujograma del cliente y la v1 no tenía: alquiler, administración de propiedades (cobro por cuenta de terceros) y venta comparten el maestro de propiedades y el CRM de clientes, pero de ahí en más cada línea tiene su propia ficha, su propio acuerdo y su propio cierre.

ORIGEN COMPARTIDO Maestro de propiedades Ingreso preliminar → Ficha completa Personas Un registro por persona/empresa Roles sobre esa persona Propietario · Interesado · Inquilino · Comprador TRES LÍNEAS DE NEGOCIO Alquiler Administración Venta Captación alquileres Negocio de alquiler Captación para administrar Negocio de administración Captación para venta Negocio de venta Acuerdo Alquiler Comisión (monto o %) Acuerdo Administración Tarifa de cobro Acuerdo Venta Comisión (monto o %) Estados: 6 pasos Ingresado → … → Liquidado Estados: 5 pasos Ingresado → … → Finalizado Estados: 6 pasos Ingresado → … → Liquidado detalle en el diagrama 3 Operaciones: cobro, renovación, gastos de mantenimiento ingresos − egresos = a pagar Liquidado Factura de comisión Liquidado Factura de comisión + facturación electrónica Liquidación mensual por propietario Autogestión: el propietario ve su liquidación online
Administración es la línea nueva y la más distinta de las tres. No termina en una comisión única: genera una liquidación mensual recurrente por propietario (cobro − gastos = a pagar) y ese propietario puede entrar a ver su propia liquidación sin pasar por un agente. Y como propietario y cliente son roles de la misma persona, si ese mismo propietario llama para alquilar algo para él, no se carga de nuevo: se le agrega el rol sobre su registro existente.

Decisión: una propiedad puede tener varias operaciones a la vez

El diagrama de arriba dibuja alquiler, administración y venta como tres carriles paralelos, pero eso describe el flujo de cada operación, no dice que una propiedad deba elegir uno solo. En la realidad, "vendo o alquilo" es un caso frecuente: una misma propiedad puede tener una operación de Alquiler y una de Venta abiertas al mismo tiempo (o, si el propietario cambia de idea durante la administración, pasar a tener también una operación de Venta activa). El modelo de datos correcto es Propiedad 1 → N Operaciones, cada Operación con su propia línea, su propio Acuerdo y su propia máquina de estados — nunca "esta propiedad es de alquiler" como atributo fijo de la ficha.

3. Estados de una operación

El cliente define el ciclo de vida como una máquina de estados explícita, no solo "publicado / no publicado". Alquiler y venta comparten los mismos 6 estados; administración usa una variante de 5 pensada para un vínculo continuo, no para un cierre puntual.

ALQUILER / VENTA ADMINISTRACIÓN Ingresado Autorizado En reserva Reservado Proceso de firma Liquidado Ingresado Autorizado Activo Renovado vuelve a Activo Finalizado
Administración no "termina": se renueva. A diferencia de alquiler y venta, que cierran en un pago único liquidado, "Renovado" vuelve a "Activo" — es el estado que sostiene la liquidación mensual recurrente por propietario.

4. Flujo de una propiedad en alquiler

Se mantiene igual que en la v1 — sigue siendo el mejor ejemplo end-to-end. El paso 4 ("Gestión del alquiler") es ahora, en detalle, el "Acuerdo Alquiler" + los 6 estados del diagrama 3.

1 Captación Visita, ficha, fotos, cartel 2 Carga al sistema Ficha + descripción 3 Publicación Web, portales, redes, MELI 4 Gestión del alquiler Acuerdo + estados (dg. 3) 5 Seguimiento Agenda + alertas de vencimiento 6 Renovación o cierre Contrato y comisión final aviso: contrato/pago por vencer Notificación automática a agente y gerencia Cada paso actualiza el inventario de la propiedad (fotos, documentos, estado) y queda visible para gerencia en tiempo real.
El vencimiento es el disparador, no un recordatorio manual. Cuando el contrato o un pago se acerca a su fecha, el sistema avisa a agente y gerencia; desde ahí se decide renovar (vuelve al paso 4) o cerrar la ficha.

5. Flujo detallado de alquiler, paso a paso

La versión de bolsillo de la sección 4, abierta en los nueve pasos reales: cuándo se toca el maestro de Personas, cuándo cambia el rol de alguien, cuándo se dispara la alerta de vencimiento, y qué decisión hay que tomar al final.

CAPTACIÓN Y PUBLICACIÓN 1 Captación Propietario: alta o reutiliza Persona existente 2 Ficha completa + Acuerdo Alquiler (comisión, forma de pago) 3 Publicación Web, portales, redes, MercadoLibre 4 Interesados Cada consulta: Persona con rol "Interesado" 5 Reserva y garantía Interesado → rol "Inquilino" FIRMA, COBRO Y SEGUIMIENTO 6 Firma Contrato + inventario → guardados en la nube 7 Liquidación Factura de comisión 8 Seguimiento Alerta automática de vencimiento (agente + gerencia) 9 · Decisión Renovar → vuelve al paso 6 Cerrar → propiedad queda libre otra vez
Los pasos 4 y 5 son donde más se nota el modelo de Personas con roles. Un interesado no es un maestro aparte: es la misma Persona a la que, si avanza, se le agrega el rol de Inquilino sobre esta operación puntual — sin perder que además pueda ser propietaria de otra propiedad en paralelo.

6. Módulos funcionales — detalle

Checklist actualizado con lo que trae el flujograma del cliente: se suman ficha de propiedad, CRM de clientes, administración y autogestión de propietarios. Los campos de la ficha de propiedad se completaron además tomando como referencia arquibrokers.com — tipo de propiedad, ambientes, superficie cubierta/total, amenities y apto crédito no estaban en el flujograma original y el cliente los validó como una buena adición.

Captación y ficha

  • Visita al inmueble
  • Ingreso preliminar → ficha completa
  • Fotos, metraje, padrón, características
  • Cartel cuando corresponda

Ficha de propiedad

  • Tipo de propiedad: apartamento, casa, local, oficina, chacra, terreno
  • Propietario, dirección, edificio, unidad, barrio
  • Ambientes (total) y dormitorios, baños, garage, orientación
  • Dormitorios en suite: sí/no + cantidad
  • Superficie cubierta y superficie total (m²)
  • Terraza, patio, parrillero, mascotas, antigüedad
  • Amenities: checklist (piscina, gimnasio, seguridad 24hs, ascensor, cochera, sauna, SUM, aire acondicionado, amoblado, vista al mar…)
  • Apto crédito bancario: sí/no
  • Aspiración de alquiler / venta, con moneda (UYU / USD), fotos
  • Otros: campo libre para lo que no esté en la lista fija

Personas y roles

  • Un registro por persona o empresa, se carga una sola vez
  • Roles acumulables: propietario, interesado, inquilino, comprador
  • La misma persona puede tener varios roles a la vez
  • Historial completo aunque cambie el motivo de contacto
  • Datos base: nombre, documento de identidad, teléfono, email
  • Como interesado/comprador: qué busca, presupuesto, zona de interés
  • Como inquilino: garantías y referencias

Comercialización

  • Redacción de descripción
  • Publicación web, portales, redes y MercadoLibre

Ventas y alquileres

  • Acuerdo tipado por línea de negocio
  • Estados: Ingresado → … → Liquidado
  • Búsquedas cruzadas entre colegas

Administración de propiedades

  • Cobro de alquiler, renovación, gastos de mantenimiento
  • Ingresos − egresos = a pagar al propietario
  • Liquidación mensual por propietario
  • Tarifa de cobro (no comisión única)

Autogestión de propietarios

  • El propietario ve sus liquidaciones online
  • Similar a una consulta de empresas

Comisiones y ganancias

  • Comisión (monto o %) para venta y alquiler
  • Factura de comisión + facturación electrónica
  • Reporte de ganancias por agente / oficina

Marketing digital

  • Posicionamiento de marca
  • Campañas por portal
  • Placas y avisos, medición de resultados

Agenda y avisos

  • Registro de visitas (agenda)
  • Agenda por usuario + vista gerencial
  • Avisos automáticos de vencimiento

Dashboard gerencial

  • Estado comercial en tiempo real
  • Seguimiento de agendas del equipo
  • Comisiones, tarifas y ganancias consolidadas
Cloud storage App Web App Android API MercadoLibre Multi-portal Multi-usuario Multi-línea de negocio

Decisión: la ficha de propiedad es una sola, para las tres líneas

El Excel original del cliente, en la hoja "Ficha para ingresos", lista menos campos para Venta que para Alquiler — a Venta le faltan orientación, aptos por piso, cantidad de pisos, parrillero, mascota, antigüedad, garantía y nombre de administración. Al revisarlo, el cliente aclaró expresamente que para él los atributos de la propiedad son los mismos sin importar la línea de negocio — la ficha no cambia según sea alquiler, administración o venta, solo cambia el campo de aspiración (alquiler / venta) y los datos del acuerdo comercial. Queda así, como definición explícita del cliente, no como supuesto nuestro: una única Ficha de propiedad, tal como está en la sección 6, sin variantes por línea.

7. Preguntas abiertas

El propio flujograma del cliente deja puntos marcados con signos de interrogación. Las sumamos a las nuestras para resolver antes de definir modelo de datos y pantallas.

?

Publicación en portales, ¿manual o vía API? El flujograma marca "Publicar web y portales" con cinco signos de pregunta, y en el maestro de propiedades vuelve a aparecer como "Publicar web y portales — API". Define si la integración (MercadoLibre incluido) es automática o carga asistida. Fuente: Flujograma.xlsx — hoja "Flujograma"

?

Costos — ¿de qué? Aparece como nota suelta junto al cierre de venta ("Costos?"), sin precisar si se refiere a costos operativos de la inmobiliaria, costos a cargo del propietario, o gastos a descontar en la liquidación de administración. Fuente: Flujograma.xlsx — hoja "Flujograma"

?

Facturación electrónica y forma de pago: el flujo la marca como paso separado, con "propietario e inquilino si aplica" y "opcional" junto a la forma de pago. Conviene confirmar si la facturación electrónica es obligatoria desde el día uno o si arranca opcional.

?

Alcance de la app Android: ¿la usan también los propietarios para la autogestión, o queda reservada a agentes y la autogestión es solo web?

?

Split de comisión entre agentes: el flujograma habilita "búsqueda entre colegas" — si dos agentes intervienen en una operación, ¿cómo se reparte la comisión o la tarifa de cobro?

8. A resolver antes de desarrollar

Tres puntos que marcamos como importantes para definir junto con el proveedor antes de que arranque el desarrollo — no son detalles de diseño, son decisiones que cambian el alcance o el costo.

!

Seguridad de acceso: MFA y expiración de sesión. Definir si el segundo factor (tipo Google Authenticator) es obligatorio para todos los usuarios o solo para gerencia/administración, y cómo expira la sesión — ¿24 horas fijas, o por inactividad? Nuestra recomendación: MFA obligatorio para gerencia y administración (acceso a comisiones y liquidaciones), opcional para agentes de campo. Para la sesión, combinar las dos cosas en vez de elegir una: una sesión "de trabajo" que dura hasta 24 h desde el login, más un cierre automático por inactividad — corto (15–30 min) en las pantallas financieras y de administración, más largo en el resto. Un solo timeout fijo de 24 h sin control de inactividad deja una sesión abierta toda la jornada en un dispositivo que alguien más puede tomar.

!

Publicación en MercadoLibre. Ya lo marcamos como pregunta abierta en la sección 7, pero lo repetimos acá porque define alcance y costo: ¿integración automática vía API (sincroniza precio, estado y fotos) o carga manual asistida? Confirmar también si el plan de MercadoLibre que va a usar la inmobiliaria admite integración por API — no todos los planes la incluyen.

!

Guardado de contratos en la nube. Definir el detalle de cómo se almacenan (Acuerdo Alquiler, Acuerdo Administración, Acuerdo Venta y su documentación adjunta): acceso por URL firmada con expiración — nunca en un bucket público —, quién puede ver el documento de qué operación (agente asignado, gerencia, y el propietario en autogestión, cada uno con su alcance), y por cuánto tiempo se retiene un contrato después de "Liquidado" o "Finalizado".

!

Auditoría de negocio y log de sistema — son dos cosas distintas. Requisito del cliente, no solo recomendación nuestra: todo cambio de estado de una operación (Ingresado → Autorizado → … → Liquidado, y lo mismo para Administración) tiene que quedar auditado — quién lo cambió, cuándo, y desde/hacia qué estado. Lo mismo para cambios sobre el Acuerdo (comisión, tarifa, montos) y para el traspaso de una tarea entre áreas (ver el mapa del sistema completo) — eso es auditoría de negocio. Aparte, conviene un log de sistema más amplio y técnico: inicios de sesión, documentos subidos, ediciones de ficha, cambios de permisos. Los dos registros deberían ser de solo lectura incluso para quien hizo el cambio — si se pueden editar o borrar, dejan de servir como auditoría.

!

Calendario por usuario, con vencimientos y anotaciones diarias. Cada agente necesita su propio calendario — no solo turnos de visita, también anotaciones libres día a día (llamadas a hacer, seguimientos, recordatorios propios) además de los vencimientos automáticos de contratos y pagos. El usuario principal / administrador tiene que poder ver los calendarios de todos los agentes, individualmente o combinados, sin que cada agente tenga que compartírselo a mano. Definir si las anotaciones personales de un agente son privadas para gerencia o también visibles — probablemente el contenido libre debería ser propio, y solo los eventos ligados a una operación (visitas, firmas, vencimientos) visibles para gerencia.

!

Menú y permisos por línea de negocio. El sidebar del prototipo ("Pessi Studio") hoy muestra todo a cualquier usuario. En la versión real, lo que cada usuario ve tiene que depender de a qué línea está asignado: un usuario de Administración vería solo ese menú y esas propiedades; uno General (gerencia) vería todo; uno de Alquiler solo alquiler; uno de Venta solo venta. Y no son categorías cerradas — un mismo agente puede estar asignado a más de una línea a la vez (Venta y Alquiler, o Venta y Administración), y eso tiene que reflejarse mostrándole la unión de esos menús, no una sola línea fija. Queda pendiente de resolver en conjunto: el modelo de permisos (roles fijos vs. una lista de líneas asignadas por usuario) y cómo se combina con los roles de seguridad de la nota anterior (gerencia/administración con MFA obligatorio).