Cours Vibe coding avec Claude Code · Module 8: Clone de Slack
La table de navigation : un tableau de bord de l'équipage calculé à partir des messages
Dans cette leçon10
Le capitaine veut savoir si Ship's Comms est bien vivant : combien de messages circulent dans les canaux, qui écrit le plus et si cette semaine est plus calme que la précédente. Un chiffre sans source, c'est de la navigation dans le brouillard, et un graphique aux données écrites en dur est superbe et ment. Dans cette leçon, le tableau de bord calcule tout à partir des vrais messages, et les tests veillent à ce que les chiffres tombent juste.
Problème : trois pièges dans une simple addition
Le tableau de bord ressemble à un simple comptage, mais il cache trois endroits où l'erreur se glisse facilement. Le premier est le fuseau horaire, c'est-à-dire le décalage de l'horloge par rapport au temps universel UTC. Les messages ont une date ISO écrite en UTC, alors que l'équipage vit à Paris, une heure en avance sur l'UTC, et deux heures en été. Un message écrit une demi-heure après minuit appartient au nouveau jour, même si, en UTC, on est encore la veille. Le deuxième piège est la variation en pourcentage quand la semaine précédente était vide. Le troisième est l'accès : un invité ne doit pas pouvoir lire dans le tableau de bord ce qui se passe sur un canal privé, même sous forme de totaux.
Demande pour Claude Code :
/plan Ajoute une page /panel avec l'activité de l'équipage sur les
7 derniers jours : trois cartes (messages, membres actifs, réponses
dans les fils) avec la variation en pourcentage par rapport aux
7 jours précédents, un graphique en barres des messages par jour,
un classement des canaux et des trois membres les plus actifs.
Calcule tout à partir des messages avec des fonctions pures dans
lib/analytics.ts, d'abord les tests. Le jour se compte dans le
fuseau Europe/Paris. Seulement les canaux que le membre connecté
a le droit de voir. Graphique sans bibliothèque, avec une courte
description pour le lecteur d'écran et un tableau des données.
Ajoute aux données de test deux semaines de conversations.
Pour finir, tests, lint, types et build.La phrase sur la bibliothèque est voulue. Sept barres sont de simples éléments HTML dont la hauteur est en pourcentage : elles sont rendues sur le serveur avec le reste de la page et n'ajoutent pas à package.json une dépendance qu'il faudra ensuite tenir à jour. Ne songe à une bibliothèque de graphiques que pour des axes, du zoom ou des infobulles au survol, et demande alors à Claude de montrer d'abord dans la documentation qu'elle fonctionne avec ta version de React. Dans le plan, vérifie que le calcul va dans lib/analytics.ts et non dans les composants : seules des fonctions pures se testent sans navigateur.
Ce qu'a montré le premier passage
Claude a commencé par les tests dans lib/analytics.test.ts, puis il a écrit une première version des fonctions. Il prenait le jour du message dans createdAt.slice(0, 10), c'est-à-dire dans les dix premiers caractères de la date ISO. Quatre tests sur dix ont échoué, et le premier ressemblait à ceci :
FAIL lib/analytics.test.ts > dayKey > compte le jour dans le fuseau Europe/Paris, pas en UTC
AssertionError: expected '2026-11-13' to be '2026-11-14' // Object.is equality
Expected: "2026-11-14"
Received: "2026-11-13"Le test a fourni un message daté de 2026-11-13T23:30:00.000Z. À Paris, il est 00 h 30 le 14 novembre, mais slice a coupé la date en UTC et rangé le quart de nuit dans la veille. À l'écran, rien ne l'aurait trahi : les barres auraient eu l'air normales, avec un seul message tombé un jour trop tôt. Un deuxième test a attrapé la même chose en juillet, quand la différence est de deux heures. Les deux autres échecs viennent de la division par zéro, dont nous parlons dans un instant.
Ce que Claude a écrit : le jour dans le fuseau de Paris
Ouvre lib/analytics.ts dans Cursor. La fonction dayKey corrigée demande la date directement dans le fuseau de Paris :
export const TIME_ZONE = "Europe/Paris";
const dayParts = new Intl.DateTimeFormat("fr-FR", {
timeZone: TIME_ZONE,
year: "numeric",
month: "2-digit",
day: "2-digit",
});
export function dayKey(date: Date | string): string {
const parts = dayParts.formatToParts(new Date(date));
const part = (type: Intl.DateTimeFormatPartTypes) =>
parts.find((p) => p.type === type)?.value;
return `${part("year")}-${part("month")}-${part("day")}`;
}Intl.DateTimeFormat avec le champ timeZone convertit l'heure à l'horloge de Paris, heure d'été comprise, et formatToParts rend l'année, le mois et le jour séparément au lieu d'un texte tout fait avec des barres obliques (Intl.DateTimeFormatPartTypes est le type qui nomme ces parties). Le résultat est une clé du genre "2026-11-14", qu'on peut comparer et trier comme un simple texte. Les données ne changent pas : le message garde son heure en UTC, et le fuseau n'entre en jeu qu'au moment du calcul. Tu as vu le même principe dans la leçon 7_2, pour le formatage de l'heure.
La période et le comptage
À côté, deux petites fonctions. lastDays("2026-11-14", 7) renvoie sept clés de jours qui se terminent au jour donné, et inPeriod ne garde que les messages de ces jours. La page app/panel/page.tsx prend quatorze jours et les coupe en deux moitiés :
const days = lastDays(dayKey(new Date()), 14);
const week = inPeriod(messages, days.slice(7)); // les 7 derniers jours
const before = inPeriod(messages, days.slice(0, 7)); // les 7 jours d'avantIci, messages désigne les messages déjà filtrés par canSeeChannel, la même fonction qui gardait la barre latérale et la route du canal dans la leçon 7_1. L'invité marchand ne voit donc dans le tableau de bord que general et commerce, et l'activité de secrets-du-capitaine ne fuit pas, même sous forme de somme. Le classement des canaux et des membres naît de countBy(week, (m) => m.channelId), qui renvoie une table « identifiant, nombre ». Aucune de ces fonctions n'enregistre de compteurs à côté des données, donc, comme dans le journal de la leçon 7_2, rien ne peut se désynchroniser.
La variation en pourcentage sans division par zéro
La première version calculait la variation avec la formule du manuel. Pour une semaine précédente vide, elle renvoyait Infinity, et pour deux semaines vides NaN, de sorte que les cartes auraient affiché « hausse de Infinity % » et « baisse de NaN % ». Voici la correction :
export function percentChange(
current: number,
previous: number,
): number | null {
if (previous === 0) return null; // rien à comparer
return Math.round(((current - previous) / previous) * 100);
}null veut dire « pas de comparaison », et non zéro : passer de rien à cinq messages n'est pas une hausse d'un certain nombre de pour cent. La fonction formatChange traduit le résultat en mots : « hausse de 25 % », « baisse de 10 % », « sans changement » ou « pas de données à comparer ». La couleur, c'est seulement le composant qui la choisit.
Les cartes : des nombres, pas des textes
Ouvre components/StatsGrid.tsx. Une carte reçoit trois champs : label avec le nom, value avec le nombre des 7 derniers jours et previous avec le nombre de la semaine d'avant. Les valeurs sont des nombres, et non des textes tout faits comme "12.5K", car on ne peut plus rien calculer à partir d'un texte. Voici une carte :
<div className="rounded-lg border border-gray-200 bg-white p-4">
<dt className="text-sm text-gray-600">{stat.label}</dt>
<dd className="text-3xl font-bold">{stat.value}</dd>
<dd className={`text-sm ${tone[direction]}`}>{formatChange(change)}</dd>
</div>La grille de cartes est une liste de définitions <dl> : <dt> est le nom du nombre et <dd> sa valeur, donc « Messages » et « 19 » forment une paire aussi dans le code de la page, et pas seulement à l'œil. tone est un petit dictionnaire de classes : text-green-700 pour une hausse, text-red-700 pour une baisse, et du gris quand il n'y a ni changement ni comparaison. La couleur ne fait que souligner un sens que le mot donne déjà, comme le point de présence de la leçon 7_1 avait à côté un texte caché. La même carte montrera n'importe quel nombre : dans une boutique, ce seraient les vues, les clics et les conversions.
Un graphique en HTML et CSS
Ouvre components/ActivityChart.tsx. La hauteur d'une barre est calculée par une fonction pure, barPercent :
export function barPercent(count: number, max: number): number {
return max === 0 ? 0 : (count / max) * 100;
}La barre la plus haute reçoit 100 %, les autres proportionnellement moins. C'était le quatrième test rouge : dans une semaine sans message, max vaut 0 et 0 / 0 donne NaN. Le graphique lui-même est une rangée de colonnes, une par jour :
<div role="img" aria-label={summary} className="mt-4 flex gap-2">
{data.map((d) => (
<div key={d.day} className="flex flex-1 flex-col items-center">
<span className="text-xs font-semibold">{d.count}</span>
<div className="flex h-32 w-full items-end">
<div
className="w-full rounded-t bg-blue-600"
style={{ height: `${barPercent(d.count, max)}%` }}
/>
</div>
<span className="mt-1 text-xs text-gray-600">{formatDay(d.day)}</span>
</div>
))}
</div>La barre se tient dans sa propre boîte de hauteur fixe h-32, avec le nombre au-dessus et la date en dessous. Dans la première version, la barre partageait la colonne avec les étiquettes, et flexbox écrasait la plus haute pour que tout tienne : le sept est sorti à peine deux fois plus haut que le trois, alors qu'il devait l'être deux fois et un tiers. Aucun test ne l'attrape, c'est pourquoi il faut aussi regarder le tableau de bord. Le graphique n'a pas de "use client", car il ne réagit à aucun clic : le navigateur reçoit du HTML tout prêt.
Un graphique pour ceux qui ne le voient pas
Les barres sont une image, et une image se décrit. Le tutoriel du W3C sur les images complexes (https://www.w3.org/WAI/tutorials/images/complex/) dit qu'un graphique demande une description en deux parties : une courte, qui dit ce que montre l'image, et une plus longue avec les données principales. La courte est portée par role="img" avec aria-label, par exemple « Graphique en barres des messages par jour. Pic : 14 nov., 7. Chiffres exacts dans le tableau sous le graphique. ». role="img" demande au lecteur d'écran de traiter toute la boîte comme une seule image, donc il ne lira pas quatorze nombres isolés sans contexte. La partie longue, c'est un tableau dans un <details> avec le titre « Données du graphique en tableau » et les colonnes « Jour » et « Messages ». Il servira aussi à quiconque veut recopier les chiffres dans un rapport.
La revue du capitaine
- Le fuseau dans le test, pas seulement dans le code. Cherche dans le diff un test avec une heure juste après minuit à Paris. Erreur typique d'un agent :
slice(0, 10)ougetDate()sans fuseau, et un test à 12 h 00 qui passe dans tous les fuseaux et ne vérifie rien. - L'invité. Dans
lib/session.ts, remplace le membre connecté parmarchandet ouvre/panel. Chez nous, le classement n'a montré que#generalet#commerce, et la carte « Messages » est passée de 19 à 10. - La semaine vide. La carte « Réponses dans les fils » a affiché « pas de données à comparer », car dans les données de test la semaine précédente n'avait aucune réponse. C'est voulu, et non « Infinity % ».
- La preuve. Les tests (chez nous 33 au vert),
npm run lint,npx tsc --noEmitetnpm run build. Tous les nouveaux fichiers sont arrivés déjà formatés, car le hook de la leçon 7_1 travaille.
Étape suivante
Demande un commit, par exemple « Tableau de bord de l'équipage avec tests ». Puis une petite étape, avec le même rythme :
Ajoute le choix de la période dans l'adresse du tableau de bord :
?jours=7 ou ?jours=30, 7 par défaut. Toute autre valeur revient
à 7. D'abord les tests de la fonction qui lit le paramètre. Montre
le résultat des tests et le build.Dans l'éditeur ci-dessous t'attend le tableau de bord en miniature : fais passer le fuseau de Paris à UTC et regarde le quart de nuit sauter dans la veille, puis connecte-toi en invité.
Retiens : une table de navigation vaut ce que valent les mesures dont elle est née, et un test avec fuseau horaire vérifie que l'horloge du pont marche comme celle du port.
Code de cette leçon : App.jsx
// Tableau de bord de l’équipage en miniature : le jour dans un fuseau horaire, des cartes avec variation et un graphique en HTML.
// Dans le projet, les fonctions vivent dans lib/analytics.ts (avec des tests), et la page /panel les calcule sur le serveur.
import { useState } from 'react';
const REPORT_DAY = '2026-11-14'; // jour du rapport écrit en dur pour que l’exemple ne bouge pas
const members = [
{ id: 'u1', name: 'Capitaine Barbe-Rousse', role: 'owner' },
{ id: 'u2', name: 'Anne Bonny', role: 'admin' },
{ id: 'u3', name: 'Étienne Sternik', role: 'member' },
{ id: 'u4', name: 'Jack Rackham', role: 'member' },
{ id: 'u5', name: 'Marchand de la Tortue', role: 'guest' },
];
const channels = [
{ id: 'c1', name: 'general', isPrivate: false, memberIds: ['u1', 'u2', 'u3', 'u4', 'u5'] },
{ id: 'c2', name: 'treasure-hunts', isPrivate: false, memberIds: ['u1', 'u2', 'u3', 'u4'] },
{ id: 'c4', name: 'commerce', isPrivate: false, memberIds: ['u1', 'u2', 'u5'] },
{ id: 'c5', name: 'secrets-du-capitaine', isPrivate: true, memberIds: ['u1', 'u2'] },
];
// [canal, auteur, heure en UTC]
const rows = [
['c1', 'u1', '2026-11-14T09:00:00.000Z'],
['c1', 'u2', '2026-11-14T09:05:00.000Z'],
['c2', 'u2', '2026-11-14T10:15:00.000Z'],
['c5', 'u1', '2026-11-14T12:05:00.000Z'],
['c1', 'u3', '2026-11-13T23:30:00.000Z'], // quart de nuit : 00 h 30 à Paris
['c4', 'u5', '2026-11-13T09:20:00.000Z'],
['c4', 'u2', '2026-11-13T09:45:00.000Z'],
['c1', 'u1', '2026-11-12T08:30:00.000Z'],
['c2', 'u4', '2026-11-12T16:45:00.000Z'],
['c1', 'u2', '2026-11-11T07:55:00.000Z'],
['c2', 'u1', '2026-11-11T13:30:00.000Z'],
['c1', 'u4', '2026-11-10T18:20:00.000Z'],
['c1', 'u1', '2026-11-08T10:30:00.000Z'],
['c1', 'u1', '2026-11-06T09:15:00.000Z'],
['c2', 'u2', '2026-11-06T12:40:00.000Z'],
['c1', 'u2', '2026-11-04T08:10:00.000Z'],
['c5', 'u2', '2026-11-03T17:25:00.000Z'],
];
const messages = rows.map(([channelId, authorId, createdAt], i) => ({ id: 'm' + i, channelId, authorId, createdAt }));
function canSeeChannel(channel, member) {
if (channel.isPrivate || member.role === 'guest') return channel.memberIds.includes(member.id);
return true;
}
function dayKey(iso, timeZone) {
const parts = new Intl.DateTimeFormat('fr-FR', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).formatToParts(new Date(iso));
const part = (type) => parts.find((p) => p.type === type).value;
return part('year') + '-' + part('month') + '-' + part('day');
}
function lastDays(endDay, count) {
const end = Date.parse(endDay + 'T00:00:00.000Z');
return Array.from({ length: count }, (_, i) => new Date(end - (count - 1 - i) * 86400000).toISOString().slice(0, 10));
}
function percentChange(current, previous) {
if (previous === 0) return null;
return Math.round(((current - previous) / previous) * 100);
}
function formatChange(change) {
if (change === null) return 'pas de données à comparer';
if (change === 0) return 'sans changement';
return change > 0 ? 'hausse de ' + change + ' %' : 'baisse de ' + -change + ' %';
}
function barPercent(count, max) {
return max === 0 ? 0 : (count / max) * 100;
}
function formatDay(day) {
return new Intl.DateTimeFormat('fr-FR', { day: 'numeric', month: 'short', timeZone: 'UTC' }).format(new Date(day + 'T00:00:00.000Z'));
}
const tone = { up: 'text-green-700', down: 'text-red-700', none: 'text-gray-600' };
export default function App() {
const [timeZone, setTimeZone] = useState('Europe/Paris');
const [meId, setMeId] = useState('u1');
const me = members.find((m) => m.id === meId);
const visible = channels.filter((c) => canSeeChannel(c, me));
const mine = messages.filter((m) => visible.some((c) => c.id === m.channelId));
const days = lastDays(REPORT_DAY, 14);
const inPeriod = (period) => mine.filter((m) => period.includes(dayKey(m.createdAt, timeZone)));
const week = inPeriod(days.slice(7));
const before = inPeriod(days.slice(0, 7));
const authors = (list) => new Set(list.map((m) => m.authorId)).size;
const stats = [
{ label: 'Messages', value: week.length, previous: before.length },
{ label: 'Membres actifs', value: authors(week), previous: authors(before) },
];
const data = days.slice(7).map((day) => ({ day, count: week.filter((m) => dayKey(m.createdAt, timeZone) === day).length }));
const max = Math.max(0, ...data.map((d) => d.count));
const peak = data.find((d) => d.count === max);
const summary = max === 0
? 'Graphique en barres : aucun message sur cette période.'
: 'Graphique en barres des messages par jour. Pic : ' + formatDay(peak.day) + ', ' + max + '. Chiffres exacts dans le tableau sous le graphique.';
const watch = messages.find((m) => m.createdAt === '2026-11-13T23:30:00.000Z');
return (
<div className="min-h-screen bg-gray-50 p-4 text-gray-900">
<div className="mb-4 flex flex-wrap items-center gap-3 text-sm">
<label htmlFor="tz">Fuseau de comptage des jours :</label>
<select id="tz" value={timeZone} onChange={(e) => setTimeZone(e.target.value)} className="rounded-md border border-gray-300 bg-white px-2 py-1">
<option value="Europe/Paris">Europe/Paris (correct)</option>
<option value="UTC">UTC (comme createdAt.slice(0, 10))</option>
</select>
<label htmlFor="me">Connecté :</label>
<select id="me" value={meId} onChange={(e) => setMeId(e.target.value)} className="rounded-md border border-gray-300 bg-white px-2 py-1">
<option value="u1">Capitaine Barbe-Rousse (owner)</option>
<option value="u5">Marchand de la Tortue (guest)</option>
</select>
</div>
<p className="mb-4 text-sm text-gray-700">
Le quart de nuit (23 h 30 UTC, 13 novembre) est compté pour le jour : <strong>{formatDay(dayKey(watch.createdAt, timeZone))}</strong>
</p>
<dl className="mb-4 grid gap-3 sm:grid-cols-2">
{stats.map((stat) => {
const change = percentChange(stat.value, stat.previous);
const direction = change === null || change === 0 ? 'none' : change > 0 ? 'up' : 'down';
return (
<div key={stat.label} className="rounded-lg border border-gray-200 bg-white p-4">
<dt className="text-sm text-gray-600">{stat.label}</dt>
<dd className="text-3xl font-bold">{stat.value}</dd>
<dd className={'text-sm ' + tone[direction]}>{formatChange(change)}</dd>
</div>
);
})}
</dl>
<figure className="rounded-lg border border-gray-200 bg-white p-4">
<figcaption className="font-semibold">Messages par jour, du 8 au 14 novembre</figcaption>
<div role="img" aria-label={summary} className="mt-4 flex gap-2">
{data.map((d) => (
<div key={d.day} className="flex flex-1 flex-col items-center">
<span className="text-xs font-semibold">{d.count}</span>
<div className="flex h-32 w-full items-end">
<div className="w-full rounded-t bg-blue-600" style={{ height: barPercent(d.count, max) + '%' }} />
</div>
<span className="mt-1 text-xs text-gray-600">{formatDay(d.day)}</span>
</div>
))}
</div>
<details className="mt-3 text-sm">
<summary className="cursor-pointer text-blue-700">Données du graphique en tableau</summary>
<table className="mt-2 w-full text-left">
<thead>
<tr className="border-b border-gray-200">
<th scope="col" className="py-1">Jour</th>
<th scope="col" className="py-1">Messages</th>
</tr>
</thead>
<tbody>
{data.map((d) => (
<tr key={d.day} className="border-b border-gray-100">
<td className="py-1">{formatDay(d.day)}</td>
<td className="py-1">{d.count}</td>
</tr>
))}
</tbody>
</table>
</details>
</figure>
<p className="mt-3 text-xs text-gray-600">Canaux dans le tableau de bord : {visible.map((c) => '#' + c.name).join(', ')}</p>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Un message a createdAt "2026-11-13T23:30:00.000Z". À quel jour le tableau de bord de Ship's Comms doit-il le rattacher ?
2. Que renvoie percentChange(5, 0) quand il n'y avait aucun message la semaine précédente ?
Voici 2 des 3 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Éditeur de code
Tableau de bord analytique avec cartes et graphique
- Tri horizontal
Ordonne sur une seule ligne l'expression de barPercent qui donne 0 quand il n'y a eu aucun message sur toute la période :