gnjohnny/Maps2Chat

A lightweight Customer Relationship Management (CRM) application and automated B2B lead generation pipeline custom-optimized for localized business outreach within Kenya. # Maps2Chat Maps2Chat is a lightweight Customer Relationship Management (CRM) application and automated B2B lead generation pipeline custom-optimized for localized business outreach within Kenya. It leverages the **Google Places API** to extract uncontacted business listings, normalizes and transposes telephone numbers to standard E.164 format, and implements a compliant **Human-in-the-Loop (HITL)** operational paradigm for initiating WhatsApp outreach. --- ## 🚀 Key Features * **Geographically Restricted Scraper**: Automated query sweeps utilizing Google Places searchText API, restricted to the Kenya geographic coordinates bounding box. * **Fail-Safe Address Filtering**: Strips out listings whose addresses do not explicitly contain the keyword `"Kenya"`. * **E.164 Phone Transposition**: Intelligently transposes local Kenyan numbers (prefixes starting with `07...`, `01...`, or landline `020...`) to the standard `254XXXXXXXXX` international format. * **Ingestion Quota Management**: Autonomous daily daemon sweeps that halt execution immediately once exactly 10 new unique leads have been fetched and persisted for the day. * **Human-in-the-Loop Outreach**: Native outreach utilizing custom pre-filled `wa.me` links opened in new tabs, ensuring compliance with anti-spam terms and account safety. * **Dynamic Operator Dashboard**: Segmented views separating leads by state: * **Pending Queue**: High-priority uncontacted leads with inline WhatsApp contact links. * **Contacted Ledger**: Historical log of successfully initiated campaigns with timestamp logs. * **Archived Vault**: Suppressed or deleted leads kept to prevent re-scraping and maintain pipeline deduplication. * **Secure Google OAuth 2.0 Login**: Restricted passport-backed JWT token authentication. * **Responsive Theme Support**: Dark/Light mode design system using the premium Emerald theme. --- ## 🛠️ Tech Stack | Layer | Technology | Description | | --- | --- | --- | | **Database** | Neon …