Sports, créneaux et limites

À quoi sert cet écran. Régler, pour chaque sport, la durée d’un créneau et les durées proposées, en voyant tout de suite la journée qu’ils donnent, puis jusqu’où les joueurs réservent, combien de matchs à venir chacun peut tenir et jusqu’à quand ils annulent sans frais. Le ou la responsable du club le modifie ; l’équipe de l’accueil le lit, réglages grisés.

Régler un sport

1. Durée d’un créneau : 15, 30, 45, 60, 90 ou 120 minutes. Les créneaux partent de l’ouverture de chaque terrain, chaque jour : celle de son horaire.
2. Durées proposées : un à quatre créneaux à la suite (« 1 créneau · 45 min », « 2 créneaux · 90 min »). Changer la durée d’un créneau garde les durées qui tombent encore juste.
3. L’écran dit si le sport est rigide (les réservations s’enchaînent, sans trou : le créneau égale la durée la plus courte) ou libre (on peut commencer à chaque créneau).
4. Les créneaux de la journée : pour chaque groupe de jours aux mêmes horaires, le début des premiers créneaux et du dernier (« 08h00 · 08h45 · 09h30 · … · 22h15 »), leur nombre, et les minutes invendables entre la fin du dernier créneau et la fermeture. Si les terrains du sport ne suivent pas tous le même horaire aujourd’hui, un bloc par horaire, avec ses terrains (« Après-midi · Squash 2 »).
5. Limites de réservation (voir plus bas).
6. Enregistrer : la durée d’un créneau, les durées et les limites du sport, en une fois.

Limites de réservation

Pour qu’un joueur ne garde pas les meilleurs créneaux pour lui seul :

• Réservable jusqu’à : combien de jours à l’avance un joueur réserve (1 à 365). L’accueil réserve sans limite de date.
• Matchs à venir par joueur : combien de matchs confirmés, pas encore joués, un joueur peut tenir dans ce sport. Vide : sans limite. Les pré-réservations en cours de paiement et les cours ne comptent pas ; un match annulé ou joué libère une place. Une série compte pour un seul match : le prochain.
• Compter aussi les matchs où le joueur est invité : sinon seuls comptent les matchs réservés à son nom (par lui, ou par l’accueil pour lui). Coché, un partenaire déjà à la limite ne peut pas être ajouté à un nouveau match.
• Annulation gratuite jusqu’à : jusqu’à quand l’organisateur annule lui-même, sans frais, dans ce sport. Par défaut « la règle du club », celle de Réglages › Club ; choisissez un délai propre au sport (du début du créneau à 72 h avant) s’il doit différer, par exemple 48 h pour le padel et 2 h pour le squash.
• Une formule peut allonger la fenêtre et relever la limite pour ses abonnés (« réserver 3 semaines à l’avance ») : c’est la plus généreuse qui compte, tant qu’elle est en cours (un carnet épuisé ne compte plus). Un sport sans limite le reste.

Au-delà, la réservation est refusée avec la raison : dans l’application du joueur (« Tu as déjà 3 matchs à venir dans ce sport : c’est la limite du club »), à l’accueil (qui peut Réserver quand même, ou Nommer quand même en nommant un passage) et par MCP (TooManyActiveBookings).

Les règles

• Changer la durée d’un créneau est toujours possible. Les réservations à venir qui ne tombent plus sur la nouvelle grille sont listées avant d’enregistrer : elles restent où elles sont, marquées hors créneau au planning. Rien n’est déplacé, rien n’est recalculé, le prix ne change pas.
• Les pauses (midi, un sport qui ouvre plus tard) ne se règlent pas ici : ce sont des blocages, chaque semaine si besoin.
• Les horaires d’ouverture se règlent dans Horaires.
• Seul le gérant voit cet écran.

Les états de l’écran

• Chargement : « Chargement des sports… ».
• Erreur : le message et Réessayer.
• Aucun sport : « Aucun sport n’est encore configuré pour ce club. »
• Refus : la raison reste affichée en haut de la page.

Pour les développeurs

• Limites : la mutation saveSportLimits(sport, bookingWindowDays, maxActiveBookings, capCountsParticipations, cancelFreeUntilMin) (cancelFreeUntilMin : minutes avant le début, null = la règle du club, absent = inchangé) ; un joueur lit les siennes avec myBookingLimits(sport) (fenêtre, limite, matchs déjà comptés). Refus : OutsideBookingWindow, TooManyActiveBookings (userId, name, maxActiveBookings, activeBookings) ; l’accueil passe outre avec overrideLimit: true sur createBooking.
• bo api query -q '{ sportStepPreview(sport: "squash", stepMin: 60) { schedules { name resourceNames days { dow starts tailMin } } offGrid { id } } }' donne l’aperçu ; la mutation saveSportStep enregistre (DurationNotOnStep si une durée n’est pas un multiple du pas).
• MCP : sport_configs, sport_step_preview, save_sport_step, save_sport_limits, my_booking_limits ; create_booking prend overrideLimit.