aidoo-Schnittstelle

aidoo (Aidoo Software GmbH, Schermbeck) ist eine Studio-Software, die einige Kunden einsetzen (Tschann, AktiVita Quedlinburg). Der Hub bindet sie nach Magicline und Agilea als dritten Vertrags-Provider an: Tarife lesen, Verträge abschließen, Probetermine buchen, Kursplan und Vertragsstatus zurücklesen. Parallel wurde die neue Aidoo API v2 zugesagt, mit der Storno, Umbuchung und Webhooks möglich werden. Dazu ein Partner-Werbevideo.

• Adapter lesend (28.08., cc93a83): Tarife aus firstcontracts, Prüfen, Rückkanal member/<nr> (c89a10c).
• Schreibend (28.08., Hub v0.243.0, 6abec26): Abschluss createmember dann newcontract mit Schreibsperre je Anbieter, Terminquelle aidoo (freetimes dann saveterm), Zentrale-Block im Terminquellen-Tab. Gegen die Test-DB end-to-end bewiesen.
• Bugfix 09.09. (Hub v0.262.2, 7677c27): undici fehlte im Image, der Adapter war in Produktion nie lauffähig gewesen, jetzt echte Abhängigkeit, Transportfehler in Klartext.
• Korrektur 09.09. (bb2447b): Es gab nie eine IP-Sperre. Resets kamen vom falschen Host (alter Server ohne Backend). Kundendatenbanken laufen auf demselben Host wie die Test-DB, mit eigenem Port je Kunde.
• Tschann Feldkirch (Anbieter 15) und Hohenems laufen, Terminquellen für Beratung, Alpha Cooling, Beckenboden, Lichttherapie je Standort (Quellen 10 bis 15), Erinnerung 24 h mit .ics. Umbuchung und Absage per Link bleibt für aidoo-Quellen aus, weil v0001 keinen Storno kennt.
• AktiVita Quedlinburg (Anbieter 17, Port 38155): Prüfung ok, Tarif-Import 0, vier Terminarten, Kursplan-Quelle aidoo gebaut und live (Hub v0.273.0, 74191a6).
• aidoo API v2: Zusage am 07.10., Doku am 08.10. neu gelesen. Neu: member PUT, Live-Auslastung (with_usage), presence mit Checkout, workplans, emailVerify, Webhooks (Beta). Contract POST/PUT/DELETE bleibt in Entwicklung, Abschluss bleibt über v0001 newcontract.
• Werbevideo: Konzept-Plan mit 9 Szenen live (08.10., fd44ab2). Zwei getrennte Videos (aidoo, Magicline), zuerst aidoo.

• René Partnerschaft und Partner-Key für die API v2 bei Burkhard Westermann (CEO) anfragen oder Jens um einen Test-Key bitten. Danach ▶ ich: v2-Adapter neben v0001 (Storno und Umbuchung, Webhooks, Leads POST, presence).
• René sechs Entscheidungen zum Werbevideo (Länge, Vorschau-Kennzeichnung, Beispielstudio, WhatsApp zeigen trotz Meta-Review, Schlussknopf, Reihenfolge).
• René aidoo-Logo-Freigabe bei Jada Bednorz-Dasser (Partnerkampagne), bis dahin intern. Einverständnis von Tschann (Michael) oder AktiVita für das Beispielstudio.
• ich Video nach den Entscheidungen mit dem Skill erklaervideo bauen, danach Magicline-Fassung.
• René Mailentwurf zur Kundenabstimmung AktiVita (Terminarten, Standort 1, Kursplan-Quelle) verschicken (Stand prüfen).
• René Jens fragen, warum avg_checkins_per_week und latest_checkin überall 0 bzw. leer sind, und ob deleteterm kommt (Stand der Antwort prüfen).
• ich Terminquelle Beratung 32 und Beckenboden-Onlinebuchung für AktiVita anlegen, nach Bestätigung des Standorts.
• ich Zentrale-UI des aidoo-Blocks einmal mit echtem Anbieter durchklicken (bisher nur per Container-Grep verifiziert).

