Magicline-Anbindung

Magicline ist die Studio-Software vieler Kunden. Der Hub spricht sie über zwei Wege an: die Connect API (öffentlich, für Website-Funktionen wie Tarife, Probetraining, Vertragsabschluss) und die Open API (Keys und Scopes je Studio: Kursplan, Mitglieder, Verträge, Check-ins, Webhooks). Daraus entstehen Kursplan, Probetraining-Buchung, Vertragsverkauf, Mitglieder-Spiegel, Newsletter-Sync und Scouting. Ziel ist außerdem ein eigener Marketplace-Eintrag „SIMconnect by studios in motion“, damit Clubs die Anbindung selbst aktivieren können.

• Open-API-Rückkanal live seit 06.08. (Hub v0.129.1): Webhook-Endpunkt, confirmActivation, Spiegel magicline_mitglieder und magicline_vertraege, Nachtabgleich 03 bis 05 Uhr, öffentliche Feeds kursplan.json, team.json, studio.json.
• Sandbox gesund (Stand 08.09.): Anbieter 4 (sim2026) und 6 (simgym).
• Produktions-Antrag „SIMconnect by studios in motion“ am 08.09. eingereicht, am 09.09. freigegeben (Status Completed). 7 Scopes, 10 Events inklusive Check-in, Webhook https://admin.sim-tools.cloud/webhook/magicline.
• Marketplace-Eintrag: Texte, 12 Bilder, 2 Videos, Leitfaden-PDF, Header-Bild. Am 16.09. von René befüllt und zur Kontrolle eingereicht. Am 21.09. meldet Katrin Krüger (Sport Alliance) die Seite als freigegeben, aber noch nicht öffentlich.
• Modul-Matrix je Kunde (Hub v0.213.0 bis v0.213.3): Blatt Firma › Studio-Software & Schnittstellen mit Kann, Nutzt, Status, Fehlt, harte Gates.
• Produktseite /tools/magicline-anbindung im Repo website-sim2026 (3eb8c0d, devel und preprod), bewusst nicht verlinkt.
• Check-in-Events (Hub-Cockpit S1.6a, 13.09.): CUSTOMER_CHECKIN/CHECKOUT werden am Kontakt verbucht, 401/403-Sperre mit Alarm gebaut.
• Erster Produktions-Club: K5 Feelnessloft (23.09.), Anbieter 13, 2070 Mitglieder und rund 6000 Verträge im Spiegel. Aktiv-Flag bewusst aus (Connect-Verkauf erst mit Website-Livegang).
• Wiederverwendbares Connect-Skript /root/scripts/magicline-connect.sh und .mjs.
• Tarifbilder: Übernahme aus Magicline beim Tarif-Import plus Medienpool-Wahl (v0.235.0).
• Chatbot-Probetraining über Magicline repariert (v0.237.0, v0.237.1): Notiz auf 300 Zeichen gekürzt, Geburtsdatum und Geschlecht als Lead-Felder.
• Probeangebote als Terminquelle (v0.215.0), Kursplan-Quelle Magicline (K1/K2).

• Partner Sport Alliance schaltet SIMconnect nach den Pilot-Tests öffentlich und für die gewünschten Länder (DE/AT/CH).
• René Katrins Frage vom 21.09. beantworten, ob die Integration in den Pilotstudios getestet wurde (Pilotstudios laut Antrag: Impuls Oldenburg 1210006770 und K5 1210004790). Mailstand im Ticketsystem prüfen.
• René Impuls-Aktivierung im Magicline-Marketplace anstoßen, dann gleicher Aufruf wie bei K5 (bisher keine Produktions-Aktivierungsmail von Impuls).
• ich Kursplan von K5 auf quelle=magicline umstellen, den ersten echten Webhook beobachten.
• René entscheiden, ob K5 (Anbieter 13) mit dem Website-Livegang aktiv geht (Connect-Verkauf).
• René Header-Bild der Marketplace-Kachel wählen (Variante A mit Magicline-Zeichen oder B ohne) und hochladen. Markenrichtlinie von Sport Alliance nicht geprüft.
• René preprod→main für die Produktseite magicline-anbindung.
• ich Verknüpfung Probetraining-Lead und Check-in (Lead hat nur die Buchungs-Referenz, Check-in kommt mit customerId) für den Scouting-Bonus.
• ich vier offene Support-Fragen an Magicline (Checkin-Voucher erzeugen, Webhook-Retry, Delta-Abruf, Partner-Benefits). Gratis-Shake später über Benefits nachbeantragen.
• René MyTime-Anbieter 1 und 2 (seit 05.08. kaputt, Studio-IDs passen nicht zum Tenant) löschen oder neu anlegen. Anbieter 5 (Produktions-Fehlversuch) kann weg.
• ich Check-in und Empfehlungsprogramm erst bewerben, wenn im Hub gebaut. Webhook-Funnels Welcome/Retention, Mitgliederbereich M2 und folgende.
• Wiedervorlage 25 in der Zentrale war für den 23.09. angelegt (Portal-Status prüfen), Erledigung nicht belegt prüfen.

