Brancheneinstufung2/company-explorer/README.md

Company Explorer (Robotics Edition)

Der Company Explorer ist das zentrale Data-Mining- und Anreicherungs-Tool für die GTM Engine. Er dient als "Vorratskammer" für Leads und als Intelligence-Layer.

📚 Dokumentation

• Architektur & Spezifikation: ➡️ docs/ARCHITECTURE_AND_SPECS.md
• Migrations-Plan (Legacy zu Robotics): ➡️ MIGRATION_PLAN.md
• Technisches Deployment: Siehe Root docker-compose.yml.

🛠️ Kern-Funktionen

• Import: Excel-basierter Import von CRM-Dumps und Messe-Listen.
• Deduplizierung & Matching:
  • Zentraler Account-Matching-Service: Ein hochperformanter Dienst (/api/match-company) zum Abgleich externer Leads gegen den SuperOffice-Bestand (via CE-DB).
  • Algorithmus: Nutzt mehrstufiges Fuzzy-Matching (Name, Domain, Ort) basierend auf der bewährten company_deduplicator.py Logik (v2.15).
• Enrichment: Automatisiertes Scraping von Websites, Impressum und Wikipedia.
• Intelligence: KI-basierte Klassifizierung (Verticals) und Potenzial-Analyse (Metriken).
• API: REST-Schnittstelle für den lead-engine Connector und externe Integrationen.

🚀 Entwicklung

Frontend (React)

cd frontend
npm install
npm run dev

Backend (FastAPI)

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app:app --reload