• 2026-08-28: Test-DB h2877991.stratoserver.net dient zum Schreibtest, Testpersonen mit Adresse bei studiosinmotion.de (Catchall, damit René aidoo-Mails sieht).
• 2026-09-09: Bei aidoo-Zugängen ohne Host zuerst den Host h2877991.stratoserver.net probieren. Ein Reset genau 1 s nach TLS ohne Anfrage heißt kein Backend, nicht Sperre.
• 2026-09-09: Tarife bleiben bei uns, wenn firstcontracts leer ist (Tschann und AktiVita pflegen keine Online-Verträge in aidoo).
• Fehlerformat von v0001: immer HTTP 200 mit error im Body, der Adapter prüft den Body. utf8=1 nicht nutzen (Mojibake). member_sex nur m, f, d.
• Token = Vollzugriff auf Mitglieder und Mitarbeiter inklusive IBAN: nur Zweck-Felder holen, nie roh loggen. Beim Einlesen von Token-Dateien \r entfernen.
• 2026-10-08: Zwei getrennte Werbevideos (aidoo, Magicline), weil beide Partner gemeinsame Werbung wollen. Online-Vertragsabschluss, Öffnungszeiten, Preise, Wirkungszahlen und KI-Hinweise kommen nicht ins Video. Das aidoo-Logo ist gewollt, braucht aber Freigabe.

1. 08.10.2026
   Doku der API v2 neu gelesen, Zusage dokumentiert. Werbevideo-Konzept live (fd44ab2).
2. 13.09.2026
   aidoo als Datenquelle im Cockpit (Kontakte, Anlässe, Cockpit-Zahlen: 737b156, 2b52ca2).
3. 10.09.2026
   AktiVita Quedlinburg angebunden (Anbieter 17), Kursplan-Quelle aidoo live (Hub v0.273.0).
4. 09.09.2026
   Tschann Feldkirch (Anbieter 15), undici-Fix (v0.262.2), Host-Korrektur, Storno-Befund (v0001 kann es nicht), Terminquellen je Standort (2b9d574).
5. 08.09.2026
   Zweite, neue API v2 entdeckt (wiki.aidoo-online.de).
6. 07.09.2026
   Neuer Kundenzugang getestet, Mail an Jens (Storno für saveterm).
7. 29.08.2026
   Partner-Logos in der Zentrale (551198e).
8. 28.08.2026
   Start. Doku, Test-DB, Adapter lesend, Rückkanal, Abschluss und Terminquelle (cc93a83, c89a10c, 6abec26, Hub v0.243.0).

• Code: /root/sim-ops/hub/src/aidooCore.ts (Mapper), aidooKursplan.ts, Adapter in vertragAnbieter.ts, Terminquelle in terminQuellen[Core].ts. Tests: hub/test/aidooCore.test.ts.
• Zentrale: Karte Vertrags-Anbieter, Terminquellen-Tab mit aidoo-Block (Route /termin-quellen/aidoo-terminarten), Kursplan-Karte mit Quellenauswahl Kurspool, Magicline, aidoo.
• Zugangsdaten liegen unter /root/transfer/aidoo/, /root/transfer/tschann/, /root/transfer/aktivita/ und /root/transfer/keys/aidoo.txt (Rechte 600). Protokolle und Mailentwürfe im gleichen Ordner.
• Hub-Admin-API von innen: Basis http://10.0.1.21:8790, Header x-admin-token aus der Container-Umgebung (HUB_ADMIN_TOKEN).
• Spec: docs/vertraege-konzept (Abschnitt 4.4, Fähigkeitsmatrix). Wiki: 40-Projekte/aidoo-Schnittstelle.md.
• Doku des Partners: wiki.aidoo-online.de (Aidoo-API v2), alte Doku „aidooInterface“ v0001.
• Kontakte: Jens (Entwickler), Stefan Thiessen (Account Manager), Burkhard Westermann (CEO, Partnervertrag), Jada Bednorz-Dasser (Marketing).