Aller au contenu
Meubles Morinière

Le projetCompétences et preuves15 min de lecture

Mesures

Ce que le projet mesure en performance, Core Web Vitals, tests, fiabilité, qualité et maintenabilité : les chiffres comptés au build, les seuils qui font échouer un script, les relevés datés, et un protocole reproductible pour ce qui n’est pas encore mesuré.

Voici ce que le projet sait mesurer, comment il le mesure, et ce qu’il ne mesure pas encore. Aucun chiffre n’est écrit à la main ici, sauf les relevés datés. Chacun de ces relevés donne sa date, sa méthode et sa source. Et je ne dis qu’une chose s’est améliorée que si j’ai une mesure avant et une mesure après, prises de la même façon.

Quatre sortes de chiffres

StatutCe que c’estCe qu’on peut en dire
Mesuré au buildcompté dans le dépôt à chaque build de cette doc, avec ce qui est comptél’état du code au dernier build
Seuil vérifiéun script échoue au-delà d’une limite, et la page dit quand il tourneque la limite est respectée, chaque fois que le script tourne
Relevé datéune mesure faite une fois, avec sa date, sa méthode et sa source, non revérifiée depuisl’état à cette date, rien sur la suite
Non mesuréaucune donnée dans le dépôt ni dans un outil consulté, et la page donne le protocole pour l’obtenirrien, tant que le protocole n’a pas été joué

Vue d’ensemble

DomaineIndicateurStatut
PerformancePoids du JavaScript du siteseuil vérifié au push, relevés datés
Poids du JavaScript de l’ERPseuil vérifié à la main seulement
Nombre de requêtes d’une lectureseuil vérifié par des tests sur Postgres
Temps de réponse des fonctions en productionrelevé daté
Part des requêtes servies par le cacherelevé daté
Core Web VitalsLCP, INP, CLS chez les visiteurscollecté, non consulté ici
CLS et LCP au bureauCLS : un relevé non daté, sans mesure après correction · LCP : jamais mesuré
TestsVolume, sortes et cas de testmesuré au build
Tests qui passentrelevé daté
Couverture, durée, instabiliténon mesuré
FiabilitéRéponses en erreur en productionrelevé daté
Anomalies recherchées chaque matinmesuré au build
Disponibilité, délai des webhooks, durée de restaurationnon mesuré
QualitéLint, typage, dérogationsseuil vérifié au push, mesuré au build
MaintenabilitéTaille du code, fichiers au-delà des seuils, copiesmesuré au build, relevé daté

Performance

Le poids du JavaScript

Pour le site, pnpm site:size mesure le JavaScript compressé après un build. Il y a un plafond pour le total et un autre pour ce que charge l’accueil, parce qu’une page peut doubler de poids sans que le total bouge. Quand un changement touche le site, le hook pre-push fait le build et lance ce contrôle. Dans le commentaire du script, on retrouve les relevés successifs de l’accueil, pris par ce même script. Dans le dépôt, c’est la seule évolution de performance que j’ai trouvée qui soit mesurée avant et après avec la même méthode.

HOME_HTMLapps/site/scripts/check-bundle-size.mjs · lignes 11–24
/**
 * Le JS que l'ACCUEIL fait charger, à part du total du site (analyse de performance de l'accueil,
 * 03/11/2026) : le plafond de 1,8 Mo additionne tous les chunks, et une page peut doubler son poids
 * sans qu'il bouge. Le build du 29/10/2026 en faisait charger 295 Ko gzip à l'accueil, polyfills
 * exclus ; le volet du panier, chargé à l'intention depuis le 03/11/2026, en est sorti. Le 06/11/2026,
 * l'accueil était remonté à 331 Ko : zod (~30 Ko) partait sur chaque page par les horaires du
 * magasin, la recherche et le menu du téléphone étaient chargés fermés. Sortis, il pèse 259 Ko ; le
 * plafond suit à 280 Ko pour que la prochaine dérive se voie.
 *
 * La coquille prérendue de l'accueil (`server/app/index.html`, `cacheComponents`) nomme tous ses
 * chunks : les `<script src>` et ceux que le flux RSC demande à l'hydratation. Les polyfills
 * (`noModule`) n'en sont pas : un navigateur récent ne les télécharge pas.
 */
