Technical Documentation

MaxLeadsNow is a B2B territorial intelligence platform that combines real-time business search with geospatial analysis. Designed for sales teams that need systematic territorial reconnaissance.

The platform allows sales representatives and managers to identify business opportunities in any geographic area, analyze the density and quality of existing businesses, and convert that data into actionable leads for their sales pipeline.

The system is built on a modern web application architecture with hybrid rendering (server and client).

Geospatial processing includes geodesic area calculation, point-in-polygon detection, and real-time density metric generation.

The business search engine allows querying an up-to-date index with millions of registered establishments. The advanced search accepts the following parameters:

Response structure

Each result from the engine returns the following fields:

{
  "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
}

Preconfigured categories

The system is extensible to any business category available in the index.

Tactical zones are geographic regions defined by the user through polygon drawing tools on the map. Each zone is stored as a GeoJSON Polygon.

Zone data

Metrics calculated per zone

Composite score

The ranking of the best businesses per zone uses the formula:

score = rating * log10(reviewsCount + 1)

This calculation balances the business rating with its review volume, preventing businesses with few reviews but a perfect rating from dominating the ranking.

Workload estimation

time_per_visit     = 20 min (constant)
travel_time        = adjusted by density (min: 5 min, max: 20 min)
workday            = 6 effective hours
visits_per_day     = workday / (time_per_visit + travel_time)

Each identified business can become a lead within the pipeline. Leads progress through defined states:

Lead data

Each lead stores: source, business type, contact data (name, phone, email, website, social media), full address, GPS coordinates, rating, operator notes, and creation and update timestamps.

Lead sources

Business types

The system allows bulk importing leads from CSV files. The process is fully automated with intelligent deduplication.

Import process

duplicate = (businessName + city) matches
         OR (phone) matches

The system operates with 4 main entities stored in 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 of businesses found
  zonas           JSON      // GeoJSON with drawn polygons
  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
}

System security is implemented in multiple layers: