SimScouting

SimScouting ist Renés Empfehlungssystem: Mitglieder und Interessenten werden zu Scouts, laden Freunde ein (ursprünglich „7 Tage Friends Pass“) und bekommen Prämien. René hatte es mit Supabase, n8n und statischen Widgets selbst gebaut und am 07.08.2026 entschieden, es in die eigene Technik zu portieren („keine Parallelwelten“). Heute ist es ein buchbares Hub-Modul pro Kunde: Scout-App, Seite /empfehlen/ auf der Kundenwebsite, Attribution im Lead-System, Prämien, Selbsttest und Druck-Werbemittel.

• Portierung S1 bis S4 live am 07.08. (Hub v0.132.0 bis v0.134.0): Datenmodell, Scout-App scouting.sim-tools.cloud/scout/<token>, Tracking-Snippet /portal/scouting.js mit Lead-Attribution, Zentrale-Karte und Portal-Bereich „Empfehlungen“.
• S5 Pilot am Testkunden SimGym (fitmax): Kreislauf über die echte Website per Headless-Browser grün.
• Produktisierung S7 (09.08., Hub v0.150.0): flags.scouting (aus, test, gebucht) als einziger Schalter, Einrichtungs-Assistent, Selbsttest mit 8 Klartext-Ampeln, Startpaket mit QR-Plakat und Theken-Anleitung als PDF, CleverReach-Mailvorlage.
• S8 bis S10 (09.08.): natives Teilen-Menü, „Als Kunde ansehen“ mit Support-Zugang, Druck-Werbemittel im Kundendesign mit Visitenkarte und Layout-Registry.
• S11 (Hub v0.156.0): Empfehlungsprogramm auf der Kundenwebsite unter /empfehlen/ ab Werk im Template, Adressen zentral in scoutingCore.ts.
• Bonus-Modell als Staffel (Hub v0.165.0 bis v0.168.0) und Empfehlung in jeder Bestätigungsmail, jeder Lead wird Scout (v0.164.0). Auto-Scout und Einladungsmail sind seit 19.08. (v0.212.0) von der Bestätigungsmail entkoppelt, dazu eine echte Terminbestätigung.
• Zwei Aktionen (28.08., Hub v0.236.0, 92cfd83): Gym-Buddy mit Shake beim Probetraining für beide, Mitglieder-Aktion mit Personal-Training-Einheit bei Laufzeitvertrag ab 3 Monaten (kein Freimonat). SimGym vorbereitet.
• QR-Einlösung an der Theke (02.10., Hub v0.356.0, 1a76927): Einlöse-Code je Prämie, Mail „Deine Belohnung wartet“ mit QR, Belohnungsseite, Scan-Seite im Kundenportal (Kamera, Hand-Scanner, Eintippen), Klick bleibt Ersatzweg.
• Erklärvideos (02.10.): mehrere Fassungen, zuletzt die dunkle Fassung für die SIM-Website (14248d3).
• Läuft produktiv nur bei SimGym (Testkunde), noch kein Kunde live (Stand 19.08. und 09.08. laut Notizen, seitdem keine Gegenmeldung belegt).

• René QR-Einlösung einmal mit echtem Handy und iPad testen (Kamera-Freigabe im Browser).
• René SimGym-Widget „Code zeigen“ (devel f0970fc) über die Zentrale von preprod nach live freigeben.
• René ersten echten Kunden für Scouting benennen, danach Template-Rollout nach Blaupause (Templates v1, v2, v4 und Golf-Template haben das Widget „Code zeigen“ noch nicht; Template v3 und Ketten ohne Scouting, Standort-Zuordnung offen).
• René Mails ansehen (Terminbestätigung, Lead 87) und Portal-Häkchen testen, preprod→main für das Widget (Stand 28.08., Erledigung nicht belegt prüfen).
• René Altsystem abbauen (S6): Supabase löschen, n8n-Workflows nur für Scouting aus, Webspace leeren, Repo studiosinmotion/system-sim-scouting archivieren. Das Repo war öffentlich mit Passwort in der Historie, Repo auf privat stellen und DB-Passwort rotieren (Stand 07.08.), Erledigung nicht belegt prüfen.
• René Entscheidungen zum Prämien-Konzept, soweit nicht durch die zwei Aktionen beantwortet: Freundschaftsrabatt, Wahlprämie, welche Vorlage zuerst.
• ich Wahlprämie, Freundschaftsrabatt, Status-Mail mit Abholort und Erinnerung nach 7 Tagen (offen seit 28.08.), Layout-Auswahl durch den Kunden im Portal, weitere Druckvorlagen.
• ich Verknüpfung Probetraining-Lead und Magicline-Check-in für den Bonus (Lead hat nur die Buchungs-Referenz, Check-in kommt mit customerId), siehe magicline-connect.
• ich Magicline-Schalter für die Anmeldebestätigung klären, bevor ein Kunde ihn anschaltet (Magicline mailt Vertrag und SEPA ja oder nein).
• ich Kein zweiter Versuch, wenn die Belohnungs-Mail scheitert (benachrichtigt_at bleibt leer).
• ich Alte SimScouting.trackConversion-Hooks in sim2026 ersetzen. Verlosung als Ausbaustufe.

