🚀 LeadForge — Restaurant Lead Intelligence System

LeadForge is a full-stack, AI-powered SaaS platform that helps sales teams discover, analyze, and prioritize restaurant leads.

It combines data ingestion, enrichment, deterministic scoring, and AI-driven reasoning into a single intelligent system.

---

🧠 Architecture Overview

LeadForge is built as a hybrid microservices system:

🔹 Backend (Node.js)

• Google Places API ingestion
• Lead enrichment pipeline
• Deterministic scoring engine
• MongoDB database
• REST APIs

🔹 AI Service (Python)

• Built with FastAPI + LangGraph
• Gemini-powered multi-agent reasoning
• AI scoring refinement
• Outreach message generation

🔹 Frontend (React)

• React + Vite + Tailwind
• Redux Toolkit + RTK Query
• SaaS dashboard for sales teams

---

📁 Project Structure

LeadForge/
│
├── backend/        # Node.js API (data pipeline + scoring)
├── ai_service/     # Python FastAPI (AI reasoning layer)
├── frontend/       # React dashboard (UI + RTK Query)
├── RUNBOOK.md      # Full setup & workflow guide
└── README.md

---

⚙️ Getting Started (Local Setup)

1️⃣ Backend

cd backend
npm install
npm run mongo:up
npm run dev

---

2️⃣ AI Service

uv sync --project ai_service
uv run --project ai_service uvicorn ai_service.main:app --reload --port 8001

---

3️⃣ Frontend

cd frontend
npm install
npm run dev

---

🔗 Service Endpoints

Backend (Node.js)

• GET /leads
• POST /scrape
• POST /enrich
• POST /score

AI Service (Python)

• POST /analyze-lead

---

🎯 Key Features

• 🔍 Automated restaurant lead scraping (Google Places)
• 🧩 Data enrichment (website, social, sentiment)
• 📊 Deterministic lead scoring (0–100)
• 🤖 AI-powered reasoning (LangGraph + Gemini)
• 💬 Personalized outreach generation
• 📈 SaaS dashboard with filtering & pipeline tracking

---

🛠 Tech Stack

Backend

• Node.js, Express, MongoDB

AI Layer

• FastAPI, LangGraph, LangChain
• Gemini API

Frontend

• React, Vite, Tailwind CSS
• Redux Toolkit, RTK Query

---

📌 Development Workflow

For complete setup instructions and service orchestration:

👉 See RUNBOOK.md

---

🚀 Vision

LeadForge is designed to function as a sales intelligence system that helps teams:

• Identify high-quality leads
• Understand business pain points
• Generate targeted outreach
• Close deals faster

---

🧑‍💻 Author

Built as a real-world production system integrating backend engineering, AI orchestration, and frontend SaaS design.