Vue d'ensemble du système de réservation d'entreprise
Le système de réservation d'entreprise de PrimeCal s'appuie sur les mêmes calendriers, ressources et modules de réservation qui alimentent le reste du produit. La différence réside dans l'étendue et le contrôle : chaque réservation appartient désormais à une organisation, suit les rôles de l'organisation, respecte la disponibilité du personnel et peut collecter un paiement via le compte Stripe propre à l'organisation lorsque cela est requis.
Durée estimée : 10-15 minutes
Difficulté : Intermédiaire
Concepts clés
Organisations et limites de plan
- Un compte Store peut posséder 1 organisation active.
- Un compte Enterprise peut posséder jusqu'à 5 organisations actives.
- Un utilisateur peut appartenir à plusieurs organisations, chacune avec un rôle différent.
- PrimeCal résout toujours l'organisation active depuis votre session authentifiée avant de lire ou d'écrire des données d'organisation.
Rôles
- Admin : gère la facturation, Stripe Connect, l'image de marque, les membres, les tarifs et exporte les données liées aux paiements.
- Éditeur : gère les types de ressources, les ressources et les réservations opérationnelles.
- Membre : peut consulter les réservations et en créer au sein de l'organisation active.
- Observateur : accès en lecture seule.
Types de ressources et ressources
Un type de ressource est la catégorie de service ou d'inventaire que vous proposez, par exemple
Table de restaurant, Salle de massage ou Court de tennis.
Une ressource est l'élément concret pouvant être assigné à une réservation, par exemple
Table 1, Salle B ou Court 4.
PrimeCal prend en charge une réservation pour :
- une organisation
- un type de ressource
- une ou plusieurs ressources de ce même type
Disponibilité et calendriers personnels
La disponibilité est calculée à partir de :
- des réservations existantes
- des règles de réservation sur le type de ressource
- des calendriers du personnel géré lorsqu'une ressource est assignée à une personne
Cela signifie qu'une ressource peut apparaître comme indisponible même si elle n'a pas de réservation, si son propriétaire a un événement personnel ou professionnel conflictuel dans un calendrier lié.
Liens de réservation publique
Le flux public privilégié utilise un identifiant d'organisation comme /book/acme-spa.
Les clients :
- choisissent un service
- choisissent une ressource spécifique ou n'importe quelle ressource disponible
- choisissent un créneau horaire
- saisissent leurs coordonnées
- paient si requis ou confirment immédiatement lorsqu'aucun paiement n'est nécessaire
Les liens par token de ressource hérités fonctionnent toujours, mais la route par organisation offre un parcours client plus fluide pour les organisations multi-services.
Stripe Connect
PrimeCal joue le rôle de plateforme. Chaque organisation connecte son propre compte Stripe, et PrimeCal crée des sessions Checkout sur ce compte connecté lorsqu'un type de ressource exige un paiement.
PrimeCal ne stocke jamais les données de carte brutes. Il conserve uniquement les devis de réservation, les identifiants d'objets Stripe et l'état des paiements.
Comment le flux complet s'articule
- Un administrateur crée ou bascule vers l'organisation appropriée.
- L'administrateur configure les membres, l'image de marque, Stripe et les tarifs des types de ressources.
- Les éditeurs créent les ressources concrètes et maintiennent les calendriers du personnel liés.
- Les clients réservent via un lien public ou le personnel réserve en interne.
- PrimeCal bloque les réservations conflictuelles, enregistre le montant du devis et envoie les réservations payantes via Stripe lorsque cela est requis.
- Le personnel gère la réservation depuis le calendrier et le panneau de détails de réservation.
Références des captures d'écran
Capturez et conservez ces images avant de publier une présentation de version :
| Étape | Fichier | Légende |
|---|---|---|
| Organisation active | docs/assets/user-guide/enterprise-reservation-system/overview-active-organisation-switcher.png | Basculez l'organisation active avant de créer ou de consulter des données de réservation. |
| Sélection du service | docs/assets/user-guide/enterprise-reservation-system/overview-public-booking-service-selection.png | Les clients commencent par choisir le service et, optionnellement, une ressource spécifique. |
Utilisez le guide opérationnel complet dans
docs/DEVELOPER-GUIDE/mcp-server/enterprise-reservation-screenshot-runbook.md.
Notes de sécurité et de conformité
- L'isolation des locataires est appliquée à partir du contexte d'organisation authentifié, et non à partir de données client arbitraires.
- La configuration des paiements et l'intégration Stripe sont des tâches réservées aux administrateurs.
- PrimeCal stocke le minimum de données nécessaires pour gérer les réservations, l'état des paiements et les audits.
- Lorsque des données personnelles doivent être supprimées, les enregistrements de réservation peuvent être anonymisés tout en conservant les références opérationnelles et financières requises pour les audits.
Dépannage
Je ne vois pas un type de ressource ou une réservation attendu
Vérifiez d'abord que vous êtes dans la bonne organisation active. Dans PrimeCal, le contexte d'organisation fait partie de la frontière de sécurité : basculer vers une autre organisation change ce que le système est autorisé à retourner.
Une ressource semble libre mais le créneau est indisponible
Vérifiez s'il existe un conflit dans le calendrier du personnel lié. PrimeCal bloque les créneaux lorsque la personne gérée est déjà indisponible, même si la ressource elle-même n'a pas encore de réservation directe.