ModuleEn productionEmbarquéXL · > 2 semainesreservation.booking-core

Reservation et disponibilites

Transformer une demande en reservation sans surbooking, avec prix et disponibilite revalides cote serveur.

Le problème qu'il règle

Un calendrier joli ne suffit pas : plusieurs canaux peuvent reserver la meme ressource au meme instant.

Preuve — En production

Tourne chez un client qui s'en sert, données réelles persistées.

Empaquetage — Embarqué

Tissé dans le code du client. À réécrire, pas à copier.

Les écrans

Back-office · 2

Route	Écran	Ce qu'on y fait	La forme	Les états
`/appointments`	Reservations	Traiter et rechercher les dossiers.	Table/fiches, filtres, actions et historique.	Demande, confirmee, annulee, no-show, terminee.
`/calendar`	Calendrier	Visualiser l'occupation et agir dans le contexte.	Jour/semaine/mois, ressources et detail lateral.	Vide, surcharge, fermeture, conflit.

Site public · 1

Route	Écran	Ce qu'on y fait	La forme	Les états
`/book/[business]`	Reserver	Choisir une prestation disponible et confirmer.	Wizard progressif et recapitulatif.	Chargement, aucun creneau, collision, acompte, succes.

Espace client · 1

Route	Écran	Ce qu'on y fait	La forme	Les états
`/portal/[token]`	Portail client	Consulter et modifier selon les regles.	Resume, actions autorisees et contact.	Actif, hors delai, annule, token invalide.

Où l'IA intervient

L'autonomie se lit avant la technique. « Propose » est le défaut de la maison : l'outil prépare, une personne valide. Tout ce qui « agit » doit nommer son garde-fou.

ProposeChatbot

Cherche les disponibilites et prepare la reservation avec les memes APIs.

Tool calling

Ce qui tourne tout seul

Déclencheur	Effet	Comment
Reservation confirmee	Envoyer confirmation et synchroniser le calendrier	Outbox + Brevo/WhatsApp + Google Calendar
Annulation	Liberer l'inventaire et proposer la place a la waitlist	RPC + worker

Ce qu'on peut activer dedans

Disponibilite

availability

Creneau, capacite partagee, praticien ou actif physique.

Tunnel

wizard

Offre, date, participants/client, recap et acompte.

Agenda

calendar

Jour, semaine, mois et detail.

Liste d'attente

waitlist

Promotion controlee apres liberation.

Recurrence

recurring

Serie editable sans perdre l'historique.

Portail client

portal

Suivi/deplacement/annulation tokenises.

Sous le capot

Données

services
resources
appointments
blocked_slots
occurrences
waitlist
appointment_events

Composants réutilisables

BookingWizard
AvailabilityPicker
Calendar
AppointmentDetail
Waitlist

Services externes

· Google Calendar
· Brevo
· WhatsApp
· SystemPay

Rôles et droits

· Client
· Operateur
· Manager

Ce qu'il faut autour

Il exige

Il ne cohabite pas avec

Aucun conflit connu.

D'autres en dépendent

Location, flotte et contrats

Les pièges

Chacun vient d'un incident réel, relevé dans les commentaires du code d'origine. C'est la partie du catalogue qui vaut le plus cher : elle évite de repayer la même leçon.

La contrainte anti-chevauchement vit en DB, pas seulement dans l'UI.
Un prix inconnu n'est jamais zero.

Ce qu'il ne fait pas, et ce qui reste à faire

Hors périmètre

· Yield management
· Channel manager universel

Pour le mettre vraiment sur étagère

· Separer adapters appointment/capacity/resource.
· Publier API idempotente et migrations de reference.

Où c'est prouvé

Studio Belleza

En production

/home/jordy/projects/Studio Belleza/studio-belleza/src/lib/slots.ts

Pahono (moteur Bookflow)

Livré

/home/jordy/projects/PACIFIK'AI/solutions/bookflow/dashboard/src/lib/booking-core.ts

Aqua Safari / résa multi-opérateur

Démo simulée

/home/jordy/projects/tourisme-backoffice/src/lib/booking/disponibilite.ts

Vérifié contre le code le 2026-08-27. Au-delà de quatre-vingt-dix jours sans revérification, une fiche décrit un souvenir, pas un dépôt.

beautesantetourismerestaurationcoachinglocation