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 Kurse 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. Zahlungsanbieter (Stripe Connect, 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, 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. Operativen Stand vor Kursbeginn prüfen

Achtung

Trainer:innen sind bewusst read-mostly. Kurse anlegen oder ändern, Buchungen anlegen oder stornieren, Filialen, Widgets, Integrationen und Teamverwaltung bleiben Owner/Admin vorbehalten.

Einstieg in der Dokumentation: Team und Rollen

Weitere Seiten: Dashboard, 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

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.

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, Design und Client-Events prüfen
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 booking.created 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 booking.created empfangen und 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.