const HOME_HTML = join(BUILD_DIR, "server", "app", "index.html");

L’ERP a aussi ses plafonds, par famille de pages et pour le total. Par contre, pnpm size ne tourne ni au push ni dans pnpm check. Une dérive ne se voit donc que si quelqu’un le lance.

FAMILY_BUDGETSapps/erp/scripts/check-initial-js.mjs · lignes 10–14
const FAMILY_BUDGETS = [
	{ family: "/produits/", limit: 588 },
	{ family: "/connexion", limit: 435 },
	{ family: "/", limit: 512 },
];

Le nombre de requêtes d’une lecture

Le temps d’une requête change d’une machine à l’autre. Le nombre de requêtes, lui, ne change pas. Du coup, la fiche et la liste des commandes de l’ERP ont un test sur Postgres qui compte leurs requêtes et refuse un N+1. Une ligne de plus sur la commande ne doit ajouter aucune requête.

test « n'ajoute AUCUNE requête quand la commande porte trois lignes — pas de N+1 »apps/erp/test/db/admin-order-query-count.db.test.ts · lignes 114–119
it("n'ajoute AUCUNE requête quand la commande porte trois lignes — pas de N+1", async () => {
	const order = await getAdminOrder(threeLineOrderId);

	expect(order?.items).toHaveLength(3);
	expect(selectsEmitted()).toHaveLength(1);
});

Le temps de réponse en production

Ce relevé daté du 13 novembre 2026 vient de Vercel Observability, sur l’environnement de production, du 16 octobre au 13 novembre 2026 (la journée du 13 est incomplète). Sur cette période, le site n’a du trafic qu’à partir du 17 octobre.

Temps jusqu’au premier octet des fonctionsp50p75p95Appels
Site public328 ms1 233 ms3 334 ms11 522
ERP50 ms186 ms1 985 ms11 001
Site public, selon le démarrage de la fonctionp75Part des appels
à chaud892 ms82,5 %
préchauffée1 918 ms3,8 %
à froid3 586 ms13,7 %
Site public, réponse du cacheRequêtesPart
servie depuis le cache17 41568,8 %
servie périmée, refaite après4 34917,2 %
page prérendue1 5676,2 %
absente du cache9643,8 %
revalidée5572,2 %
hors cache, ou non qualifiée4681,8 %

Ce relevé a ses limites. Le temps des fonctions ne compte que les requêtes qui appellent une fonction. Une page servie par le cache n’y est donc pas, et sur ces pages-là le visiteur n’attend pas ces temps. Les robots et les tâches planifiées sont comptés. Le dépôt ne fixe aucun objectif. Ces chiffres décrivent donc un état, sans dire s’il est bon ou mauvais. Et ils ne disent pas d’où vient l’écart entre un démarrage à chaud et un démarrage à froid.

Pour le rejouer, on lance ces commandes depuis apps/site puis apps/erp (projet lié à Vercel), en gardant la même fenêtre :

vercel metrics vercel.function_invocation.ttfb_ms -a p75 --prod --since 2026-10-16 --until 2026-11-14 -g 1d
vercel metrics vercel.function_invocation.ttfb_ms -a p75 --prod --since 2026-10-16 --until 2026-11-14 --group-by functionStartType
vercel metrics vercel.request.count --prod --since 2026-10-16 --until 2026-11-14 --group-by cacheResult

Vercel ne garde ses données qu’un temps, et c’est ce qui limite la fenêtre qu’on peut encore interroger. Pour trouver d’où viennent les temps longs, la prochaine mesure à prendre, c’est la même requête groupée par route (--group-by route).

Core Web Vitals

Le site envoie à Vercel Speed Insights les Core Web Vitals de ses visiteurs, mesurés sur leurs appareils. Si le visiteur a refusé sur la page Cookies, le site n’envoie rien.

