15

Étude de cas : les salles de l’association

De la demande floue au service qui tourne, avec ses compromis

Étude de cas 1513 min de lectureMis à jour le 20 novembre 2026

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
VPS2 vCPU, 4 Go, hébergé dans l’Union européenne12 €
Nom de domaine15 € par an1,25 €
Email transactionnel0 à 15 € selon le volume0 à 15 €
Sauvegarde hors sitePetit volume3 €
Total direct16,25 à 31,25 €
Maintenance2 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.