Créer une API REST CRUD avec Node.js et Express

// src/depots/fiches.memoire.js
const fiches = [
  { id: 11, visiteurId: 7, mois: '2026-09', etat: 'VA', montantValide: 389.2 },
  { id: 12, visiteurId: 7, mois: '2026-10', etat: 'CR', montantValide: null },
  { id: 13, visiteurId: 8, mois: '2026-10', etat: 'CL', montantValide: null },
];
let prochainId = 14;

export function lister({ visiteurId, etat }) {
  return fiches.filter((f) => (!visiteurId || f.visiteurId === visiteurId) && (!etat || f.etat === etat));
}

export function trouverParId(id) {
  return fiches.find((f) => f.id === id) ?? null;
}

export function existe(visiteurId, mois) {
  return fiches.some((f) => f.visiteurId === visiteurId && f.mois === mois);
}

export function creer(visiteurId, mois) {
  const fiche = { id: prochainId++, visiteurId, mois, etat: 'CR', montantValide: null };
  fiches.push(fiche);
  return fiche;
}

export function changerEtat(id, etat) {
  const fiche = trouverParId(id);
  fiche.etat = etat;
  return fiche;
}

export function supprimer(id) {
  fiches.splice(fiches.findIndex((f) => f.id === id), 1);
}

// src/controllers/fiches.controller.js (version en mémoire)
import * as depot from '../depots/fiches.memoire.js';
import { ErreurApi } from '../erreurs.js';

const FORMAT_MOIS = /^\d{4}-(0[1-9]|1[0-2])$/;
const ETATS = ['CR', 'CL', 'VA', 'MP'];
const TRANSITIONS = { CR: ['CL'], CL: ['VA'], VA: ['MP'], MP: [] };

function idDepuis(req) {
  const id = Number(req.params.id);
  if (!Number.isInteger(id) || id < 1) {
    throw new ErreurApi(404, 'fiche-introuvable', 'Fiche introuvable', `La fiche ${req.params.id} n'existe pas.`);
  }
  return id;
}

function ficheOu404(id) {
  const fiche = depot.trouverParId(id);
  if (!fiche) throw new ErreurApi(404, 'fiche-introuvable', 'Fiche introuvable', `La fiche ${id} n'existe pas.`);
  return fiche;
}

// GET /v1/fiches?etat=CL&visiteur=7
export function lister(req, res) {
  const { etat, visiteur } = req.query;
  if (etat !== undefined && !ETATS.includes(etat)) {
    throw new ErreurApi(422, 'validation', 'Données invalides', `État inconnu : ${etat}.`);
  }
  res.json(depot.lister({ etat, visiteurId: visiteur ? Number(visiteur) : undefined }));
}

// GET /v1/fiches/12
export function lire(req, res) {
  res.json(ficheOu404(idDepuis(req)));
}

// POST /v1/fiches  {"visiteurId": 7, "mois": "2026-11"}
export function creer(req, res) {
  const { visiteurId, mois } = req.body ?? {};
  if (!Number.isInteger(visiteurId) || typeof mois !== 'string' || !FORMAT_MOIS.test(mois)) {
    throw new ErreurApi(422, 'validation', 'Données invalides', 'visiteurId (entier) et mois (AAAA-MM) sont obligatoires.');
  }
  if (depot.existe(visiteurId, mois)) {
    throw new ErreurApi(409, 'fiche-existante', 'Fiche déjà créée', `Une fiche existe déjà pour le mois ${mois}.`);
  }
  const fiche = depot.creer(visiteurId, mois);
  res.status(201).location(`/v1/fiches/${fiche.id}`).json(fiche);
}

// PATCH /v1/fiches/12  {"etat": "CL"}
export function changerEtat(req, res) {
  const fiche = ficheOu404(idDepuis(req));
  const etat = req.body?.etat;
  if (!TRANSITIONS[fiche.etat].includes(etat)) {
    throw new ErreurApi(409, 'transition-interdite', "Changement d'état interdit",
      `Une fiche à l'état ${fiche.etat} ne peut pas passer à l'état ${etat}.`);
  }
  res.json(depot.changerEtat(fiche.id, etat));
}

// DELETE /v1/fiches/12
export function supprimer(req, res) {
  const fiche = ficheOu404(idDepuis(req));
  if (fiche.etat !== 'CR') {
    throw new ErreurApi(409, 'fiche-cloturee', 'Fiche non modifiable', 'Seule une fiche en cours se supprime.');
  }
  depot.supprimer(fiche.id);
  res.sendStatus(204);
}

