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
| Statut | Ce que c’est | Ce qu’on peut en dire |
|---|---|---|
| Mesuré au build | compté 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 tourne | que 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 depuis | l’é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’obtenir | rien, tant que le protocole n’a pas été joué |
Vue d’ensemble
| Domaine | Indicateur | Statut |
|---|---|---|
| Performance | Poids du JavaScript du site | seuil vérifié au push, relevés datés |
| Poids du JavaScript de l’ERP | seuil vérifié à la main seulement | |
| Nombre de requêtes d’une lecture | seuil vérifié par des tests sur Postgres | |
| Temps de réponse des fonctions en production | relevé daté | |
| Part des requêtes servies par le cache | relevé daté | |
| Core Web Vitals | LCP, INP, CLS chez les visiteurs | collecté, non consulté ici |
| CLS et LCP au bureau | CLS : un relevé non daté, sans mesure après correction · LCP : jamais mesuré | |
| Tests | Volume, sortes et cas de test | mesuré au build |
| Tests qui passent | relevé daté | |
| Couverture, durée, instabilité | non mesuré | |
| Fiabilité | Réponses en erreur en production | relevé daté |
| Anomalies recherchées chaque matin | mesuré au build | |
| Disponibilité, délai des webhooks, durée de restauration | non mesuré | |
| Qualité | Lint, typage, dérogations | seuil vérifié au push, mesuré au build |
| Maintenabilité | Taille du code, fichiers au-delà des seuils, copies | mesuré 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.
apps/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.
apps/erp/scripts/check-initial-js.mjs · lignes 10–14const 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.
apps/erp/test/db/admin-order-query-count.db.test.ts · lignes 114–119it("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 fonctions | p50 | p75 | p95 | Appels |
|---|---|---|---|---|
| Site public | 328 ms | 1 233 ms | 3 334 ms | 11 522 |
| ERP | 50 ms | 186 ms | 1 985 ms | 11 001 |
| Site public, selon le démarrage de la fonction | p75 | Part des appels |
|---|---|---|
| à chaud | 892 ms | 82,5 % |
| préchauffée | 1 918 ms | 3,8 % |
| à froid | 3 586 ms | 13,7 % |
| Site public, réponse du cache | Requêtes | Part |
|---|---|---|
| servie depuis le cache | 17 415 | 68,8 % |
| servie périmée, refaite après | 4 349 | 17,2 % |
| page prérendue | 1 567 | 6,2 % |
| absente du cache | 964 | 3,8 % |
| revalidée | 557 | 2,2 % |
| hors cache, ou non qualifiée | 468 | 1,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 cacheResultVercel 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.
apps/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.
apps/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
- 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. - 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"
doneUn 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
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 | État | Protocole |
|---|---|---|
| Couverture | mesurable, 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 suites | non mesurée | pnpm exec vitest run --reporter=json --outputFile=vitest.json : la durée de chaque test est dans le rapport |
| Instabilité | non mesurée | pnpm e2e --repeat-each=5 sur les tests touchés : un test qui échoue une fois sur cinq est instable |
| Tests e2e | lancés à la main, aucun résultat noté | pnpm e2e, depuis chaque application (Tests) |
| Évaluation de Fisher | lancé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.
| Application | Requêtes | Réponses 5xx | Part des 5xx | Réponses 429 (limitation de débit) |
|---|---|---|---|---|
| Site public | 25 320 | 17 | 0,067 % | aucune |
| ERP | 115 172 | 7 | 0,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
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 | État | Protocole |
|---|---|---|
| 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 webhooks | calculable, 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 restauration | une restauration jouée ne laisse pas de trace dans le dépôt | chronomé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établissement | aucun journal d’incidents | noter 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
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
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.