SiteTelemetryapps/site/shared/components/site-telemetry.tsx · lignes 28–40
/**
 * La vitesse vue par les visiteurs (Core Web Vitals : chargement, réponse au geste, stabilité),
 * mesurée sur leurs appareils : le build et ses mesures en local ne disent pas ce que vit un
 * téléphone sur une connexion lente.
 */
export function SiteTelemetry() {
	return (
		<>
			<Analytics beforeSend={measured} />
			<SpeedInsights beforeSend={measured} />
		</>
	);
}

On peut lire ces données dans le tableau de bord Vercel du projet du site. Pour les interroger en ligne de commande, il faut l’offre Speed Insights Plus. Le 13 novembre 2026, vercel metrics vercel.speed_insights.lcp_ms a répondu payment_required. Du coup, cette page ne donne aucun chiffre de LCP, d’INP ou de CLS mesuré chez les visiteurs.

Google juge une page au 75ᵉ centile de ses visites. Il faut un LCP de 2,5 s au plus, un INP de 200 ms au plus et un CLS de 0,1 au plus.

Les relevés au bureau

Sur la page des favoris quand elle est vide, un relevé au bureau a donné un CLS de 0,22. Le pied de page remontait sous les yeux pendant le chargement. Depuis, la grille d’attente réserve au moins un écran (apps/site/app/(site)/favoris/page.tsx). Par contre, la valeur après la correction n’a pas été notée, donc aucune mesure ne prouve l’effet.

Pour le LCP de l’accueil, l’échelle des largeurs d’image a été réglée sur la pièce de la vitrine, qui est la candidate au LCP. Le réglage vient d’un calcul de pixels : le navigateur prenait une image 2,2 fois plus grande que nécessaire. Le LCP, lui, n’a été mesuré ni avant ni après.

IMAGE_DEVICE_SIZESapps/site/shared/constants/image-optimizer.ts · lignes 1–10
/**
 * L'échelle de l'optimiseur d'images (`images` de `next.config.ts`), partagée avec ce qui en
 * compose les adresses hors de `next/image` : la visionneuse de la galerie.
 *
 * 1080 et 1600 comblent les deux grands sauts de l'échelle (analyse de performance de l'accueil,
 * 03/11/2026). La grande pièce de la vitrine, candidate LCP, mesure 43 rem au bureau : sur un écran
 * 2×, il lui faut 1 376 px, et le navigateur prenait la 2048 (2,2 fois les pixels de la 1600). Au
 * téléphone, 72 vw d'un écran de 390 px en 3× demandent 842 px : la 1080 au lieu de la 1200.
 */
export const IMAGE_DEVICE_SIZES = [640, 828, 1080, 1200, 1600, 2048] as const;

Le protocole à jouer

  1. Chez les visiteurs, dans Speed Insights, sur 28 jours, on relève pour les mobiles puis pour les ordinateurs le p75 de LCP, INP et CLS, le nombre de visites mesurées et les cinq routes les plus vues. Avec Speed Insights Plus, on peut rejouer la même mesure en ligne de commande : vercel metrics vercel.speed_insights.lcp_ms -a p75 --prod --since 28d --group-by deviceType.
  2. Au laboratoire, pour comparer deux versions, on lance Lighthouse en mode mobile, cinq passages sur la même adresse. On garde la médiane et on note la version de l’outil, la date et le commit.
for run in 1 2 3 4 5; do
  pnpm dlx lighthouse@12.2.1 https://meublesmoriniere.fr/ --only-categories=performance \
    --output=json --output-path="lighthouse-$run.json" --chrome-flags="--headless=new"
done

Un relevé de laboratoire ne remplace pas la mesure chez les visiteurs. Il compare deux versions dans les mêmes conditions, mais il ne dit pas ce que ça donne sur un téléphone avec une connexion lente.

Tests