// src/routes/fiches.routes.js
import { Router } from 'express';
import * as fiches from '../controllers/fiches.controller.js';

export const routeurFiches = Router();

routeurFiches.get('/', fiches.lister);
routeurFiches.post('/', fiches.creer);
routeurFiches.get('/:id', fiches.lire);
routeurFiches.patch('/:id', fiches.changerEtat);
routeurFiches.delete('/:id', fiches.supprimer);

// src/app.js
import express from 'express';
import { gestionnaireErreurs, routeInconnue } from './erreurs.js';
import { routeurFiches } from './routes/fiches.routes.js';

export const app = express();
app.use(express.json());
app.use('/v1/fiches', routeurFiches);
app.use(routeInconnue);
app.use(gestionnaireErreurs);

curl -s 'http://localhost:3000/v1/fiches?etat=CL'

[{"id":13,"visiteurId":8,"mois":"2026-10","etat":"CL","montantValide":null}]

curl -i -X POST http://localhost:3000/v1/fiches -H 'Content-Type: application/json' -d '{"visiteurId": 7, "mois": "2026-11"}'

HTTP/1.1 201 Created
Location: /v1/fiches/14
Content-Type: application/json; charset=utf-8

{"id":14,"visiteurId":7,"mois":"2026-11","etat":"CR","montantValide":null}

HTTP/1.1 409 Conflict
Content-Type: application/problem+json; charset=utf-8

{"type":"https://api.gsb.example/problemes/fiche-existante","title":"Fiche déjà créée","status":409,"detail":"Une fiche existe déjà pour le mois 2026-11.","instance":"/v1/fiches"}

curl -i -X PATCH http://localhost:3000/v1/fiches/14 -H 'Content-Type: application/json' -d '{"etat": "VA"}'

HTTP/1.1 409 Conflict
Content-Type: application/problem+json; charset=utf-8

{"type":"https://api.gsb.example/problemes/transition-interdite","title":"Changement d'état interdit","status":409,"detail":"Une fiche à l'état CR ne peut pas passer à l'état VA.","instance":"/v1/fiches/14"}

curl -i -X DELETE http://localhost:3000/v1/fiches/14

HTTP/1.1 204 No Content

const TRANSITIONS = { CR: ['CL'], CL: ['VA'], VA: ['MP'], MP: [] };

function paginer(elements, page, limite) {
  const total = elements.length;
  const debut = (page - 1) * limite;
  return {
    donnees: elements.slice(debut, debut + limite),
    pagination: { page, limite, total, pages: Math.ceil(total / limite) },
  };
}

// src/services/fiches.service.js (extrait de la version finale)
import * as depot from '../depots/fiches.depot.js';
import { ErreurApi } from '../erreurs.js';

const TRANSITIONS = { CR: ['CL'], CL: ['VA'], VA: ['MP'], MP: [] };

export function verifierTransition(etatActuel, nouvelEtat) {
  if (!TRANSITIONS[etatActuel]?.includes(nouvelEtat)) {
    throw new ErreurApi(409, 'transition-interdite', "Changement d'état interdit",
      `Une fiche à l'état ${etatActuel} ne peut pas passer à l'état ${nouvelEtat}.`, { etatActuel });
  }
}

// Calcul en centimes : en virgule flottante, 57 × 0.62 donne 35.339999999999996.
export function calculerTotal(lignesForfait, fraisHorsForfait) {
  const centimes = (montant) => Math.round(montant * 100);
  const forfait = lignesForfait.reduce((somme, l) => somme + l.quantite * centimes(l.montantUnitaire), 0);
  const horsForfait = fraisHorsForfait.reduce((somme, f) => somme + centimes(f.montant), 0);
  return (forfait + horsForfait) / 100;
}

// src/controllers/fiches.controller.js (version finale)
import * as service from '../services/fiches.service.js';

export async function lire(req, res) {
  res.json(await service.lireFiche(req.utilisateur, req.valide.params.id));
}

export async function creer(req, res) {
  const fiche = await service.creerFiche(req.utilisateur, req.valide.body.mois);
  res.status(201).location(`/v1/fiches/${fiche.id}`).json(fiche);
}

export async function changerEtat(req, res) {
  res.json(await service.changerEtat(req.utilisateur, req.valide.params.id, req.valide.body.etat));
}