La Pantalla Principal

Un Vistazo Rápido al Mercado

1. Inmediatamente después de una autenticación exitosa, el usuario no se encuentra con una simple lista de datos, sino con un panel de control (dashboard) diseñado para ofrecer una visión inmediata y estratégica del estado actual del mercado inmobiliario. La filosofía detrás de esta primera vista es actuar como un «resumen ejecutivo»: potente, conciso y optimizado para la rapidez.Por defecto, la aplicación carga únicamente las 3 propiedades más recientes para garantizar una experiencia de usuario ultrarrápida, evitando largos tiempos de espera. Veamos en detalle cada elemento que compone esta pantalla inicial.
   

   1. El Panel de Indicadores Superiores: El Pulso del Mercado

      En la parte superior de la vista principal, encontrarás tres indicadores clave que se calculan en tiempo real. Al entrar por primera vez (sin filtros aplicados), estos números reflejan la totalidad de la base de datos activa:

      1. Ofertas y Demandas Encontradas:

         Son dos contadores que muestran el número total de Ofertas (propiedades en venta/alquiler) y Demandas (clientes buscando propiedades) que hay en el sistema.

         Lógica: Estos números son dinámicos. En cuanto apliques un filtro (por ejemplo, «Piso» en «Palma»), se actualizarán instantáneamente para mostrar cuántas ofertas y demandas cumplen con ese criterio específico.

      2. Precio Medio (Filtros):

         Muestra el precio medio por metro cuadrado (€/m²) de todas las propiedades que se están mostrando en la lista. Inicialmente, es la media de toda la base de datos.

         Utilidad: Es un indicador rápido de la valoración general del mercado. Si filtras por una zona «prime», verás cómo este valor aumenta drásticamente, dándote una referencia inmediata del valor de esa zona.

      3. Precio Mediano (Filtros):

         Similar al precio medio, pero utiliza la mediana. La mediana es el valor que se encuentra justo en el medio de todos los precios ordenados.

         Decisión Técnica (¿Por qué los dos?): Incluimos la mediana porque es un indicador más robusto y realista que la media. No se ve afectado por valores atípicos extremos (por ejemplo, una mansión de 20 millones distorsionaría el precio medio, pero apenas afectaría al mediano). Comparar ambos te da una idea de la distribución de precios en el mercado.

   2. La Vista Previa y el Botón «Ver Todas»

      Justo debajo de los indicadores, verás un mensaje claro:

      • «Mostrando las 3 últimas propiedades registradas.»
      • «Para mejorar el rendimiento inicial, solo se muestra una vista previa.»
        

        Esta es una decisión de diseño deliberada para que la aplicación sea ágil. Debajo de este mensaje, se encuentra un botón clave:

      • Botón «Ver las [X] propiedades»: Este botón muestra el número total de propiedades que coinciden con los filtros actuales (que al inicio, es el total de la base de datos). Al

      hacer clic en él, la vista se expande para mostrar la lista completa de resultados, sin recargar la página.

   3. Anatomía de una Tarjeta de Propiedad: Entendiendo la Información

      Cada propiedad, ya sea oferta o demanda, se presenta en una «tarjeta» individual. Estas tarjetas están diseñadas para ofrecer la máxima información de un solo vistazo:

      1. Distinción Visual Inmediata:

         Ofertas: Tienen un fondo de tono verdoso/azulado (offer-bg) y una etiqueta de transacción (ej. «Venta») con un color corporativo (offer-badge).

         Representan propiedades que un agente tiene en cartera.

         Demandas: Tienen un fondo de tono neutro/grisáceo (demand-bg) y una etiqueta de transacción (demand-badge). Representan la necesidad de un cliente que un agente ha registrado.

      2. Etiquetas y Avisos Dinámicos (¡Clave para Oportunidades!):

         ¡BAJADA DE PRECIO! (Etiqueta roja animada): Este aviso aparece en las Ofertas cuando un agente edita la propiedad y reduce su precio. La etiqueta permanece visible durante 7 días y está diseñada para captar la atención.

         Lógica y Objetivo: Una bajada de precio es un evento comercialmente muy relevante. La aparición de esta etiqueta no solo alerta a otros agentes, sino que también dispara automáticamente un nuevo «cruce» de propiedades, notificando a agentes con demandas que ahora podrían ser compatibles con el nuevo precio.

         ¡SUBIDA DE PRESUPUESTO! (Etiqueta verde animada): Es el equivalente para las Demandas. Aparece cuando un agente edita una demanda para indicar que el presupuesto máximo de su cliente ha aumentado.

         Lógica y Objetivo: Al igual que la bajada de precio, este evento es crucial. Indica que el cliente puede acceder a un nuevo rango de propiedades. El sistema también lanza automáticamente un nuevo cruce para encontrar ofertas que antes estaban fuera de alcance.

         Indicador de Tendencia de Precio (+X% / -X%): En las ofertas, junto al precio, puede aparecer una pequeña etiqueta de color (roja, verde o azul).

         ¿Qué significa?

         Compara el precio por m² de esa propiedad con el precio medio histórico de propiedades del mismo tipo y en la misma localización.

         • Roja (Above): El precio está significativamente por encima de la media.
         • Verde (Below): El precio está por debajo de la media (potencial oportunidad).
         • Azul (Normal): El precio está en línea con la media del mercado.

      3. Contenido de la Tarjeta:

         Muestra claramente el tipo de propiedad, la localización, el precio, y un resumen de sus características principales (dormitorios, baños, superficie) con iconos intuitivos.

         Información del Agente: Muestra el nombre, la oficina y el teléfono del agente que la registró. El número de teléfono es un enlace directo para iniciar una conversación por WhatsApp, con un mensaje pre-rellenado para agilizar el contacto.

         Botones de Acción (Solo para el propietario): Si estás viendo una propiedad que tú mismo registraste, verás dos botones:

         • Editar (icono de lápiz): Abre el formulario para modificar la propiedad.
         • Enviar Cruces: Permite forzar manualmente la búsqueda de compatibilidades y el envío de notificaciones por email.
           

   4. El Panel de Filtros: Tu Herramienta de Búsqueda

      En la parte izquierda (en ordenadores) o accesible a través del botón «Buscar» (en móviles), se encuentra el potente panel de filtros.

      • Estado Inicial: Al entrar, todos los filtros están en su estado por defecto («Todos», rangos completos, etc.), por lo que ves todas las propiedades.
      • Funcionamiento Clave: La aplicación está diseñada para la inmediatez. En el momento en que modificas cualquier filtro (seleccionas un tipo de propiedad, ajustas el rango de precios, etc.), ocurren dos cosas automáticamente:
      1. La vista se expande para mostrar todos los resultados (equivale a pulsar el botón «Ver todas»).
      2. La lista de propiedades se actualiza en tiempo real para mostrar solo aquellas que cumplen con tus criterios. Los indicadores superiores (contadores, precio medio/mediano) también se recalculan al instante para reflejar solo los resultados de tu búsqueda.

   En resumen, la primera pantalla te da una bienvenida activa: te informa del estado general del mercado, te muestra las últimas novedades y te invita a explorar los datos con un sistema de filtros que responde de forma inmediata a tu curiosidad.

