Onde:
Plataforma Inmobiliaria con IA
Un marketplace inmobiliario full-stack con capacidades avanzadas de búsqueda por IA, descubrimiento semántico de propiedades y asistencia de chat inteligente. Construido con un enfoque de arquitectura dual moderna que combina APIs REST tradicionales con funciones serverless edge.
🤖 Integración de IA y Machine Learning
Integración con OpenAI
► GPT-4o-mini para chat conversacional con IA y clasificación de intenciones
► API de Visión GPT-4o para análisis automatizado de imágenes de propiedades, extrayendo descripciones visuales detalladas de interiores, exteriores, colores, materiales y características arquitectónicas
► text-embedding-3-small (1536 dimensiones) para embeddings de texto de propiedades
► text-embedding-3-large (3072 dimensiones) para embeddings de imágenes y documentos
► Extracción inteligente de filtros desde consultas en lenguaje natural
► Recomendaciones de propiedades conscientes del contexto
Pipeline de Búsqueda Semántica
► Pipeline de procesamiento de IA multi-etapa con tiempo de respuesta <3s
► Clasificación de intenciones y extracción de filtros en paralelo
► Modo de búsqueda visual para consultas como "casas con pisos verdes" o "propiedades con jardines"
► Integración de búsqueda por proximidad a POI (Puntos de Interés)
► Construcción inteligente de contexto desde coincidencias vectoriales
Salida de Datos Estructurados
► Validación de esquemas con Zod para respuestas de API
► Extracción de filtros type-safe con interfaces TypeScript explícitas
► Respuestas JSON estructuradas desde modelos de IA usando function calling
► Detección determinística de referencias a propiedades ("la primera", "esa")
🗄️ Base de Datos Vectorial y Embeddings
Base de Datos Vectorial Pinecone
► Tres índices especializados para diferentes tipos de contenido:
► Índice de Propiedades (text-embedding-3-small, 1536 dim): Descripciones, direcciones, características
► Índice de Imágenes (text-embedding-3-large, 3072 dim): Análisis visual de fotos de propiedades
► Índice de Documentos (text-embedding-3-large, 3072 dim): Planos, contratos, certificados
► Búsqueda vectorial paralela en todos los índices
► Filtrado por metadatos (precio, habitaciones, ubicación, amenidades)
► Deduplicación por property_id
► IDs de vectores basados en hash para operaciones idempotentes
Sistema de Generación de Embeddings
► Procesamiento batch automatizado (5 imágenes en paralelo, hasta 50 imágenes por propiedad)
► IDs de vectores determinísticos basados en hash SHA-256 para prevenir duplicados
► Análisis de imágenes con prompts detallados para características exteriores/interiores
► Fragmentación de texto de propiedades con división semántica de oraciones
► Generación async de embeddings fire-and-forget con seguimiento de errores
☁️ Supabase Edge Functions (Deno)
Orquestador principal de chat IA
► Pipeline de procesamiento de 5 pasos optimizado para rendimiento
► Clasificación de intenciones y extracción de filtros en paralelo
► Coordinación de búsqueda vectorial entre índices de Pinecone
► Generación de respuestas GPT-4o-mini con consciencia de contexto
► Gestión de historial de conversaciones con seguimiento de sesiones
Servicio de generación de embeddings
► Integración de OpenAI Vision API para análisis de imágenes
► Distribución de embeddings multi-índice
► Normalización automática de metadatos
► Procesamiento de texto basado en chunks
► Almacenamiento de documentos en Supabase con generación de previews
Parser de consultas en lenguaje natural
► Clasificación de intenciones (búsqueda, POI, comparar, actualizar_filtros)
► Extracción estructurada de filtros desde lenguaje natural
► Etiquetado de filtros IA (pet-friendly, cocina-moderna, barrio-tranquilo)
► Búsqueda de regiones con matching case-insensitive en base de datos
► Detección de referencias a propiedades
Coordinador de búsqueda semántica
► Generación paralela de embeddings (modelos small + large)
► Búsqueda vectorial multi-índice
► Obtención de propiedades PostgreSQL con filtrado por región
► Deduplicación y scoring de resultados
► Integración de Google Places API para consultas de POI
🗺️ Integración de Mapas
Google Maps API
► Places API para búsqueda de proximidad a POI
► Geocoding para validación de direcciones
► Cálculos de matriz de distancias
► Estimaciones de tiempo caminando
► Detalles de lugares con ratings y reseñas
🏗️ Arquitectura y Backend
Sistema de Arquitectura Dual
API Express.js (Node.js)
► Endpoints REST para operaciones CRUD de propiedades
► Integración JWT + Supabase Auth
► Chat en tiempo real con Socket.io y Redis pub/sub
► Clustering de workers con pools de conexiones por worker
► Protección CSRF y middleware de seguridad
Deno Edge Functions (Supabase)
► Chat IA serverless y búsqueda semántica
► Deployment edge de baja latencia
► Estrategia de caching multi-tier (FIFO en memoria)
► Escalado automático y optimización de cold start
Base de Datos y Almacenamiento
► PostgreSQL con PostGIS para consultas geoespaciales
► Query builder type-safe Kysely
► Connection pooler para escalado en producción
► Supabase Storage para imágenes de propiedades
► Redis para caching y pub/sub
Optimizaciones de Rendimiento
► Caching multi-tier (embeddings: 24h, propiedades: 10min, búsquedas: 5min)
► Procesamiento batch paralelo para embeddings de imágenes
► Inputs de búsqueda con debounce (500ms)
► Prefetching de resultados de consultas al hacer hover
► Persistencia de historial de chat en localStorage
🎨 Stack Frontend
React 19 + TypeScript + Vite
► Patrones modernos de React con hooks
► Desarrollo type-safe con TypeScript estricto
► HMR rápido con Vite
Gestión de Estado
► TanStack Query v5 para estado del servidor
► Actualizaciones optimistas para favoritos y ofertas
► Caching inteligente con configuración staleTime
► URL params como única fuente de verdad para estado de búsqueda
UI y Estilos
► Tailwind CSS para estilos utility-first
► Librería de componentes ShadcnUI + Radix UI
► Sistema de diseño personalizado (fuentes Montserrat, Saira, Inter)
► Diseño responsive con enfoque mobile-first
Funcionalidades Clave
► Búsqueda conversacional potenciada por IA con historial de chat persistente
► Chat de propiedades en tiempo real con Socket.io
► Tarjetas de propiedades interactivas con links clickeables al chat IA
► Búsqueda basada en región y radio
► Modal de filtros avanzados con amenidades y condiciones
► Propiedades favoritas con actualizaciones optimistas
► Sistema de negociación de ofertas
► Programación de visitas
🔧 Experiencia de Desarrollo
Type Safety
► Cobertura TypeScript de punta a punta
► Tipos de base de datos generados con Kysely
► Validación runtime con Zod
► Configuración estricta de ESLint + Prettier
Build y Deploy
► Path aliases para imports limpios (@/, @controllers/, @services/)
► Configuración basada en environment
► Hot reload en desarrollo
► Clustering en producción con graceful shutdown
Testing y Monitoreo
► Logging detallado en consola en edge functions
► Logging estructurado con Winston en Express
► Tracking de rendimiento (clasificación de intenciones, tasas de cache hit)
► Manejo de error boundaries
📊 Métricas Técnicas
► Tiempo de Respuesta IA: <3 segundos end-to-end
► Procesamiento de Embeddings: 5-10 minutos para 50 imágenes (batch paralelo)
► Búsqueda Vectorial: <500ms en 3 índices de Pinecone
► Tasa de Cache Hit: ~70% reducción en consultas repetidas
► Consultas a BD: Type-safe con tiempo de respuesta <100ms
► Chat en Tiempo Real: Entrega de mensajes sub-segundo con Socket.io
🚀 Funcionalidades Innovadoras
1. Chat IA con Memoria - Historial de chat persistente usando localStorage, contexto de referencias a propiedades
2. Búsqueda Visual Semántica - "Mostrame propiedades con cocinas de mármol" usando embeddings de imágenes
3. Regiones en Lenguaje Natural - "Propiedades en Avenidas Novas" auto-completa la selección de región
4. Detección Inteligente de Filtros - Extrae precio, habitaciones, amenidades de consultas conversacionales
5. Links de Propiedades Clickeables en Chat - Navegar a detalles de propiedades directamente desde respuestas IA
6. Embedding Batch Paralelo - Procesar 50 imágenes en 5-10 minutos con deduplicación
7. Búsqueda Vectorial Multi-Índice - Combina embeddings de texto, imagen y documentos para resultados completos
8. Inteligencia de Proximidad a POI - "Propiedades cerca de hospitales" con cálculos de distancia caminando