Réservation de pool

La réservation de pool est le mode de réservation d'entreprise pour les services où le client souhaite obtenir suffisamment d'inventaire correspondant, et non une ressource nommée spécifique. Les exemples typiques sont les couloirs de natation, les tables, les salles de soins, les kits de location ou les places de parking.

PrimeCal conserve la configuration sur le type de ressource, puis alloue les premières ressources concrètes disponibles lors de la création de la réservation.

Durée estimée : 10-15 minutes
Difficulté : Intermédiaire

Quand utiliser la réservation de pool

Utilisez la réservation de pool lorsque toutes les conditions suivantes sont remplies :

• le service est vendu comme une catégorie, et non comme un article nommé spécifique
• plusieurs ressources concrètes peuvent satisfaire la même réservation
• le personnel souhaite une définition de service unique, une règle de tarification unique et une allocation automatique
• la route de réservation publique doit afficher la disponibilité agrégée, par exemple 2 places restantes

Conservez la route par token de ressource hérité pour les liens à ressource unique uniquement. Les demandes de pool multi-articles appartiennent à la route de réservation de l'organisation, par exemple /book/acme-spa.

Choisir le bon bookingMode

PrimeCal stocke le comportement de réservation sur resourceType.bookingMode.

Mode	Signification	Idéal pour
SINGLE_RESOURCE	Chaque réservation doit rester sur une ressource concrète unique.	Salles, courts, bureaux nommés ou rendez-vous avec le personnel.
POOL	Le client réserve le service, et PrimeCal alloue les premières ressources correspondantes disponibles.	Tables, couloirs, kits de location ou tout inventaire interchangeable.
BOTH	Le personnel ou les clients publics peuvent choisir une ressource spécifique ou demander n'importe quelle ressource disponible dans le pool.	Flux mixtes où les ressources nommées ont de l'importance parfois, mais pas toujours.

Pour un parcours public de type pool, associez POOL ou BOTH à la page de réservation à périmètre d'organisation et publiez plus d'une ressource active du même type.

Liste de contrôle de configuration pour l'administrateur

1. Ouvrez l'espace de travail des réservations de l'organisation active.
2. Créez ou modifiez le type de ressource.
3. Définissez bookingMode sur POOL ou BOTH.
4. Ajoutez les ressources concrètes appartenant à ce pool.
5. Publiez la page de réservation de l'organisation au lieu de partager des liens par token de ressource.
6. Si le service est payant, activez les tarifs sur le même type de ressource.

Calcul des tarifs

La réservation de pool ne crée pas de table de tarification séparée. PrimeCal calcule toujours le prix de la réservation à partir du type de ressource.

La formule de devis actuelle est :

quotedTotalAmount = priceAmount * assignedResourceCount * durationHours

Notes :

• priceAmount est stocké en unités mineures de devise.
• assignedResourceCount est le nombre de ressources concrètes que PrimeCal alloue réellement depuis le pool.
• durationHours est dérivé de endTime - startTime.
• l'arrondi utilise l'arrondi demi-pair déterministe (banker's rounding) dans le service de tarification.

Exemple :

• priceAmount = 12500 (125,00)
• assignedResourceCount = 2
• duration = 1,5 heures

Résultat :

• quotedTotalAmount = 37500

Le même instantané de devis est ensuite stocké dans la réservation, de sorte que l'interface, Stripe et les flux d'audit lisent tous le même montant.

Comportement des paiements

La réservation de pool et la réservation payante fonctionnent ensemble :

• si pricingEnabled est désactivé, PrimeCal stocke des devis à valeur nulle
• si pricingEnabled est activé, PrimeCal stocke les champs de devis dans la réservation
• si paymentRequired est également activé, la réservation reste en pending_payment jusqu'à ce que Stripe confirme le succès via le flux webhook

Pour le parcours de paiement complet, consultez Réservations payantes.

Cibles des captures d'écran

Utilisez ces chemins d'accès exacts lors de la mise à jour de la documentation :

État	Fichier	Objectif
Mode réservation de pool dans l'éditeur admin	docs/assets/user-guide/enterprise-reservation-system/admin-resource-type-booking-mode-pool.png	Afficher bookingMode, les tarifs et les contrôles de paiement sur un type de ressource.
Grille de disponibilité du pool public	docs/assets/user-guide/enterprise-reservation-system/customer-pool-booking-availability-grid.png	Afficher la disponibilité agrégée des créneaux avec le sélecteur de quantité visible.
Étape de paiement du pool public	docs/assets/user-guide/enterprise-reservation-system/customer-pool-booking-payment-step.png	Afficher le total calculé côté serveur après une sélection multi-ressources.

L'assistant d'automation local pour ces espaces réservés est scripts/docs/capture-pool-booking-docs.cjs.

Espace réservé pour la configuration du pool par l'administrateur

Espace réservé pour la disponibilité du pool public

Espace réservé pour le paiement du pool public

Ressources associées

• Vue d'ensemble du système de réservation d'entreprise
• Guide de l'administrateur d'organisation
• Réservations payantes
• API de réservation de pool