Documentacion Tecnica

MaxLeadsNow es una plataforma de inteligencia territorial B2B que combina busqueda de negocios en tiempo real con analisis geoespacial. Disenada para equipos de ventas que necesitan reconocimiento territorial sistematico.

La plataforma permite a representantes y gerentes de ventas identificar oportunidades comerciales en cualquier zona geografica, analizar la densidad y calidad de negocios existentes, y convertir esos datos en leads accionables para su pipeline de ventas.

El sistema esta construido sobre una arquitectura moderna de aplicacion web con renderizado hibrido (servidor y cliente).

El procesamiento geoespacial incluye calculo de areas geodesicas, deteccion de puntos dentro de poligonos (point-in-polygon) y generacion de metricas de densidad en tiempo real.

El motor de busqueda de negocios permite consultar un indice actualizado con millones de establecimientos registrados. La busqueda avanzada acepta los siguientes parametros:

Estructura de respuesta

Cada resultado del motor devuelve los siguientes campos:

{
  "title":        "Farmacia San Pablo Reforma",
  "address":      "Av. Paseo de la Reforma 222, Juarez, CDMX",
  "phone":        "+52 55 1234 5678",
  "website":      "https://ejemplo.com",
  "rating":       4.6,
  "reviewsCount": 312,
  "category":     "Farmacia",
  "latitude":     19.4326,
  "longitude":    -99.1332
}

Categorias preconfiguradas

El sistema es extensible a cualquier categoria de negocio disponible en el indice.

Las zonas tacticas son regiones geograficas definidas por el usuario mediante herramientas de dibujo de poligonos sobre el mapa. Cada zona se almacena como un GeoJSON Polygon.

Datos de cada zona

Metricas calculadas por zona

Score compuesto

El ranking de los mejores negocios por zona utiliza la formula:

score = rating * log10(reviewsCount + 1)

Este calculo balancea la valoracion del negocio con su volumen de resenas, evitando que negocios con pocas resenas pero rating perfecto dominen el ranking.

Estimacion de carga de trabajo

tiempo_por_visita  = 20 min (constante)
tiempo_traslado    = ajustado por densidad (min: 5 min, max: 20 min)
jornada            = 6 horas efectivas
visitas_por_dia    = jornada / (tiempo_por_visita + tiempo_traslado)

Cada negocio identificado puede convertirse en un lead dentro del pipeline. Los leads avanzan a traves de estados definidos:

Datos de cada lead

Cada lead almacena: fuente, tipo de negocio, datos de contacto (nombre, telefono, email, sitio web, redes sociales), direccion completa, coordenadas GPS, valoracion, notas del operador y timestamps de creacion y actualizacion.

Fuentes de leads

Tipos de negocio

El sistema permite importar leads masivamente desde archivos CSV. El proceso es completamente automatizado con deduplicacion inteligente.

Proceso de importacion

duplicado = (businessName + city) coincide
         OR (phone) coincide

El sistema opera con 4 entidades principales almacenadas en PostgreSQL:

Usuario {
  id          String    @id
  email       String    @unique
  nombre      String
  activo      Boolean   @default(true)
  createdAt   DateTime
}

BusquedaGuardada {
  id              String    @id
  usuarioId       String
  nombre          String
  keyword         String
  resultados      JSON      // array de negocios encontrados
  zonas           JSON      // GeoJSON con poligonos dibujados
  totalResultados Int
  createdAt       DateTime
}

Lead {
  id              String    @id
  usuarioId       String
  fuente          String    // search, scraping_web, scraping_social, manual, csv_import
  estado          String    // nuevo, en_revision, aprobado, rechazado, exportado
  tipo            String    // farmacia, odontologo, pediatra, etc.
  nombre          String?
  negocio         String?
  direccion       String?
  ciudad          String?
  estado_geo      String?
  telefono        String?
  email           String?
  web             String?
  redesSociales   String?
  valoracion      Float?
  latitud         Float?
  longitud        Float?
  notas           String?
  createdAt       DateTime
  updatedAt       DateTime
}

Importacion {
  id              String    @id
  usuarioId       String
  fuente          String
  archivo         String
  total           Int
  nuevos          Int
  duplicados      Int
  createdAt       DateTime
}

La seguridad del sistema se implementa en multiples capas: