# ZM Prospecta en Maps — CTA: CLIENTES

Ordena una lista de negocios locales según señales públicas y prepara un borrador de primer contacto. Trabaja **solo con una muestra ficticia**: no consulta Google Maps, no hace scraping y no envía mensajes.

## Archivos

| Archivo | Para qué sirve |
| --- | --- |
| `prospectos-muestra.csv` | 12 filas ficticias (una repetida a propósito). También es la plantilla de columnas. |
| `workflow.json` | Workflow para n8n: disparador manual → mensajes de `casos.json` → motor. Se genera desde `motor.js`; no lo edites a mano. |
| `motor.js` | Filtro, deduplicación y puntuación. |
| `casos.json` | Cinco casos de prueba. |

## Puntuación (máximo 100)

| Regla | Puntos | Hecho observado (columna) | Inferencia |
| --- | --- | --- | --- |
| `sin_web` | 40 | `tiene_web = no` | Podría perder clientes que buscan en línea |
| `sin_reserva` | 30 | `reserva_en_linea = no` | Podría servirle agendar o responder de forma automática |
| `sin_horario` | 20 | `horario_publicado = no` | Podría recibir preguntas repetidas |
| `volumen` | 10 | `num_resenas >= 50` | Tiene clientes suficientes para que valga la pena |

Cada fila del resultado separa `hechos_observados`, `inferencias`, `fuente` y `fecha_observacion`, y lleva `revision_humana: PENDIENTE`.

## Límites

- Dos negocios se consideran el mismo si coinciden nombre y teléfono.
- No inventa datos: si una columna está vacía, la regla no suma.
- El borrador es un texto para revisar y enviar a mano. La demo nunca envía nada (`mensajes_enviados: 0`).

## Para producción (no incluido)

API oficial de Google Places con clave propia (variable sugerida `GOOGLE_PLACES_API_KEY`, nunca en el código), revisión de cuotas y costos, y revisión humana antes de cualquier contacto.

## Cómo probarlo

1. **Sin instalar nada:** genera el sitio (`npm run build` en la raíz del proyecto) y abre `dist/descargas/prospecta-en-maps/demo.html` con doble clic.
2. **En el sitio:** ejecuta `npm start` en la raíz y abre `http://localhost:4321/recursos/prospecta-en-maps/`.
3. **En n8n:** *Import from File* → `workflow.json` → *Test workflow*. No lo actives. Importado y ejecutado con la CLI de n8n 2.35.7 el 11-11-2026 (`scripts/probar-n8n.js`): todos sus casos PASS. NOT RUN: importarlo desde la interfaz web de n8n.
4. **Pruebas automáticas:** ejecuta `npm test` en la raíz. Necesita Node 18 o más nuevo.

Los casos de prueba y su resultado esperado están en `casos.json`. Los resultados observados se muestran en la página del recurso y en `RESULTADOS-DE-PRUEBAS.md` (raíz del proyecto).
