Zielgruppen

Die Orbinaut-Dokumentation richtet sich an sechs klar getrennte Zielgruppen. Jede Gruppe braucht andere Einstiege. Produktanleitungen, Widget und REST-API bleiben in eigenen Bereichen, damit niemand den falschen Kontext liest.

Hinweis

Rollenbeschreibungen beziehen sich auf den Workspace (Organisation). Provider-Konto und Teilnehmerkonto sind getrennte Kontotypen.

Owner

Bedarf: Workspace einrichten, Verantwortung und Abrechnung halten, kritische Freigaben steuern.

Vorwissen: Du kennst dein Kursangebot und weißt, wer im Team Owner, Admin oder Trainer:in sein soll. Zahlungsanbieter-Kenntnisse sind nur nötig, wenn du kostenpflichtige Angebote mit Stripe Connect freischaltest.

Zentrale Aufgaben:

1. Workspace anlegen und Stammdaten prüfen
2. Weitere Owner und Admins einladen; den letzten Owner nicht entfernen können
3. Filialen und den ersten Kurs vorbereiten
4. Stripe Connect für Karten und geeignete SEPA-Lastschriften (Beta) verbinden – nur Owner
5. Widgets und Integrationen freigeben oder an Admins delegieren

Einstieg in der Dokumentation: Einrichtung

Weitere Seiten: Team und Rollen, Zahlungen, Verfügbar und geplant.

Admin

Bedarf: Den laufenden Kursbetrieb im Dashboard steuern, ohne die Owner-Sonderrechte für Zahlungsanbieter und Owner-Verwaltung zu brauchen.

Vorwissen: Du kennst Termin, Kapazität und Ort der Kurse. Du weißt, wo die öffentliche Kursseite und optional Widget oder API angebunden werden.

Zentrale Aufgaben:

1. Kurse anlegen, speichern und veröffentlichen
2. Buchungen prüfen, manuell anlegen und stornieren
3. Filialen pflegen
4. Widgets und Integrationen (API-Keys, ICS, Webhooks) verwalten
5. Teammitglieder als Admin oder Trainer:in einladen (keine Owner-Änderungen)

Einstieg in der Dokumentation: Dashboard

Weitere Seiten: Kurs anlegen, Kurse verwalten, Buchungen verwalten, Kontakte verwalten, Filialen, Widget, REST-API.

Trainer:in

Bedarf: Kurs- und Buchungsstand einsehen, ohne Stammdaten, Team oder Integrationen zu ändern.

Vorwissen: Du kennst die Kurse, die du betreust, und brauchst keinen Überblick über Zahlungsanbieter oder Embed-Keys.

Zentrale Aufgaben:

1. Kurse und Kalender im Workspace lesen
2. Buchungen und Warteliste einsehen
3. Anwesenheit am Kurstag speichern
4. Nachricht an alle senden, wenn du der Durchführung zugewiesen bist

Achtung

Trainer:innen haben bei Stammdaten überwiegend Leserechte. Kurse anlegen oder ändern, Buchungen anlegen oder stornieren, Filialen, Widgets, Integrationen, Versandprotokoll und Teamverwaltung bleiben Ownern und Admins vorbehalten.

Einstieg in der Dokumentation: Team und Rollen

Weitere Seiten: Dashboard, Anwesenheit und Teilnahmebestätigung, Begriffe.

Teilnehmende

Bedarf: Einen veröffentlichten Kurs buchen, Bestätigung nachvollziehen, optional ein Teilnehmerkonto nutzen.

Vorwissen: Kein Orbinaut-Dashboard nötig. Du brauchst den Link zur Kursseite oder ein eingebettetes Widget auf der Website des Anbieters.

Zentrale Aufgaben:

1. Kursseite öffnen (/b/{slug}/{courseId})
2. Als Gast buchen (kostenlos oder mit Checkout bei kostenpflichtigen Kursen)
3. Bei voller Kapazität optional auf die Warteliste
4. Optional ein Teilnehmerkonto aktivieren – getrennt vom Anbieterkonto
5. Coaching-Guthaben aus gebuchten Paketen auf freie Termine einlösen

Einstieg in der Dokumentation: Öffentliche Buchung

Weitere Seiten: Teilnehmerkonto, Produktreise.

Entwickler: Widget

Bedarf: Das Buchungs-Widget auf einer Website einbinden, Origins und Keys korrekt setzen, Design und Events nutzen. Die Buchung selbst läuft auf der gehosteten Kursseite.

Vorwissen: HTML/JavaScript und Domain-Freigaben. Du brauchst Zugriff auf einen Workspace mit Owner- oder Admin-Rechten, um Widget-Keys zu erzeugen.

Zentrale Aufgaben:

1. Widget im Dashboard anlegen und Domains freigeben
2. Embed-Snippet mit Platzhalter YOUR_WIDGET_KEY testen
3. Freigegebene Kurse, den Link Buchen und Events (orbinaut:ready, orbinaut:book-clicked, orbinaut:error) prüfen. Das Widget enthält kein Buchungsformular.
4. Fehlerfälle (Origin, Key, Kursstatus) eingrenzen

Tipp

Widget-Keys und Secrets gehören nicht in öffentliche Repositories, Screenshots oder Tickets. In Beispielen immer YOUR_WIDGET_KEY verwenden. Siehe Schreibstil.

Einstieg in der Dokumentation: Widget

Weitere Seiten: Einbinden, Konfigurieren, Fehlerbehebung.

Entwickler: REST-API

Bedarf: Kurs- und Buchungsdaten lesend anbinden, Kalenderfeed (ICS) und den Webhook-Eventkatalog nutzen.

Vorwissen: HTTP, Bearer-Auth und Webhook-Signaturen. Schreibende REST-Endpunkte gibt es in der Beta nicht.

Zentrale Aufgaben:

1. API-Key im Dashboard erzeugen (Owner/Admin)
2. Lesende Endpunkte für Kurse und Buchungen aufrufen
3. ICS-Feed abonnieren
4. Webhook-Eventkatalog empfangen und Signatur prüfen

Achtung

Die öffentliche REST-API, ICS und Webhooks sind Beta. Zapier und Google-Kalender-Sync sind nicht ausgeliefert. Marketingtexte können veraltet sein – siehe Verfügbar und geplant.

Einstieg in der Dokumentation: REST-API

Weitere Seiten: Quickstart, Referenz, Webhooks und Kalender.

Schnellzuordnung

Zielgruppe	Einstiegs-URL	Nicht hier suchen
Owner	/anleitungen/einrichtung/	Widget-Events, OpenAPI-Details
Admin	/anleitungen/dashboard/	Teilnehmerkonto-Login
Trainer:in	/anleitungen/team-und-rollen/	Zahlungsanbieter verbinden
Teilnehmende	/anleitungen/oeffentliche-buchung/	Dashboard-Teamverwaltung
Widget-Entwickler	/widget/	REST-API-Keys
REST-Entwickler	/rest-api/	Widget-Embed-Snippet

Zurück zum Überblick Grundlagen.