2. Añadir una Nueva Propiedad: El Formulario Inteligente.

Registrar una nueva propiedad o la necesidad de un cliente no es simplemente rellenar un formulario; es el primer paso para activar la red de colaboración. Por ello, el proceso está diseñado para ser rápido, intuitivo y, sobre todo, inteligente, ayudando al agente a evitar errores y a descubrir oportunidades desde el primer segundo.

1. El Proceso de Entrada de Datos

   Al hacer clic en el botón «Añadir Nueva Propiedad» (ya sea en la versión de escritorio o en la barra de controles móvil), se abre una ventana modal con el formulario de registro. Se encenderá una luz verde en la parte alta de la venta modal indicando que ya está conectado y preparado.

   Este formulario es el centro neurálgico para introducir tanto Ofertas (propiedades que un agente capta) como Demandas (necesidades de un cliente que busca).

2. Un Formulario que se Adapta a Ti (Lógica Dinámica)

   Una de las decisiones clave de diseño fue crear un único formulario que se transforma según el contexto, en lugar de tener dos formularios separados. Esto simplifica la interfaz y guía al usuario de manera más efectiva.

   1. Oferta vs. Demanda: El primer campo, «Tipo Gestión», es el más importante y cambia todo el comportamiento del formulario:

      Si eliges «Oferta»:

      • Los campos «Tipo de Propiedad» y «Localización» son selectores simples. Una oferta es una propiedad concreta, con un tipo y una ubicación únicos.
      • Las opciones de «Piscina» y «Parking» son específicas para propiedades existentes (Sí, No, Comunitaria).
        Si eliges «Demanda»: El formulario se adapta instantáneamente a la flexibilidad de la búsqueda de un cliente:
      • El campo «Tipo de Transacción» cambia a opciones como «Compra (demanda)» o «Alquiler (demanda)».
      • Los campos «Tipo de Propiedad» y «Localización» se convierten en selectores múltiples. Esto es fundamental, ya que un cliente puede estar buscando un «Piso» o un «Ático» en «Palma» o en «Calvià». Permite registrar toda la flexibilidad de su búsqueda en un solo registro.
      • Las opciones de «Piscina» y «Parking» cambian para incluir «No imprescindible», reflejando que un cliente puede ser flexible en estas características.
      • Campos específicos de una propiedad, como «Estado de Reforma» o «Tiene ETV» (EstanciaTurística en Viviendas), se desactivan, ya que no aplican a una búsqueda.

   2. Lógica por Tipo de Propiedad: El formulario también reacciona al tipo de propiedad seleccionado:

      Si se selecciona un tipo de propiedad que no suele tener dormitorios ni baños (como«Terreno»,«Solar», «Parking» o «Tras-tero»), los campos de «Dormitorios», «Baños», «Aseos», «Salas», «Antigüedad» y «Estado de Reforma» se desactivan y se resetean a cero automáticamente.

      Decisión Técnica (¿Por qué?):

      Esta validación proactiva previene la introducción de datos inconsistentes (ej. un terreno con 3 dormitorios). Asegura la calidad y coherencia de la base de datos desde el origen, lo que es crucial para que los filtros y las valoraciones funcionen correctamente.

