Verträge und Verkäufe
WartetVertrags- und Verkaufswelt im Hub statt in Freeda: Tarife, Angebote, Online-Abschluss mit PDF, Übertragung an Magicline, Agilea und aidoo, Kaufprozess-Analytik
- Bereich
- Zentrale
- Start
- 05.08.2026
- Zuletzt
- 16.09.2026
- Am Zug
- René
Nächster Schritt, René
Fünf offene Entscheidungen zur Kaufprozess-Messung beantworten und das Widget auf einer Kundenwebsite einbauen, damit echte Zahlen entstehen
Screenshots 1
Worum es geht
Die Vertrags- und Verkaufswelt (bisher in Freeda) zieht in den Hub. Studios zeigen Tarife und Angebote auf ihrer Website mit der Web-Komponente <sim-angebot>, Besucher schließen online ab, der Hub erzeugt Vertrag, SEPA-Mandat und PDF und überträgt den Abschluss an die Studio-Software (Magicline, Agilea, aidoo). Dazu kommt die Kaufprozess-Analytik, um zu sehen, wo Besucher abbrechen.
Stand
- V0 bis V2 live seit 05.08. (Hub v0.111.0): Anbieter-Registry mit Adapter-Schnittstelle, Tarife mit getrennter Verkaufshülle (
tarif_marketing), Angebote als Schaufenster, Komponente<sim-angebot>, Abschluss mit SEPA-Mandat, Vertrags-PDF, Bestätigungsmails, Portal-Bereich, Magicline-Tarif-Import (Connect API). - V3 Magicline schreibend live seit 08.08. (v0.141.1): minütlicher Verarbeiter mit Fehler-Queue, Gutschein-Weg über
preview. Grenzen: Verkäufe mit Zusatzmodulen und Signatur-Tarife werden nicht übertragen. - V4 Rückkanal (Open API) live seit 06.08. (v0.129.1), siehe magicline-connect.
- V5 aidoo: lesend, schreibend, Termine, Kursplan, siehe aidoo-schnittstelle. Agilea: Abschluss und Direktaktivierung auf der Testinstanz bewiesen, siehe agilea-schnittstelle.
- Optik: Redesign der Komponente (v0.193.1, v0.194.0, dreistufige Bestellung), Vertrags-PDF Design B (v0.195.0), Abschluss ohne Bankdaten mit Zahlungsseite und Reminder (v0.198.0), Korb auf dem Handy nicht mehr sticky (v0.214.2), ganze Karte klickbar (28.08.).
- Tarifbild aus dem Medienpool und Übernahme des Magicline-Angebotsbilds (v0.235.0). Zahlungsarten je Tarif aus der Studio-Software (v0.263.2).
- Modul-Matrix je Kunde (v0.213.x): Firma › Studio-Software & Schnittstellen.
- CORS-Falle behoben (v0.166.0):
sim-*.jsmitAccess-Control-Allow-Origin: *. - Kaufprozess-Analytik Teil A live seit 16.09. (v0.312.0, v0.312.1): Ereignisse im Widget (sendBeacon an
/portal/angebot/:key/ereignis), Trichter mit Abbruchstellen im Klartext, Feldfehler, Dauer je Schritt, Copilot-Werkzeugkaufprozess_trichter. Echte Zahlen entstehen erst, wenn das Widget auf einer Kundenwebsite eingebaut ist. - Anleitung zur Kaufprozess-Messung für mitfit gemailt (16.09.), Kopie im Transferordner.
- A/B-Tests (Teil B) warten auf zwei bis vier Wochen echte Zahlen.
Offen
- René fünf Entscheidungen zur Kaufprozess-Messung (Abschnitt 5 des Konzepts): Sitzungskennung ohne Consent-Abfrage, Mindestumfang, Flotten-Tests als opt-out oder opt-in, erste Testkandidaten, ob die Etappen aus Teil B gebaut werden.
- René Widget
<sim-angebot>auf einer Kundenwebsite einbauen oder freigeben (Life X, SimGym), damit gemessen wird. - ich nach zwei bis vier Wochen echte Zahlen Teil B (Fassungen, Gewinner, Flotten-Tests, etwa 10 Arbeitstage insgesamt) neu bewerten.
- René Gläubiger-ID und USt-ID in den Stammdaten pflegen, Frage, ob AGB als PDF an die Mail angehängt werden und ob der Vertragsbeginn wählbar sein soll.
- ich V6 Freeda-Migration und V7 Ausbau, offen. Magicline-Abschlüsse mit Zusatzmodulen und Signatur-Tarife.
- René Magicline-Endfreischaltung abwarten (Pilot-Tests laufen), erster Magicline-Club im Verkauf ist K5 erst mit Website-Livegang.
- ich Agilea auf die Live-Instanz erst nach Renés ausdrücklichem Go (siehe agilea-schnittstelle).
- ich ältere Kundenseiten, die
sim-angebot.jsnoch alstype=moduleeinbinden, prüfen (Notiz vom 11.08., Stand prüfen).
Entscheidungen und Regeln
- 2026-08-05: Heimat ist Hub und Zentrale, nicht Freeda.
- 2026-08-05: Tarif-Hoheit hybrid: Zahlen (Preis, MwSt., Laufzeit, Kündigungsfrist) aus der Studio-Software, Verkaufshülle (Teaser, Features, Bild, Kleingedrucktes, Badge) von uns.
- 2026-08-05: Autark ohne Zahlungsabwicklung: Vertrag, SEPA-Mandat und Dokument erzeugen wir, eingezogen wird beim Club. Kein Zahlungsdienstleister und kein Mahnwesen in Stufe 1.
- 2026-08-08: Bei 400, 409 und Timeout nie automatisch wiederholen (Timeout heißt Ausgang unbekannt).
- 2026-08-16: Vertrags-PDF Design B, Gesamtbetrag über die Mindestlaufzeit immer ausgewiesen („gefällt mir super“).
- 2026-08-22: Der Ablauf in Angebotstexten hat immer genau 4 Schritte.
- 2026-09-16: Teil A der Kaufprozess-Analytik auf jeden Fall bauen. Die Messung speichert keine Feldwerte, kein Cookie, keine Drittanbieter. Preise und Vertragsinhalte sind nie Gegenstand von A/B-Tests.
- 2026-09-16: SimGym-Nummer +49 5208 9999006 ist Kanal 3 und bestätigt.
HUB_VERTRAEGE_SECRET_KEY(.envund/root/secrets/hub-vertraege-secret.key) nie verlieren, sonst sind Zugangsdaten und IBANs unlesbar.- Feldlisten und Abschlussweg sind je Anbieter verschieden: Tarife aus
extern_jsonableiten braucht frische Importe.
Verlauf
- Kaufprozess-Analytik Teil A live (v0.312.0 und v0.312.1), Anleitung für mitfit gemailt, Konzeptseite veröffentlicht.
- Zahlungsarten je Tarif (v0.263.2 bis v0.263.4), Agilea-Abschluss bewiesen, Termin-Service Umbuchung und Absage per Link (v0.261.0).
- Partner-Logos der Studio-Software in der Zentrale (v0.244.3).
- aidoo als dritter Provider (cc93a83), Tarifbild-Funktion (v0.235.0), ganze Tarifkarte klickbar.
- Tarifbild aus dem Medienpool, Agilea-Abschluss verdrahtet (v0.232.0).
- Korb auf Handy nicht mehr sticky (v0.214.2, fc676c3).
- Modul-Matrix und Klick-Dummy (v0.212.4, v0.213.3).
- Redesign
<sim-angebot>, Vertrags-PDF Design B (v0.195.0), Abschluss ohne Bankdaten (v0.198.0). - CORS-Fix für
sim-*.js(v0.166.0). - V3 Magicline schreibend (v0.141.1).
- Open-API-Rückkanal und Spiegel (ae94f3c, v0.129.1).
- V0 bis V2 live (7b23580, e4cbf70, a16e3be, d37c179, Hub v0.101.0 bis v0.111.0), Konzept und Spec geschrieben.
Wo liegt was
- Spec:
/root/sim-ops/docs/vertraege-konzept-2026-08.md(Datenmodell, Adapter-Interface, Fähigkeitsmatrix, Zustandsmaschine). Wiki:50-Strategien/Gesamtsystem/Vertraege und Verkaeufe Konzept.md, Leitseite20-Tools/Vertragsverkauf Online-Abschluss.md,40-Projekte/Kaufprozess Analytik und AB-Tests Konzept.md,40-Projekte/Kaufprozess-Messung Anleitung mitfit.md. - Code im Hub:
/root/sim-ops/hub/src/vertragAnbieter.ts,vertragTarife.ts,vertragAngebote.ts,vertragVerkaeufe.ts,vertragUebertragung.ts,vertragDokument.ts(PDF),vertraegeCore.ts,checkout[Core|Auswertung].ts. Widget:/root/sim-ops/hub/public/sim-angebot.js, Portal-Auswertungpublic/kaufprozess.js. - Tabellen: u. a.
tarife,tarif_marketing,angebote,verkaeufe,vertrag_anbieter(mitmodule_json),mitgliedschaften,checkout_ereignisse,checkout_tage. - Zentrale: Karte Vertrags-Anbieter, Tarife und Angebote in der Kundenakte (Reiter Verträge), Verkaufsliste mit Zahlungslink, Blatt Firma › Studio-Software & Schnittstellen.
- Öffentlich:
/portal/angebot/:public_key,/portal/angebot/:public_key/bestellen,/portal/vertrag/:token/zahlung. - Weitere Unterlagen:
hub/public/brand/studiosoftware/(Logos). Anleitung mitfit im Transferordner/root/transfer/checkout/.
