# Solarrechner — Whitelabel Solar-Konfigurator-Widget für Solar-Anbieter

> Embeddable JavaScript-Widget, das Adresse → Satelliten-Dachanalyse → KPI-Dashboard → Lead-Versand auf jeder Solar-Anbieter-Webseite ermöglicht. Whitelabel, Mobile-First, DSGVO-konform.

## Was ist Solarrechner?

Solarrechner ist ein **multi-tenant embeddables Widget**, das Solar-Anbieter (Photovoltaik-Installateure, Solar-Vertriebe, Solar-E-Commerce) auf ihrer eigenen Webseite einbinden können. Es liefert in unter 60 Sekunden:

1. **Adress-Eingabe** (Google Places Autocomplete, DE-restricted)
2. **Satelliten-Dachanalyse** via Google Solar API (Building Insights)
3. **Interaktives KPI-Dashboard:** Anlagenpreis, jährliche Ersparnis, Amortisation, 20-Jahres-Gewinn
4. **Modul-Slider, Speicher/E-Auto/Wärmepumpe-Toggles, Investment-Chart, Maps-Overlay mit Modul-Visualisierung**
5. **Lead-Modal** mit DSGVO-Pflicht-Checkbox, sendet E-Mail an Kunden-Hosting via PHP `mail()`

## Hauptmerkmale

- **Multi-Tenant:** Jeder Kunde nutzt eigene Google-API-Keys (Maps, Places, Solar) — Kostenkontrolle bleibt beim Kunden.
- **Whitelabel:** Vollständig anpassbares Branding (Farben, Logo, Schrift, Border-Radius) per `data-*`-Attributen.
- **Floating-Mode:** Optional als Floating Action Button (FAB) auf jeder Seite einsetzbar — öffnet Modal mit Slide-up-Animation.
- **Mobile-First:** 100 % responsiv, Touch-Targets ≥44 pt, Safe-Area-aware (iOS Notch + Home-Indicator).
- **DSGVO-konform:** Honeypot-Spam-Schutz, IP-Anonymisierung, Pflicht-Datenschutz-Checkbox vor Lead-Versand, Consent-Mode-v2-Integration.
- **DataLayer-Tracking:** Feuert SoCare-Standard-Events (quiz_start, quiz_progress, quiz_end, scFormSubmit) — kompatibel mit Google Tag Manager out-of-the-box.
- **Bundle:** ~24 KB gzipped, lädt Maps-API erst nach Adress-Auswahl (lazy).

## Tech-Stack

- TypeScript + Vite + Vanilla CSS
- Google Maps JavaScript API, Places API, Solar API
- PHP `mail()` für Lead-Versand auf Kunden-Hosting
- Funktioniert auf All-Inkl, Strato, IONOS, Webhostone und allen klassischen PHP-Hostings

## Wer steckt dahinter?

- **SoCare GmbH** (Düsseldorf) — Performance-Marketing-Agentur mit Spezialisierung auf E-Commerce-IT-Infrastruktur, First-Party-Tracking und Conversion-Optimierung. Website: https://so-care.de
- **Prince Said Mehmedagic** — Geschäftsführer und Entwickler. Master of Arts (Leadership & Management), Master of Science (Marketing Communication), 25+ Zertifikate (Google, Meta, Pinterest, LinkedIn, IHK). Website: https://princesaidmehmedagic.de

## Verlinkungen

- **Live-Demo:** https://solarrechner.so-care.de/
- **Doku:** https://solarrechner.so-care.de/docs/installation.md
- **Widget-CDN:** https://solarrechner.so-care.de/v1/widget.js
- **Anbieter:** https://so-care.de
- **Kontakt:** info@so-care.de
- **GitHub / Source:** Auf Anfrage (privates Repository)

## Pricing

Whitelabel-Lizenzierung auf Anfrage. Setup pro Kunde ca. 5 Minuten (Embed-Snippet + lead.php-Upload + Google-Cloud-API-Key-Restriktion). API-Kosten trägt Kunde direkt über eigenen Google-Cloud-Account ($200 Free-Credit/Monat genügt für die meisten Solar-Anbieter).

## Use-Cases

- **Photovoltaik-Installateure:** Lead-Generation auf eigener Website mit Wow-Effekt
- **Solar-E-Commerce-Shops:** Konfigurator als Vor-Beratung
- **Solar-Vertrieb / Außendienst:** Vorqualifizierung von Leads vor Termin
- **Energieberater:** Tool für Kundenpräsentationen
- **Solar-Marketing-Agenturen:** Whitelabel für eigene Kunden

---

Letzte Aktualisierung: 2026-04-28