3. Asistentes Inteligentes: Prevención de Errores y Duplicados

   Antes de que los datos lleguen a la base de datos, la aplicación realiza dos comprobaciones inteligentes para ayudar al agente:

   1. Detector de Duplicados (Paso 1 de la Validación):

      Al intentar guardar, el sistema compara la nueva entrada con las existentes basándose en una combinación de factores: tipo de gestión, tipo de transacción, precio (con una tolerancia del 5%), tipo de propiedad, localización y número de dormitorios.

      Si encuentra coincidencias: En lugar de guardar directamente, se abre una ventana de advertencia de «Posible Propiedad Duplicada». Esta ventana muestra una lista de las propiedades similares encontradas, incluyendo quién es el agente que las registró.

      El Objetivo de la Colaboración: Junto a cada propiedad duplicada, hay un botón para contactar directamente por WhatsApp con el otro agente. El mensaje viene pre-rellenado para agilizar la comunicación. El objetivo no es solo evitar duplicados, sino fomentar la colaboración inmediata. Un agente puede descubrir que otro colega ya tiene la propiedad que él iba a registrar, o una demanda que encaja con su nueva captación.

      El usuario puede entonces cancelar el registro o, si está seguro de que no es un duplicado, pulsar «Guardar de todos modos».

   2. Advertencia de Precio Elevado (Paso 2 de la Validación):

      Si no se encuentran duplicados, la aplicación realiza una segunda comprobación (solo para las «Ofertas»). Calcula el precio por metro cuadrado (€/m²) de la nueva propiedad y lo compara con el precio medio histórico de propiedades del mismo tipo y en la misma localización.

      Si el precio es significativamente superior (por defecto, un 20% por encima de la media), se abre una ventana de advertencia informando de esta desviación.

      Decisión Técnica (¿Por qué?):

      Este mecanismo actúa como un «guardián» de la calidad de los datos. Ayuda a prevenir errores de introducción (ej. un cero de más en el precio) y fomenta que los agentes introduzcan precios de mercado realistas, lo que mejora la fiabilidad de toda la base de datos y de las herramientas de valoración.

      El agente debe confirmar activamente que desea guardar la propiedad con ese precio.

4. El Proceso de Guardado: Del Formulario a la Base de Datos

   Una vez superadas las validaciones (o confirmadas por el usuario), el proceso de guardado es seguro y robusto:

   1. Empaquetado de Datos: La aplicación prepara los datos del formulario.
   2. Autenticación Segura: Adjunta el Token de Identidad del usuario a la petición. Este token es la prueba criptográfica de que el usuario es quien dice ser.
   3. Comunicación con el Backend: Envía toda la información al Google Apps Script (el backend). La aplicación web nunca escribe directamente en la base de datos.
   4. Validación en el Servidor: El script vuelve a validar el token para asegurarse de que la petición es legítima y que el usuario tiene permisos.
   5. Escritura y Generación de Datos: Si todo es correcto, el script:
      • Añade un nuevo registro.
      • Genera un ID único para la propiedad.
      • Estampa la fecha y hora exactas de la inserción.
      • Registra la acción para auditoría.

5. La Magia Post-Guardado: Cruces Automáticos e Inmediatos

Aquí es donde la aplicación demuestra su verdadero poder colaborativo. Inmediatamente después de que el script guarda la nueva propiedad, lanza automáticamente el motor de «cruces»:

• Analiza la nueva propiedad y busca en toda la base de datos registros del tipo opuesto que sean compatibles (ej. si se añadió una Oferta, busca Demandas que encajen en precio, tipo y zona).
• Si encuentra coincidencias, agrupa los resultados por agente y envía correos electrónicos de notificación automáticos a los agentes implicados, informándoles de la nueva oportunidad.

El resultado es que, segundos después de registrar una propiedad, un agente puede recibir un email con un cliente potencial de otro compañero, sin que ninguno de los dos haya tenido que hacer una búsqueda manual.

Esto maximiza la eficiencia y asegura que ninguna oportunidad se

pierda.

En resumen, el proceso de añadir una propiedad es un flujo de trabajo guiado e inteligente que no solo captura datos, sino que los valida, los enriquece y los pone a trabajar para toda la red de agentes de forma instantánea.