cas de test écrits (it, test), une table it.each comptant pour un
20 951
*.test.ts(x) et *.spec.ts sous apps/ et packages/
lignes de tests : unitaires, sur Postgres, qui lisent le code, de bout en bout
381 832
*.test.ts(x) et *.spec.ts sous apps/ et packages/
suites de tests jouées sur une vraie base Postgres
111
apps/*/test/db/*.db.test.ts
tests de régression, dont la plupart lisent le code source et refusent tout écart à une règle
92
apps/*/test/*.regression.test.ts
fichiers de parcours de bout en bout (Playwright), lancés à la main
52
apps/*/e2e/*.spec.ts
Mesuré dans le dépôt à chaque build de cette documentation.

Le compte des cas est statique. Une table it.each y compte pour un cas, alors que Vitest en compte un par ligne. Il ne dit donc pas combien de tests tournent vraiment.

D’après un relevé daté du 7 novembre 2026 (reports/Storefront fiabilité en production.md), tous les tests unitaires du site passent, soit 3 588 tests. Côté ERP, 13 tests de share-document-button échouaient sous Node 22, parce qu’il manque Blob.stream() dans jsdom, alors que le projet demande Node 24.

Ce qui n’est pas mesuré

IndicateurÉtatProtocole
Couverturemesurable, sans seuil ni résultat notépnpm test:coverage, depuis apps/erp puis apps/site : noter le résumé (text-summary) avec la date et le commit
Durée des suitesnon mesuréepnpm exec vitest run --reporter=json --outputFile=vitest.json : la durée de chaque test est dans le rapport
Instabiliténon mesuréepnpm e2e --repeat-each=5 sur les tests touchés : un test qui échoue une fois sur cinq est instable
Tests e2elancés à la main, aucun résultat notépnpm e2e, depuis chaque application (Tests)
Évaluation de Fisherlancée à la main, et ses rapports restent sur le poste (apps/erp/ai-eval/, ignoré par git)pnpm ai:eval, puis noter le score du rapport avec la date, le modèle et le commit

Fiabilité

Ce relevé daté du 13 novembre 2026 vient lui aussi de Vercel Observability, sur l’environnement de production, du 16 octobre au 13 novembre 2026.

ApplicationRequêtesRéponses 5xxPart des 5xxRéponses 429 (limitation de débit)
Site public25 320170,067 %aucune
ERP115 17270,006 %134

Les volumes sont encore faibles, donc il suffit de quelques erreurs pour faire bouger la part. Et ce relevé ne dit rien de la disponibilité ressentie. On le rejoue avec vercel metrics vercel.request.count --prod --since 2026-10-16 --until 2026-11-14 --group-by httpStatus.

En prod, la veille de l’ERP cherche chaque matin ses anomalies dans les données (argent reçu par Stripe sans vente, remboursement en attente, webhook non traité, trou dans la numérotation des factures…) et les envoie à l’équipe. La liste de ces anomalies est mesurée au build. Leurs résultats, eux, restent dans la base de production et dans les messages envoyés, donc hors du dépôt.

anomalies que la veille de l’ERP recherche en production
28
apps/erp/modules/monitoring/constants/anomaly-readings.ts#ANOMALY_READINGS
Mesuré dans le dépôt à chaque build de cette documentation.

D’après un relevé daté du 7 novembre 2026 (reports/Storefront fiabilité en production.md), un audit a testé le site en conditions de production, avec des pannes de base jouées sur un build de production local. Il a trouvé et corrigé dix-sept défaillances. Trois d’entre elles bloquaient le site ou faisaient payer à tort. Chaque correctif a un test qui échoue sans lui.

Ce qui n’est pas mesuré

IndicateurÉtatProtocole
Disponibilitéaucune sonde externeà défaut, la part quotidienne des 5xx : la requête ci-dessus avec -g 1d. Une sonde externe sur / et sur une fiche donnerait la disponibilité vue de l’extérieur
Délai de traitement des webhookscalculable, jamais relevésur une copie de la base : SELECT percentile_cont(ARRAY[0.5, 0.95]) WITHIN GROUP (ORDER BY "processedAt" - "receivedAt") FROM "WebhookEvent" WHERE "receivedAt" > now() - interval '28 days', et le nombre d’événements dont processedAt est vide
Durée d’une restaurationune restauration jouée ne laisse pas de trace dans le dépôtchronométrer pnpm db:restore vers une base locale, de la commande à la fin de ses vérifications, et noter la durée avec la taille de l’archive (Sauvegardes et reprise)
Incidents et délai de rétablissementaucun journal d’incidentsnoter chaque incident de production avec sa détection, sa cause et son rétablissement, daté

Qualité

ESLint tourne avec --max-warnings=0 dans le check de chaque application et de cette doc. TypeScript est en mode strict, avec noUncheckedIndexedAccess et exactOptionalPropertyTypes (packages/config/tsconfig.base.json). Le hook pre-push lance le typage et le lint des deux applications sur le commit poussé (Qualité).

Sauf qu’une règle à zéro avertissement ne dit rien des exceptions écrites dans le code. Du coup, on les compte ici.

dérogations ESLint écrites dans le code (eslint-disable)
18
code hors tests
dérogations au typage (@ts-expect-error, @ts-ignore)
0
code hors tests
contraintes CHECK écrites à la main, relues sur la base à chaque migration appliquée
169
apps/erp/scripts/constants/db-invariants.ts#EXPECTED_CHECKS
Mesuré dans le dépôt à chaque build de cette documentation.

Les vulnérabilités des dépendances ne sont pas suivies dans le temps. pnpm audit:prod se lance à la main et cherche les vulnérabilités graves des dépendances de production, mais aucun relevé n’est noté. Le protocole, c’est de le lancer au début de chaque mois et de noter le nombre d’alertes par gravité.

Maintenabilité

lignes de TypeScript hors tests : routes, modules et code commun des deux applications, sources des paquets
408 398
apps/{erp,site}/{app,modules,shared}, packages/*/src
lignes de tests : unitaires, sur Postgres, qui lisent le code, de bout en bout
381 832
*.test.ts(x) et *.spec.ts sous apps/ et packages/
composants de plus de 600 lignes, le seuil de la règle de maintenabilité
22
*.tsx hors tests · règle : AGENTS.md
services de l’ERP au-delà de 500 lignes, où la règle demande de les découper
1
apps/erp/**/*.service.ts · règle : apps/erp/AGENTS.md
fichiers de code encore copiés d’une application à l’autre, liste qui ne peut que diminuer
28
scripts/twins.manifest.json
écarts assumés entre les deux applications, chacun consigné avec son empreinte
77
scripts/twins.manifest.json
Mesuré dans le dépôt à chaque build de cette documentation.

