# Lead Research modul - arhitektura za buduću fazu

Ovaj dokument opisuje bezbedan pravac za budući interni modul za istraživanje B2B leadova. Modul nije implementiran u trenutnoj fazi i ne treba da radi scraping platformi čiji uslovi to zabranjuju.

## Cilj

Lead Research treba da pomogne timu da pronađe kompanije koje imaju realan operativni problem za ECOM01 usluge:

- eCommerce sa ERP/BizniSoft potrebama
- retail/wholesale firme sa više prodavnica ili magacina
- hoteli, apartmani i property manageri sa Beds24 ili direktnim booking potrebama
- B2B firme kojima treba moderan sajt, SEO, lead generation i integracije

## Dozvoljeni izvori i pristup

- Javne web stranice kompanija
- Google Places API ili drugi zvanični API izvori uz poštovanje uslova korišćenja
- Ručno uneti leadovi iz CRM-a
- Dobrovoljno dostavljeni podaci kroz kontakt formu
- Partner/dobavljač liste za koje postoji pravo obrade

Ne implementirati LinkedIn scraping, zaobilaženje login zidova, masovno preuzimanje podataka bez dozvole ili automatizaciju koja krši uslove platforme.

## Predloženi moduli

### Beds24 public website footprint detector

Detektuje javne signale da smeštaj koristi Beds24 ili sličan booking sistem:

- prisustvo Beds24 widget/embed skripti
- javni booking linkovi
- struktura room/property stranica
- nedostatak direktnog booking toka

Rezultat treba da bude signal, ne tvrdnja. Svaki lead mora imati izvor i vreme detekcije.

### BizniSoft public customer enrichment

Ako postoji legalno dostupan javni izvor ili ručno uneta lista, modul može obogatiti lead:

- naziv firme
- delatnost
- web sajt
- broj lokacija ako je javno naveden
- indikacija da postoji više magacina/prodavnica

Ne praviti scraper za zatvorene ili uslovima zabranjene izvore.

### Google Places API enrichment

Koristiti zvanični API za:

- naziv, adresa, telefon, website
- kategorije poslovanja
- radno vreme i lokacije
- place id za deduplikaciju

Potrebno je čuvati API izvor, uslove korišćenja i datum poslednjeg osvežavanja.

### CRM scoring

Lead score može kombinovati:

- fit za uslugu: eCommerce, WMS, BizniSoft, Beds24, hosting
- broj lokacija ili indikacija operativne kompleksnosti
- brzina i tehničko stanje sajta
- postojanje direktnog booking/eCommerce toka
- ručno potvrđen interes ili prethodna komunikacija

Score je pomoć pri prioritetu, ne automatizovana odluka.

### Outreach templates

Pripremiti šablone za email ili poziv koji su:

- relevantni za javno uočeni problem
- kratki i konkretni
- bez lažnih tvrdnji i preteranih obećanja
- sa jasnom opcijom da primalac ne želi dalji kontakt

## Predloženi podaci u bazi

- lead_sources
- lead_companies
- lead_contacts
- lead_signals
- lead_scores
- outreach_templates
- outreach_events

Svaki signal treba da ima `source_url`, `source_type`, `confidence`, `observed_at` i `notes`.

## Privatnost i usklađenost

Pre implementacije proveriti:

- pravni osnov za obradu podataka
- uslove korišćenja izvora podataka
- politiku zadržavanja podataka
- pravo na brisanje i opt-out
- evidenciju izvora i vremena prikupljanja

Modul treba graditi kao interni CRM pomoćnik, ne kao alat za agresivno ili neusklađeno prikupljanje podataka.