• 2026-08-07: Club-Aktivierungen immer über die Application SIMwebsite-connector (Sandbox), die App „SIMconnect“ aus dem alten Versuch nicht verwenden. Produktions-App heißt „SIMconnect by studios in motion“.
• 2026-08-06: mitfit ist Baustelle des Kollegen, im mitfit-Vault und in mitfit-Repos wird nichts geändert. Magicline-Doku gehört ins SimHermes-Wiki.
• 2026-09-08: Check-in/-out ja (Scouting), CHECKIN_VOUCHER_WRITE nein.
• 2026-09-16: Marketplace-Texte ohne „wir“ und „uns“ (Vorgabe Sport Alliance). Kein Sprecher im Video, stumm.
• 2026-09-16: Produktseite bewusst nicht in Navigation, Footer und Tools-Übersicht verlinkt.
• Magicline-Tarif-Hoheit hybrid: Zahlen aus der Studio-Software, Verkaufshülle (inklusive Bild) gehört uns. Magicline-Bild nur als Vorbelegung, nie direkt in bild_url.
• API-Fallen: /v1/classes/slots ignoriert Datumsparameter, Slots je Kurs holen. Connect-Trialsession liefert bei mehr als 30 Tagen leer. Unbekannte Kunden kommen als HTTP 400 customer.not.found. Webhooks ohne Retry, Nachtabgleich ist Pflicht. Der erste Vollabgleich eines großen Clubs läuft länger als das Client-Timeout, nicht neu anstoßen.

1. 24.09.2026
   Befund Check-in-Events bei K5 (406 CHECKIN und 406 CHECKOUT in 24 h, alle ignoriert, solange Modul Rückkanal aus ist). K5 bleibt Connect-Verkauf aus.
2. 23.09.2026
   Erster Produktions-Club K5 verbunden (Anbieter 13), Connect-Skript gebaut.
3. 21.09.2026
   Marketplace-Seite freigegeben, Katrin Krüger fragt nach Pilot-Tests.
4. 16.09.2026
   Marketplace-Auftritt eingereicht (71e514d, 0b0fedc, 3b163fe), Produktseite 3eb8c0d.
5. 13.09.2026
   Cockpit S1.6a (538684a): Check-in-Ereignisse, 401/403-Sperre mit Alarm.
6. 10.09.2026
   Produktions-Antrag freigegeben (Portal 09.09. 9:19), Google-Formular für den Marketplace-Eintrag beantwortet.
7. 08.09.2026
   Produktions-Antrag eingereicht, Befund Sandbox gesund (Hub v0.257.0).
8. 28.08.2026
   Chatbot-Probetraining repariert (v0.237.0, v0.237.1), SimGym Tarife-Seite entfällt.
9. 27.08.2026
   Tarifbild-Funktion (v0.235.0, b9acebc), Tarifbilder für SimGym eingesetzt.
10. 20.08.2026
    Funktionsübersicht für Kunden (1d6c8e4), Probeangebote als Terminquelle (v0.215.0, 897093b).
11. 19.08.2026
    Modul-Matrix live (v0.213.3, 0656e3a), Klick-Dummy (v0.212.4), Kunden-Anleitung Probetraining (v0.212.1), Tenant-only-Prüfung (v0.210.0).
12. 08.08.2026
    Kursplan-Quelle Magicline (7d8030d), Mitglieder-Sync zu CleverReach, Probetraining-Vorlauf 30 Tage.
13. 06.08.2026
    Open-API-Rückkanal live (v0.129.1), Leitseite im Wiki, Produktions-Antrag erstmals vorbereitet.

• Code im Hub: /root/sim-ops/hub/src/magiclineOpen[Core].ts, magiclineSpiegel, magiclinePortal, vertragAnbieter.ts, terminQuellen[Core].ts, studioSoftwareCore.ts (SS_KATALOG, Gate-Helfer), vertragTarife.ts, kontakte.ts (checkinVerbuchen).
• Connect-Skripte: /root/scripts/magicline-connect.sh und .mjs, Aufruf mit --key <kunde> --id <anbieterId> --tokens <datei>. Tokens liegen unter /root/transfer/keys/ (Datei je Club), Hub-Container deploy-sim-hub-266.
• Marketplace-Werkzeuge: /root/sim-ops/tools/marketplace-auftritt/ (README, vorlagen/texte.py ist die Quelle der Texte, bau.py, shot.js, mkvid.sh, leitfaden.html).
• Zentrale: Karte Vertrags-Anbieter unter Verträge, Blatt Firma › Studio-Software & Schnittstellen, Kundenakte-Tab Mitglieder, Anbieter-Karte mit Prüfen und „Webhooks aktivieren“.
• Spiegelstatus: GET /api/vertrag-anbieter/:id/spiegel-status. Webhook-URL nur auf admin.sim-tools.cloud, nicht auf manage..
• Wiki: 40-Projekte/Magicline-API.md, Magicline Produktionsantrag.md, Magicline Marketplace-Auftritt.md, Magicline Developer Portal, Doku-Snapshot.md. Entwicklerportal: developer.sportalliance.com.
• Produktions-Antrag als Text: /root/transfer/magicline-produktionsantrag.md. Logos: /root/transfer/sim-logo-marketplace-*.png.