• 2026-08-07: Weg B, Portierung in die eigene Technik. n8n.simki.cloud bleibt für anderes. Pilot FitMax. Prämien erst direkt, Verlosung später.
• 2026-08-07: Wording: „Einladen, Schenken, Partner“, nie „Werben, Nominieren, Kopfgeld“.
• 2026-08-09: flags.scouting statt Tabelle, monatlich, Registrierung bleibt für jeden offen, Testmodus ja, Prämien-Vorlagen Verzehrgutschein, Personal Training, Freimonat.
• 2026-08-09: QR immer dunkel auf weiß, Logo nie ungeschützt auf Studiofarbe.
• 2026-08-10: Alte Adressen ohne Bestandsschutz, weil noch kein Kunde live ist. Registrierung und Scout-Bereich liegen auf der Kundendomain (Vertrauen) und sind bei gebuchtem Scouting automatisch aktiv.
• 2026-08-19: Scouting-Absatz in Mails ohne den allgemeinen Prämiensatz (doppelt zum Aufhänger). Label „Freunde einladen“ im Plural.
• 2026-08-28: Zwei Aktionen statt Freimonat. Probetraining = Sofort-Sache für beide, Mitgliedschaft = Laufzeitvertrag ab 3 Monaten, monatlich kündbar zählt nicht.
• 2026-10-02: Der Klick in „Offene Prämien“ bleibt als Ersatzweg ausdrücklich gewollt. Die Belohnungsseite verlinkt nicht in den Scout-Bereich, weil das Scout-Token ein Login-Geheimnis ist.
• Testdateien dürfen kein Modul importieren, das db.js hereinzieht (Lehre: npm test lief einmal gegen die echte hub.db).
• Neue öffentliche Hub-Pfade brauchen ein Traefik-Label in deploy/docker-compose.yml.
• Scouting-Mails nicht in Kündigungs- und Widerrufsmails (Scouting-Verbot in Kündigungsmails bleibt).
• Steuer: Freigrenze 256 € im Jahr bei Sachprämien (§ 22 Nr. 3 EStG), Beitragsrabatt am einfachsten.

1. 02.10.2026
   QR-Einlösung an der Theke live (Hub v0.356.0, 1a76927). Erklärvideos in mehreren Fassungen (5c8b077, c0ce560, 44ea2fb, 2c1b308, 14248d3).
2. 25.09.2026
   Branchen-Weiche v0.341.0: Empfehlungen nur in Fitness, Physio und Golf (51f8e11).
3. 15.09.2026
   Standort-Scope für Portal-Zugänge (v0.310.0).
4. 28.08.2026
   Prämien in zwei Aktionen (Hub v0.236.0, 92cfd83), SimGym vorbereitet.
5. 27.08.2026
   Prämien-Konzept (Wiki 50-Strategien/SimScouting Prämien-Konzept.md, Commit 5bcb025).
6. 23.08.2026
   Newsletter und andere Zusatzmodule als buchbar (Katalog, v0.227.0).
7. 19.08.2026
   Entkopplung Scouting-Einladung von der Bestätigungsmail, Terminbestätigung (v0.212.0 bis v0.214.1).
8. 11.08.2026
   Bonus-Modell in allen Bereichen (v0.164.0 bis v0.168.0).
9. 10.08.2026
   Empfehlungsprogramm auf der Kundenwebsite (v0.156.0, b9bd613).
10. 09.08.2026
    Produktisierung S7 bis S10 (v0.150.0 bis v0.153.0), Druckmuster-Seite, Flottenblick Empfehlungen.
11. 07.08.2026
    Entscheidung Weg B, S1 bis S5 gebaut (v0.132.0 bis v0.134.0), Vortragsdeck.

• Code im Hub: /root/sim-ops/hub/src/scouting.ts, scoutingCore.ts (db-frei, Adressen, Codes), scoutingApp.ts (Scout-App), scoutingAuto.ts (Auto-Scout, Einladungsmail), scoutingSelbsttest.ts, scoutingPaket.ts und scoutingPaketCore.ts (Plakat, Visitenkarte, Layouts), portalScouting.ts (Portal-Bereich). Website-Snippet über die Route /portal/scouting.js (Quelle im Hub-Code, Datei nicht gesondert geprüft), Scanner hub/public/portal-scan.js, portal-jsqr.js.
• Tabellen: scouting_kampagnen, scouting_scouts, scouting_events, scouting_praemien, scouting_einloesungen (mit code, benachrichtigt_at, eingeloest_weg), Spalten leads.scout_id, leads.scouting_kampagne_id, leads.mitglied_at.
• Zentrale: Kundenakte › Leads-Tab › Karte „Scouting“ (Einrichtungs-Assistent, Selbsttest, Startpaket, Einlösungen), Flottenblick „Empfehlungen“ unter Vermarktung. Portal: Bereich „Empfehlungen“ mit „Code scannen“ (/portal/scouting/scan).
• Öffentlich: scouting.sim-tools.cloud/scout/<token>, /scout/registrieren/<kunde>, /scout/belohnung/<CODE>, JSON /portal/scouting/oeffentlich/:kunde, Website-Seite /empfehlen/ (Komponente SimScouting.astro im Template).
• Spec: /root/sim-ops/docs/scouting-produktisierung-2026-08.md. Hilfe: hub/hilfe/scouting.kunde.md. Wiki: 40-Projekte/SimScouting-Portierung.md, 50-Strategien/Gesamtsystem/SIM Scouting Praesentation.md. Website-Blaupause im Repo fitmax: _WIKI/sim-scouting-integration.md.
• Archiv des Altsystems: Export in /root/sim-ops/data/scouting-import/*.json (ungepusht wegen personenbezogener Daten). Altes Repo studiosinmotion/system-sim-scouting (persönliches GitHub-Konto), Supabase Cloud und Webspace simscouting.studios-in-motion.de sind der abzubauende Bestand.
• Videos: /root/motion/_studio (Videostudio), Ausgabe unter hub/public/brand/erklaervideos/ (scouting, scouting-dunkel, portal-scouting).