Un relevé daté du 9 novembre 2026 porte sur l’ERP seul, par comptage (find, grep, git log). Il donne 295 000 lignes de code applicatif dans 2 824 fichiers, 302 000 lignes de tests, 66 fichiers de plus de 500 lignes dont 15 composants de plus de 800, et 2 373 commits en 60 jours. On peut le relire avec git show b3f1e845d2:docs/allegement-erp.md.

Les mesures ci-dessus couvrent les deux applications et les paquets, avec leurs propres seuils. On ne peut donc pas les comparer à ce relevé, et je n’en tire aucune tendance. Pour suivre une tendance, il faut relancer la même commande à date fixe. Par exemple, pour le rythme de l’ERP depuis son arrivée dans apps/erp (avant le 18 octobre, ce déménagement compterait comme des ajouts) :

git log --since=2026-10-18 --numstat --format="" -- apps/erp \
  | awk '{ added += $1; removed += $2 } END { print added " ajoutées, " removed " retirées" }'

Ce que cette page ne fait pas

  • Elle ne lance aucun test. Les mesures au build comptent les tests écrits. Elles ne disent pas s’ils passent.
  • Ses relevés de production sont une photo à une date. Ils ne se mettent pas à jour. Et comme Vercel ne garde ses données qu’un temps, on ne pourra pas toujours les rejouer à l’identique.
  • Elle ne fixe aucun objectif que le projet n’a pas fixé lui-même. Les seuils cités sont ceux du code.

Sur cette page