Enterprise-Reservierungssystem – Übersicht
Das Enterprise-Reservierungssystem von PrimeCal baut auf denselben Kalender-, Ressourcen- und Reservierungsmodulen auf, die den Rest des Produkts antreiben. Der Unterschied liegt in Umfang und Steuerung: Jede Reservierung gehört jetzt zu einer Organisation, folgt Organisationsrollen, berücksichtigt die Verfügbarkeit des Personals und kann bei Bedarf über das eigene Stripe-Konto der Organisation eine Zahlung einziehen.
Zeitaufwand: 10–15 Minuten
Schwierigkeitsgrad: Mittel
Grundkonzepte
Organisationen und Plan-Limits
- Ein Store-Konto kann 1 aktive Organisation besitzen.
- Ein Enterprise-Konto kann bis zu 5 aktive Organisationen besitzen.
- Ein Benutzer kann mehreren Organisationen angehören, jeweils mit einer anderen Rolle.
- PrimeCal ermittelt immer die aktive Organisation aus deiner authentifizierten Sitzung, bevor es Organisationsdaten liest oder schreibt.
Rollen
- Admin: verwaltet Abrechnung, Stripe Connect, Branding, Mitglieder, Preisgestaltung und exportiert zahlungsbezogene Daten.
- Editor: verwaltet Ressourcentypen, Ressourcen und operative Reservierungen.
- Mitglied: kann Reservierungen einsehen und innerhalb der aktiven Organisation erstellen.
- Betrachter: nur Lesezugriff.
Ressourcentypen und Ressourcen
Ein Ressourcentyp ist die Dienstleistung oder Inventarkategorie, die du anbietest – zum Beispiel Esstisch, Massageraum oder Tennisplatz.
Eine Ressource ist das konkrete Element, das einer Reservierung zugewiesen werden kann – zum Beispiel Tisch 1, Raum B oder Platz 4.
PrimeCal unterstützt eine Reservierung für:
- eine Organisation
- einen Ressourcentyp
- eine oder mehrere Ressourcen desselben Typs
Verfügbarkeit und eigene Kalender
Die Verfügbarkeit wird berechnet aus:
- bestehenden Reservierungen
- Buchungsregeln des Ressourcentyps
- verwalteten Personalkalendern, wenn eine Ressource einer Person zugewiesen ist
Das bedeutet, eine Ressource kann als nicht verfügbar erscheinen, selbst wenn sie keine Reservierung hat – wenn ihr Besitzer einen kollidierenden persönlichen oder beruflichen Eintrag in einem verknüpften Kalender hat.
Öffentliche Buchungslinks
Der bevorzugte öffentliche Ablauf verwendet einen Organisations-Slug wie /book/acme-spa.
Kunden:
- wählen eine Dienstleistung
- wählen eine bestimmte Ressource oder eine beliebige verfügbare Ressource
- wählen einen Zeitslot
- geben Kontaktdaten ein
- zahlen wenn erforderlich oder bestätigen sofort, wenn keine Zahlung nötig ist
Ältere Ressource-Token-Links funktionieren weiterhin, aber die Organisations-Route bietet eine bessere Kundenerfahrung für Organisationen mit mehreren Dienstleistungen.
Stripe Connect
PrimeCal fungiert als Plattform. Jede Organisation verbindet ihr eigenes Stripe-Konto, und PrimeCal erstellt Checkout-Sitzungen auf diesem verbundenen Konto, wenn ein Ressourcentyp eine Zahlung erfordert.
PrimeCal speichert keine Rohdaten von Karten. Es speichert nur Reservierungsangebote, Stripe-Objektkennungen und den Zahlungsstatus.
Wie der gesamte Ablauf zusammenpasst
- Ein Admin erstellt die Organisation oder wechselt zur richtigen.
- Der Admin konfiguriert Mitglieder, Branding, Stripe und Ressourcentyp-Preise.
- Editoren erstellen die konkreten Ressourcen und halten die Personalkalender verknüpft.
- Kunden buchen über einen öffentlichen Link oder das Personal bucht intern.
- PrimeCal blockiert widersprüchliche Reservierungen, erfasst den angebotenen Betrag und leitet kostenpflichtige Buchungen bei Bedarf über Stripe weiter.
- Das Personal bearbeitet die Reservierung über den Kalender und das Reservierungsdetail-Panel.
Screenshot-Referenzen
Nimm diese Bilder auf und speichere sie, bevor du eine Release-Walkthrough veröffentlichst:
| Schritt | Datei | Bildunterschrift |
|---|---|---|
| Aktive Organisation | docs/assets/user-guide/enterprise-reservation-system/overview-active-organisation-switcher.png | Wechsle die aktive Organisation, bevor du Reservierungsdaten erstellst oder prüfst. |
| Dienstleistungsauswahl | docs/assets/user-guide/enterprise-reservation-system/overview-public-booking-service-selection.png | Kunden wählen zunächst die Dienstleistung und optional eine bestimmte Ressource. |
Verwende das vollständige Runbook unter
docs/DEVELOPER-GUIDE/mcp-server/enterprise-reservation-screenshot-runbook.md.
Sicherheits- und Compliance-Hinweise
- Die Mandantentrennung wird über den authentifizierten Organisationskontext durchgesetzt, nicht durch beliebige Client-Eingaben.
- Zahlungskonfiguration und Stripe-Onboarding sind reine Admin-Aufgaben.
- PrimeCal speichert nur die Mindestdaten, die für den Betrieb von Buchungen, Zahlungsstatus und Audits erforderlich sind.
- Wenn personenbezogene Daten entfernt werden müssen, können Reservierungsdatensätze anonymisiert werden, während für Audits erforderliche operative und finanzielle Referenzen erhalten bleiben.
Fehlerbehebung
Ich sehe einen Ressourcentyp oder eine Reservierung nicht, die ich erwarte
Vergewissere dich zunächst, dass du dich in der richtigen aktiven Organisation befindest. In PrimeCal ist der Organisationskontext Teil der Sicherheitsgrenze – der Wechsel zu einer anderen Organisation ändert, was das System zurückgeben darf.
Eine Ressource scheint frei zu sein, aber der Slot ist nicht verfügbar
Prüfe auf einen Konflikt im verknüpften Personalkalender. PrimeCal blockiert Slots, wenn die verwaltete Person bereits nicht verfügbar ist – auch wenn die Ressource selbst noch keine direkte Reservierung hat.