Agilea-Schnittstelle

Agilea (Hersteller escrea GmbH) ist die Studio-Software von Life X. René wollte sie als zweiten Schnittstellenpartner neben Magicline in die Vertragswelt des Hubs holen: Vertragsangebote lesen, Online-Abschlüsse zurückschreiben, Mitglieder aktivieren, später Cockpit-Zahlen und Termine. Pilotkunde ist Life X (Ansprechpartner Thomas, bei Agilea Florian). Zusätzlich offen: Kann Agilea eine Weiterempfehlungs-Prämie automatisch gutschreiben?

• Adapter lesend (26.08., Hub v0.230.0, daa5642): Tarife aus contractTemplate (Filter syncToWeb und cEnabled), Schlüssel (id, studioId), Preise pro Woche, woechentlich als neuer Takt.
• Abschluss verdrahtet (27.08., v0.232.0, 23e0a34) mit drei Riegeln. Am 09.09. bewiesen auf der Testinstanz life-x-test (Hub v0.262.0 bis v0.263.4): gender und phone1 sind Pflicht, Direktaktivierung über activateOnlineContract mit dem webcontractToken aus faceforce/fetch, Frist (cDeadline) aus der Vorlage ab 10.09., Zahlungsarten je Tarif.
• Live-Sperre im Code (agileaInstanzSchreibbar): Schreiben nur auf migration oder Instanzen mit Namen auf -test.
• Life X: Anbieter 9 bis 12 (Dudweiler, Europaallee, Glattbach, Gersheim) auf life-x-test mit aktivierung=direkt, Angebote 3 bis 6 als echte Testbestellungen, Angebot 8 Gast-Training Europaallee. Die Testinstanz verschickt keine Agilea-Mails.
• Cockpit (15.09., Hub v0.307.0 und v0.307.1): lesend von der Live-Instanz (lese_instanz life-x, Nur-Lesen-Wächter), Vertragsspiegel über contract/fetch, Kontakte nach Ehemaligen-Regel, Check-ins aus checkIn (nur laufender Tag), Modus trocken. Agilea als Terminquelle für Probetrainings (S2.1).
• Standort-Daten übernommen (25.08.): Stammdaten, Öffnungszeiten (Freeda-Import), Angebote je Standort. Gersheim als Vorverkauf, Eröffnung Oktober 2026.
• Befund Prämie (20.09.): Bausteine existieren in Agilea (Buchungsarten Guthaben und Bonus, Gratis-Zusätze, Rabatte an Automaten-Leistungen), es gibt aber keine dokumentierte Schreib-Operation.
• Kontext 08.10.: Agilea trennt die Instanzen am 20.10., Life X braucht bis Anfang November eine Übergangslösung für Verträge über die Website (Ticket 851, abgespalten aus 717).

• René Ticket 851 beantworten (Thomas): Agilea-Instanztrennung am 20.10., Verträge über die Website ab 02. oder 06.11.; Firma zuordnen (Life X 201).
• René Frage nach Prämien-Schreibweg an Florian (Bonusgewährung, Guthabeneinzahlung je umdId oder Zusatz an laufenden Vertrag). Wiedervorlage 26 in der Zentrale, Mail an Florian war noch nicht formuliert (Stand 20.09., prüfen).
• René Mail Runde 3 an Florian weiterleiten (Einmalposten Erstanamnese 39 € je Vorlage, PayPal über API), Stand prüfen.
• René Erstanamnese 39 € mit Life X klären (steht in initialPostings, nicht in der Vorlage, Website weist ihn nicht aus).
• René Entscheidung Wechsel von Testinstanz auf Live-Instanz. Dafür ▶ ich: bewusste Code-Änderung an der Live-Sperre erst nach Renés ausdrücklichem Go, instanz=life-x, Angebote prüfen.
• Kunde Life X klärt Dudweiler-Drehkreuz, Gersheim (Aktivierung der Seite), Studiopendler 0 € und ob Saarbrücken Ost noch existiert.
• René Anlass „Vertragsende naht“ bei Agilea vor Echtbetrieb klären (Vertragsende ist Ende der laufenden Periode, keine Kündigung).
• René preprod→main für Life X, Glattbach Gast-Seite entscheiden.
• ich A3 Rückkanal als Nachtabgleich getContract, Webhooks (Check-ins) später, Typ-10-Mitglieder finden (userMasterData-fetch).
• ich bei Florian nachfragen: Check-in-Historie live, Kündigungsdatum.
• ich Sicherheitshinweis zu den weitreichenden Restapi-Rechten an Florian (zurückgestellt).

