Une demande réelle arrive rarement sous la forme d’un cahier des charges. Elle arrive sous la forme
d’une phrase : « on perd du temps avec les réservations de salles ». Le travail consiste à
transformer cette phrase en périmètre, en modèle, en workflow, puis en service que quelqu’un
utilise vraiment.
Ce cas est reconstitué pour l’exercice. L’association, les chiffres et les incidents sont
plausibles, pas réels. Les montants sont des hypothèses de travail à remplacer par les vôtres.
L’objectif n’est pas de copier la solution, mais de voir l’ordre des décisions et ce qui aurait pu
être évité.
1. La demande, telle qu’elle arrive
Objet : gestion des salles
Bonjour, nous sommes une association de 120 adhérents. Nous avons trois salles et un tableau Excel
partagé. Les gens nous écrivent, on répond quand on peut, et il arrive que deux personnes
réservent la même salle. Est-ce que vous pouvez nous faire un site ?
La demande contient déjà une solution : « un site ». Si on l’accepte sans discuter, on risque de
construire une interface avant d’avoir compris le problème. Les trois difficultés réelles sont
ailleurs : les conflits de créneaux, le délai de réponse et la trace de qui a confirmé quoi.
La première décision est donc de ne pas répondre tout de suite par une technologie. On reformule :
« Vous voulez que les adhérents puissent demander une salle, que personne ne confirme deux fois le
même créneau, et que le bureau puisse retrouver l’historique. C’est bien cela ? » Cette reformulation
permet de distinguer le besoin du moyen.
2. Cadrage : ce qui est dans le périmètre, ce qui n’y est pas
Le cadrage tient sur une page. Il nomme les utilisateurs, les contraintes et les critères de réussite.
Il dit aussi ce qui ne sera pas fait, ce qui est la partie la plus difficile à écrire et la plus utile
pour la suite.
Dans la version 1
- Formulaire de demande avec créneaux et salle.
- Vérification de disponibilité dans la base.
- Confirmation par email avec référence.
- Rappel automatique la veille.
- Planning administrateur et export CSV.
- Journal des confirmations et annulations.
Hors périmètre
- Paiement et facturation.
- Application mobile native.
- Compte adhérent complet avec mot de passe.
- Gestion des clés physiques.
- Réservation de matériel.
- Connexion avec le logiciel comptable.
Critères de réussite
- Zéro double réservation sur trois mois.
- Réponse sous un jour ouvré.
- 80 % des demandes sans échange manuel.
- Une restauration testée avant la mise en ligne.
- Le bureau retrouve qui a confirmé, et quand.
Ce que le cadrage évite : une réunion où chacun projette des fonctionnalités
différentes. Il permet aussi de refuser proprement : « le paiement n’est pas dans cette version, voici
ce qu’il faudrait pour l’ajouter ».
3. Le modèle de données
Trois tables suffisent pour la version 1 : les salles, les adhérents et les réservations. Le point
délicat n’est pas le nombre de tables, c’est le chevauchement des créneaux. Une vérification dans
l’interface ne protège pas de deux demandes simultanées. La base doit trancher.
CREATE EXTENSION IF NOT EXISTS btree_gist;
CREATE TYPE reservation_statut AS ENUM ('demandee', 'confirmee', 'annulee', 'refusee');
CREATE TABLE salles (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
nom text NOT NULL UNIQUE,
capacite int NOT NULL CHECK (capacite > 0),
active boolean NOT NULL DEFAULT true
);
CREATE TABLE adherents (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
nom text NOT NULL,
email text NOT NULL,
actif boolean NOT NULL DEFAULT true,
consentement_le timestamptz
);
CREATE UNIQUE INDEX idx_adherents_email ON adherents (lower(email));
CREATE TABLE reservations (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
salle_id bigint NOT NULL REFERENCES salles(id),
adherent_id bigint NOT NULL REFERENCES adherents(id),
debut timestamptz NOT NULL,
fin timestamptz NOT NULL,
statut reservation_statut NOT NULL DEFAULT 'demandee',
cle_idempotence text NOT NULL UNIQUE,
cree_le timestamptz NOT NULL DEFAULT now(),
CHECK (fin > debut),
CHECK (fin - debut <= interval '4 hours')
);
ALTER TABLE reservations
ADD CONSTRAINT reservations_sans_chevauchement
EXCLUDE USING gist (
salle_id WITH =,
tstzrange(debut, fin, '[)') WITH &&
) WHERE (statut IN ('demandee', 'confirmee'));
CREATE INDEX idx_reservations_salle_debut ON reservations (salle_id, debut);
Pourquoi une contrainte EXCLUDE : le CHECK empêche une fin avant le
début. Il n’empêche pas deux réservations qui se chevauchent. Si l’application vérifie puis insère,
deux demandes peuvent passer entre les deux étapes. La contrainte EXCLUDE fait le
contrôle dans la base, au moment de l’écriture. La deuxième transaction échoue, et l’API peut répondre
proprement.
Pourquoi une clé d’idempotence : un formulaire renvoyé deux fois, ou un retry après un
timeout, ne doit pas créer deux réservations. La clé est générée par le formulaire, transmise dans
l’en-tête, puis stockée avec une contrainte d’unicité. Si elle existe déjà, l’API renvoie la
réservation existante au lieu d’en créer une seconde.
Ce que le modèle ne règle pas : les réservations récurrentes, les listes d’attente et
les annulations avec remboursement. Ce sont des besoins de la version 2. Les ajouter maintenant
ralentirait la livraison sans preuve qu’ils servent.
4. Le workflow, étape par étape
Le workflow n’est pas le cerveau du système. Il coordonne des opérations qui doivent rester simples et
vérifiables. La disponibilité est calculée par la base, pas par une accumulation de nœuds.
| Étape |
Où |
Ce qui peut échouer |
| Recevoir la demande |
Webhook n8n |
JSON invalide, appel en double, tentative de spam. |
| Valider les champs |
Nœud Code ou IF |
Date passée, durée supérieure à quatre heures, email absent. |
| Vérifier la disponibilité |
Requête PostgreSQL |
Conflit, base indisponible, lenteur. |
| Créer la réservation |
Insertion avec clé d’idempotence |
Doublon, violation de la contrainte de chevauchement. |
| Notifier le bureau |
Email ou canal interne |
Boîte pleine, quota, adresse invalide. |
| Confirmer |
Écran admin puis mise à jour |
Deux personnes cliquent en même temps. |
| Envoyer le rappel |
Tâche planifiée, veille à 18 h |
Double envoi après un retry, fuseau horaire. |
| Exporter |
Requête mensuelle |
Format CSV, accents, séparateur, données manquantes. |
La validation humaine reste en version 1. Le volume est faible, les cas limites sont
nombreux, et le bureau a besoin de garder la main sur les exceptions. Automatiser la confirmation
tout de suite donnerait l’impression d’un système magique jusqu’au premier cas bizarre. Une fois que
les règles sont stables, la confirmation peut devenir automatique.
Le chemin d’erreur compte autant que le chemin heureux : si l’email de confirmation
échoue, la réservation ne doit pas être annulée. Elle reste en base, une alerte est envoyée, et une
nouvelle tentative est planifiée. Le client ne doit pas recevoir un message qui dit « échec » alors
que la salle est réservée.
5. L’API : quatre routes suffisent
Une API n’a pas besoin d’être grande pour être claire. Quatre routes couvrent le besoin, avec des
statuts explicites et une séparation entre l’accès public et l’accès administrateur.
| Méthode et route |
Accès |
Réponses utiles |
POST /api/demandes |
Public, limité en débit |
201 créé, 400 invalide, 409 conflit, 429 trop d’appels. |
GET /api/salles/{id}/disponibilites |
Public |
200 avec créneaux libres, 400 plage invalide. |
POST /api/reservations/{id}/confirmer |
Administrateur |
200 confirmée, 404 absente, 409 déjà annulée. |
POST /api/reservations/{id}/annuler |
Administrateur ou lien signé |
200 annulée, 404 absente, 409 déjà annulée. |
Un 409 n’est pas une panne : c’est le contrat qui dit que l’état a changé. Le formulaire
doit proposer des alternatives, pas afficher « une erreur est survenue ». Exemple de réponse :
{
"erreur": "creneau_indisponible",
"message": "La salle est déjà réservée sur ce créneau.",
"alternatives": [
{ "debut": "2026-11-18T14:00:00+01:00", "fin": "2026-11-18T16:00:00+01:00" },
{ "debut": "2026-11-19T09:00:00+01:00", "fin": "2026-11-19T11:00:00+01:00" }
]
}
Authentification : le formulaire public n’a pas de compte. Il est protégé par une
limitation de débit, un champ piège et une validation serveur. L’administration utilise une session
avec second facteur. Le workflow utilise un compte de service dont les droits se limitent aux tables
nécessaires.
Idempotence : l’en-tête Idempotency-Key est généré par le formulaire. La
clé est unique en base. Si la même demande revient, l’API renvoie la réservation existante avec un
200, pas une deuxième ligne.
6. L’interface : trois écrans, pas plus
Le formulaire
Six champs : nom, email, salle, date, créneau, message. Les créneaux
déjà pris ne sont pas proposés. Les erreurs s’affichent à côté du champ. La confirmation donne
une référence courte, pas un identifiant technique illisible.
Le planning
Une vue semaine par salle. Les statuts se distinguent sans ouvrir la
fiche. Un clic confirme, un second clic annule après confirmation. L’état vide dit « aucune
réservation cette semaine », pas un grand blanc.
L’administration
Liste filtrable, export CSV, journal des actions. Les actions
irréversibles demandent une confirmation. Le bouton « annuler » n’est pas collé au bouton
« confirmer ».
Le formulaire affiche les créneaux libres avant l’envoi. C’est la meilleure prévention du conflit :
on ne propose pas ce qui n’existe pas. La contrainte en base reste nécessaire, car l’affichage peut
être périmé de quelques secondes.
7. Gouvernance : les décisions qui tiennent après le départ
Rôles et accès
- Adhérent : dépose une demande, reçoit un lien signé pour annuler.
- Bureau : confirme, annule, exporte.
- Service : lit et écrit uniquement les tables utiles.
- Lecture seule : consulte le planning sans modifier.
Secrets et journal
- Mot de passe base, SMTP et jeton admin dans un coffre.
- Rotation tous les six mois et au départ d’une personne.
- Journal : identifiant d’exécution, action, auteur, date.
- Pas de contenu de message ni de donnée personnelle inutile dans les logs.
Sauvegardes
- Dump quotidien de la base.
- Copie hebdomadaire hors site.
- Restauration testée une fois par trimestre.
- Durée de restauration notée dans le runbook.
Données personnelles
- Nom et email seulement, pas de date de naissance.
- Durée de conservation à valider avec le bureau, par exemple treize mois après la dernière
réservation.
- Procédure de suppression sur demande.
- Contrat de sous-traitance avec l’hébergeur et le service d’email.
Ce n’est pas de la bureaucratie. C’est ce qui permet de répondre à « qui a confirmé cette réservation ? »
six mois plus tard, et de restaurer le service sans chercher un mot de passe dans une boîte mail
personnelle.
8. Le coût, avec des hypothèses
Les montants ci-dessous sont des hypothèses de travail datées de novembre 2026. Ils servent à rendre le
compromis visible, pas à servir de devis.
| Poste |
Hypothèse |
Coût mensuel |
| VPS | 2 vCPU, 4 Go, hébergé dans l’Union européenne | 12 € |
| Nom de domaine | 15 € par an | 1,25 € |
| Email transactionnel | 0 à 15 € selon le volume | 0 à 15 € |
| Sauvegarde hors site | Petit volume | 3 € |
| Total direct | | 16,25 à 31,25 € |
| Maintenance | 2 heures par mois | à valoriser |
Comparaison avec la situation actuelle : huit heures par mois de saisie et de
relances, valorisées 20 € par heure, soit 160 €. Après le projet : deux heures de maintenance, soit
40 €, plus 16 à 31 € de services. Le gain théorique est de 89 à 104 € par mois.
Construction : quatre jours, soit 640 € si on valorise le temps à 20 € par heure, ou
1 600 € si on facture 400 € par jour. Le délai de retour se situe donc entre 6 et 18 mois selon la
valorisation. Ce n’est pas spectaculaire, et c’est normal.
Ce que le calcul ne dit pas : le gain financier seul ne justifie pas toujours le
projet. Ici, l’argument principal est la réduction des doubles réservations, la traçabilité et la
tranquillité du bureau. Si ces trois éléments n’ont pas de valeur pour vous, ne construisez pas.
9. La mise en production : la checklist
- Une restauration a été testée sur une base vide, chronomètre en main.
- Les chemins d’erreur ont été provoqués : email indisponible, base lente, double soumission.
- La limitation de débit et la clé d’idempotence sont actives.
- Les secrets ne sont ni dans le workflow exporté, ni dans le dépôt Git.
- L’accès administrateur utilise le second facteur.
- Une sonde surveille le service et la dernière exécution réussie.
- Le runbook tient sur une page, avec contacts et procédures.
- Le bureau a été formé en trente minutes, avec un cas réel.
- La durée de conservation des données est configurée ou documentée.
- L’export CSV a été ouvert dans un tableur, accents et dates compris.
10. Trois mois plus tard : ce qui a cassé
Le service a reçu 118 demandes. 96 % ont été traitées sans échange manuel. Quatre conflits ont été
détectés par la contrainte, et un doublon a été évité par la clé d’idempotence. Deux incidents
méritent d’être racontés, car ils ressemblent à ceux que vous rencontrerez.
Le rappel envoyé deux fois
Le service d’email a dépassé le délai d’attente. Le workflow a
réessayé et le rappel est parti une seconde fois. Cause : la nouvelle tentative a repris avant
que le statut d’envoi soit enregistré. Correction : vérifier le statut et journaliser l’envoi
avant de réessayer.
Le changement d’heure
Une réservation à cheval sur le changement d’heure a été décalée
d’une heure. Cause : une conversion en heure locale avant stockage. Correction : stocker en
timestamptz, afficher en Europe/Paris, et tester les dates de
changement.
Ce qui a été reporté : le paiement, l’application mobile et la connexion unique. Ils
ne manquent pas. Ce que je ferais autrement : écrire le runbook avant la mise en
production, ajouter un lien d’annulation dans l’email de confirmation, limiter les données
personnelles dans les journaux et tester la restauration plus tôt.
Aucun de ces incidents n’est spectaculaire. C’est le quotidien d’un outil qui sert : des erreurs
prévisibles, des corrections documentées et des décisions qu’on assume.
11. À vous de jouer
Prenez le cas et modifiez-le. Les exercices ci-dessous ont un livrable et un critère de réussite. Ils
peuvent se faire sans écrire de code pour les deux premiers.
| Exercice |
Livrable |
Critère de réussite |
| Écrire les dix questions du bureau. |
Une liste numérotée. |
Aucune question n’oblige à dupliquer une donnée pour y répondre. |
| Ajouter la contrainte de chevauchement. |
Une migration SQL. |
Deux insertions simultanées sur le même créneau : une seule passe. |
| Gérer l’annulation et la liste d’attente. |
Un modèle et trois règles. |
Une place libérée est proposée au premier de la liste, avec une échéance. |
| Écrire la réponse 409 et le message affiché. |
Un exemple JSON et un texte utilisateur. |
La personne comprend qu’elle n’a pas fait d’erreur et voit une alternative. |
| Rédiger le runbook. |
Une page, trois scénarios de panne. |
Une personne qui ne connaît pas le projet peut agir sans appeler l’auteur. |
| Refaire le calcul de coût avec vos chiffres. |
Un tableau à 12 et 36 mois. |
La conclusion assume ce qui n’est pas monétisé. |
12. Journal de décisions
Les décisions importantes sont écrites, avec l’alternative écartée et la date de réexamen. C’est ce
document qui évite de rediscuter les mêmes choix tous les trois mois.
| Décision |
Alternative écartée |
Raison |
À revoir |
| PostgreSQL pour les réservations |
Airtable seul |
La contrainte de chevauchement doit être dans la base. |
Si le volume reste sous 20 demandes par mois et que personne ne peut administrer la
base. |
| n8n pour les intégrations |
Tout écrire en code |
Les emails, les rappels et les exports sont plus rapides à brancher. |
Si le volume dépasse 1 000 réservations par mois. |
| Validation humaine en version 1 |
Confirmation automatique |
Les cas limites sont nombreux et le volume est faible. |
Après trois mois, si moins de 5 % des demandes demandent une correction. |
| Email seulement |
SMS |
Le budget ne le justifie pas et les adhérents lisent leurs emails. |
Si les rappels ne sont pas lus. |
| VPS dans l’Union européenne |
Service managé hors UE |
Coût, maîtrise et simplicité pour ce volume. |
Si les contraintes légales ou le budget changent. |
| Pas de compte adhérent |
Mot de passe et espace personnel |
Un lien signé suffit pour demander et annuler. |
Si le self-service devient le mode principal. |
Ce que ce cas ne prouve pas : il ne prouve pas que n8n ou PostgreSQL sont toujours le
bon choix. Il montre un enchaînement de décisions pour un volume, une équipe et une contrainte
donnés. Changez le volume, les compétences ou la contrainte légale, et la réponse change. Le réflexe
à garder est la question, pas la recette.