Carry over pre-existing WABA outreach automation WIP

This work already existed uncommitted in the main working tree (not
authored by this branch) and is required as a runtime dependency for the
campaign outreach port (zpro-client, templates, outreach routes/UI). Copied
in as-is, untouched, so this feature branch has a working baseline; the
original uncommitted state in the main checkout is left exactly as it was.

prospeccao/cnpj/README.md

@@ -11,16 +11,23 @@ O captador aceita CSV com cabecalho e tenta reconhecer colunas comuns como:
 - `cnae`, `cnae_fiscal` ou `cnae principal`
 - `logradouro`, `numero`, `bairro`
 
-Comando para usar a base local:
+Comando para extrair a base de uma UF a partir dos zips brutos da Receita
+(gera o CSV `estabelecimentos-<UF>.csv` usado pela captura):
 
 ```bash
-npm run prospect -- --source=cnpj-base --send
+npm run extract -- --uf=BA
 ```
 
-Com enriquecimento pela BrasilAPI, use:
+Comando para capturar leads usando a base já extraída:
 
 ```bash
-npm run prospect -- --source=brasilapi --send
+npm run capture -- --sources=cnpj-base --uf=BA --cities="Ilheus"
+```
+
+Com enriquecimento pela BrasilAPI, inclua a fonte `brasilapi`:
+
+```bash
+npm run capture -- --sources=cnpj-base,brasilapi --uf=BA --cities="Ilheus"
 ```
 
 O modo `brasilapi` usa os CNPJs encontrados nos CSVs locais para consultar dados atualizados por CNPJ.