• 2026-08-25: Auth-Eigenheit: Der Header Authorization: Basic user:passwort wird wörtlich erwartet, ohne Base64. dataSource für Studios heißt studios. Zugangsdaten nur in /root/transfer/keys/keys.txt, nie in Chat oder Doku.
• 2026-08-25: Request-Weg (Token-Abruf) ist die Direktaktivierung nach Checkout. Webhooks gibt es, brauchen Einbau bei Agilea, daher bleibt A3 zunächst ein Nachtabgleich.
• 2026-08-27: Life-X-Live-Zeilen nie auf „Abschlüsse senden = ja“ ohne Renés ausdrückliches Go. Wellpass (0 €) nie blind anbieten.
• 2026-08-27: Mails an Partner vorsichtig, Kritik als Frage, wenige Punkte je Mail.
• 2026-09-09: Live-Sperre im Code, nicht als Konfig-Schalter.
• 2026-09-15: Telefon-KI hinten angestellt, Cockpit mit realistischen Zahlen zuerst, nichts verschicken. Lesen auf Live erlaubt, abgesichert nur lesend.
• 2026-10-04: Agilea-Vertragsende gilt als Ende der laufenden Periode, es ist keine Kündigung.
• Preise in Agilea gelten pro Woche. Einheiten: 1 Tag, 2 Monat, 3 Jahr, 4 Woche.

1. 08.10.2026
   Ticket 851 aus 717 abgespalten (Agilea-Instanztrennung 20.10., Übergangslösung bis Anfang November).
2. 04.10.2026
   Copilot „Frag dein Studio“ repariert (Hub v0.358.1, a456658), Hinweis zum Agilea-Vertragsende.
3. 20.09.2026
   Befund Prämie und Guthaben, Wiedervorlage 26, Spickzettel-Deck für Life X Termin 21.09. (0763aad).
4. 15.09.2026
   Cockpit liest die Live-Instanz (Hub v0.307.0 und v0.307.1: 4ca30de, 062f882).
5. 13.09.2026
   Cockpit S1.2, S2.1: Agilea-Mitglieder in Kontakte, Check-in-Poller, Terminquelle (d40113a, 3c41db3, v0.290.0 und v0.294.0).
6. 09.09.2026
   Alles bewiesen auf der Testinstanz: gender, phone1, Token-Abruf, Direktaktivierung, Zahlungsarten (db58035, 5726f4d, f2503fb, 64c2796, Hub v0.262.0 bis v0.263.4). Eigene Testinstanz life-x-test von Agilea bereitgestellt.
7. 30.08.2026
   Tarif-Import belegt Teaser und Features aus der Quelle vor (65c281e).
8. 27.08.2026
   A2 verdrahtet mit Schreibsperre, Life X lesend (Hub v0.232.0), Mail Runde 2 an Florian.
9. 26.08.2026
   A1 gebaut und live (Hub v0.230.0), Abschluss auf der Migrationsinstanz blockiert (Server-NPE).
10. 25.08.2026
    Antwort von Florian, Lesetest, Standort-Inventar, Life X im Hub verknüpft, Öffnungszeiten und Angebote übernommen.
11. 24.08.2026
    Start. Fragenkatalog an Agilea, Wiki-Leitseite angelegt.

• Code: /root/sim-ops/hub/src/agileaCore.ts, agileaTermineCore.ts, agileaKontakte[Core].ts, agileaVertraege[Core].ts, Adapter in vertragAnbieter.ts, Zahlarten in vertraegeCore.ts (zahlartenDesTarifs). Tests hub/test/agileaCore.test.ts.
• Zentrale: Karte Vertrags-Anbieter (Konfig instanz, benutzer, passwort, studio_id, schreibend, aktivierung, abschluss_studio_id, lese_instanz), Cockpit-Karte, Angebote für Life X.
• Instanzen: live life-x.agilea.de, Test life-x-test.agilea.de, allgemeine Testinstanz migration.agilea.de. API-Doku: apidoc.agilea.de/faceforce.html.
• Zugangsdaten in /root/transfer/keys/keys.txt (Abschnitt Agilea API). Mailvorlagen in /root/transfer/agilea/ (Runde 2 und 3).
• Wiki: 40-Projekte/Agilea-Schnittstelle.md. Life-X-Website-Repo studiowebsite-life-x.
• Hub-Mails der Testbestellungen gehen an Testadressen bei studios-in-motion.de, Testmitglieder 39543 und 39546 bleiben auf der Testinstanz.