Cours Vibe coding avec Claude Code · Module 9: Clone de Discord
Serveurs et canaux : la carte de la guilde issue du mode plan
Dans cette leçon11
Ohé ! La guilde Black Pearl a grandi jusqu'à cent pirates, et toute la conversation se déroule dans un seul chat. Les annonces du capitaine se perdent entre les blagues, les plans d'expédition se mélangent au troc, et le nouveau mousse ne sait pas qui commande ici. Dans cette location, tu construis Pirate's Cove, le serveur communautaire de l'équipage façon Discord : des canaux séparés pour des sujets séparés, des rôles et une liste de membres qui montre d'un coup d'œil qui est à bord.
Ce que tu vas apprendre
- planifier avec Claude Code le modèle de données du serveur avant qu'un seul composant n'existe ;
- lire les types un par un dans Cursor et vérifier que le plan tient la route ;
- confier la barre des canaux, la liste des serveurs et la liste des membres à trois demandes distinctes ;
- repérer dans le diff un tri qui abîme les données en silence et noter la règle dans
CLAUDE.md.
Discord et Slack
Dans Ship's Comms, le clone de Slack, tu construisais l'espace de travail d'un seul équipage, où l'on échange surtout par écrit. Discord est né pour les communautés et les joueurs : au lieu d'un espace de travail, il a des serveurs ; à côté des canaux textuels se tiennent des canaux vocaux toujours ouverts, et les rôles décident qui peut quoi. Pirate's Cove suit la voie de Discord.
Nouveau port : le projet pirates-cove
Pirate's Cove est une application à part : tu la crées donc avec la commande de la leçon 1_2, en changeant seulement le nom. Avant de cliquer sur Yes, compare la commande avec celle-ci :
npx create-next-app@latest pirates-cove --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npmEnsuite, la boucle habituelle : une session dans le dossier pirates-cove, un CLAUDE.md qui importe @AGENTS.md, Vitest avec le correctif @types/node de la leçon 4_1 et un premier commit. Rien de tout cela n'est nouveau, il n'y a donc rien à deviner.
Problème : un seul chat pour cent pirates
Un serveur est une carte. En haut se trouve la guilde, dedans les catégories, c'est-à-dire des groupes de canaux, et dans les catégories les canaux : textuels pour écrire, vocaux pour parler, et un canal d'annonces où seul le commandement écrit. À côté de la carte viennent les rôles et les membres. Si ce modèle est mauvais, chaque composant bâti dessus héritera de l'erreur : tu commences donc par un plan. Tu connais le mode plan depuis la leçon 2_1 : /plan avant la demande pousse Claude à étudier le projet et à dresser un plan, mais sans toucher à aucun fichier.
Demande pour Claude Code :
/plan Nous construisons Pirate's Cove, un clone de Discord. Planifie le
modèle de données dans types/server.ts : un serveur avec un propriétaire,
des catégories et des canaux (textuels, vocaux, d'annonces) avec un champ
position, des rôles avec une couleur, une position, un drapeau isHoisted
et un champ permissions sous forme de nombre, des membres avec un statut
online, idle, dnd ou offline. Données de test dans lib/server-data.ts :
la guilde Black Pearl et deux serveurs plus petits. Le membre connecté
vient d'une seule fonction dans lib/session.ts. N'écris pas encore de
composants. Montre les types, les fichiers et l'ordre des étapes. Pose
des questions s'il manque quelque chose.Dans le plan, vérifie deux choses. D'abord les catégories : dans l'API de Discord, une catégorie est aussi un canal, de type GUILD_CATEGORY, qui peut contenir jusqu'à 50 canaux, et un canal désigne sa catégorie par le champ parent_id. Dans le clone, une écriture plus simple suffit : un type de catégorie à part et un champ categoryId dans le canal. Ensuite les permissions : pour l'instant, c'est un seul nombre dans le rôle, et dans la leçon 8_3 tu le décomposeras en bits. Quand le plan passe la revue, choisis Yes, manually approve edits pour valider chaque modification.
Ce que Claude a écrit : le modèle de données
Ouvre types/server.ts dans Cursor et lis type après type. En haut se trouvent des unions, c'est-à-dire des listes fermées de valeurs, et dessous le canal :
export type ChannelType = "text" | "voice" | "announcement";
export type Status = "online" | "idle" | "dnd" | "offline";
export interface Channel {
id: string;
name: string; // "general", "conseil-de-guerre"
type: ChannelType;
categoryId: string | null;
position: number;
userLimit?: number; // uniquement les canaux vocaux
}Une coquille comme "vocie" ne passe pas le compilateur, et categoryId: null désigne un canal sans catégorie, tout en haut de la barre. userLimit porte un point d'interrogation, donc il est optionnel : une limite de personnes n'a de sens que dans un canal vocal. Les statuts viennent de la documentation de Discord : online, idle (je reviens vite), dnd (ne pas déranger) et offline. Un cinquième, invisible, apparaît aux autres comme offline : le clone l'ignore.
Le rôle dit à quoi quelqu'un ressemble dans la liste et ce qu'il a le droit de faire :
export interface Role {
id: string;
name: string;
color: string; // "#e11d48"
position: number; // nombre plus grand = rôle plus élevé
isHoisted: boolean; // groupe séparé dans la liste des membres
permissions: number; // bits de permissions, détails dans la leçon 8_3
}position fixe la hiérarchie : le Capitaine en position 3 est au-dessus de l'Officier en position 2. isHoisted sort les membres de ce rôle dans un groupe à part de la liste, au lieu de les mêler au reste. Le champ permissions n'est pour l'instant qu'un simple nombre, et rien dans cette leçon ne le lit.
À la fin du fichier se trouvent Member et Server. Le membre a un username, un nom unique comme anne, et un displayName pour l'affichage. Il n'y a pas de tag à quatre chiffres du type #1234 : en 2023, Discord a commencé à supprimer ces tags au profit de noms uniques, et un compte migré vers le nouveau système a simplement "0" dans le champ discriminator. Le serveur rassemble tout dans un seul objet et possède un ownerId, car le propriétaire aura des droits spéciaux dans la leçon 8_3.
La barre des canaux : une demande à part
Tu confies chaque composant séparément : un petit diff se lit vite, et une erreur s'y voit tout de suite.
Demande pour Claude Code :
Fais components/ServerSidebar.tsx pour les types de @types/server.ts :
le nom du serveur, les catégories triées par position et repliables d'un
clic, dans chacune les canaux triés par position avec une icône selon le
type, le canal actif mis en évidence, et en bas le panneau du membre
connecté. Affiche la barre sur la page
app/servers/[serverId]/[channelId]/page.tsx. Pour finir, lint, types et build.Ce que Claude a écrit : le tri
Ouvre components/ServerSidebar.tsx. D'abord l'ordre des catégories et des canaux :
const categories = [...server.categories].sort((a, b) => a.position - b.position);
function channelsOf(categoryId: string) {
return server.channels
.filter((c) => c.categoryId === categoryId)
.sort((a, b) => a.position - b.position);
}[...server.categories] fait une copie superficielle du tableau et ne trie que cette copie. Dans channelsOf, il n'y a pas de copie, et c'est normal : filter renvoie toujours un nouveau tableau, donc sort range un tableau que ce même code vient de créer. Les navigateurs récents ont aussi toSorted, qui renvoie directement une copie triée.
Ce que Claude a écrit : les catégories repliables
Le fichier commence par "use client", car la barre réagit aux clics et garde un état, ce qu'un Server Component ne sait pas faire. Les catégories repliées vivent dans l'état sous forme d'ensemble d'identifiants :
const [collapsed, setCollapsed] = useState<Set<string>>(() => new Set());
function toggle(categoryId: string) {
setCollapsed((prev) => {
const next = new Set(prev);
if (next.has(categoryId)) next.delete(categoryId);
else next.add(categoryId);
return next;
});
}toggle ne modifie pas l'ancien ensemble : elle en construit un nouveau et le remet à React, qui redessine alors le composant. Le bouton de la catégorie porte aria-expanded={!isCollapsed}, qui indique au lecteur d'écran si la liste est dépliée, et la liste des canaux ne s'affiche que si la catégorie n'est pas dans l'ensemble. L'icône du type de canal (#, une note ou un point d'exclamation) est accompagnée d'un texte masqué, par exemple "canal vocal", et le panneau du bas montre un point de statut avec la même description cachée.
La liste des serveurs et la liste des membres
Deux demandes suivantes dans le même style ont donné components/ServerList.tsx et components/MemberList.tsx. La liste des serveurs n'a pas de "use client" : pas d'état, pas d'événements, et le serveur actif arrive de l'adresse par les props. Chaque icône est un Link avec les initiales de la guilde, un title avec le nom complet et une barre à gauche pour le serveur actif.
La liste des membres regroupe l'équipage avec la fonction groupMembers de lib/members.ts. Tout part du rôle le plus élevé du membre :
export function getHighestRole(member: Member, roles: Role[]): Role | null {
const own = roles.filter((role) => member.roleIds.includes(role.id));
own.sort((a, b) => b.position - a.position);
return own[0] ?? null;
}La fonction prend les rôles du membre, les range par position décroissante et renvoie le premier, ou null. groupMembers place chaque membre qui n'est pas offline dans le groupe de son rôle le plus élevé marqué isHoisted, les autres dans le groupe "En ligne", et tous ceux dont le statut est offline à la fin, dans "Hors ligne". Chez nous, la liste a montré dans l'ordre : CAPITAINE - 1, OFFICIER - 1, EN LIGNE - 2 et HORS LIGNE - 1.
La revue du capitaine
- Une copie avant le tri. L'erreur typique d'un agent est
server.categories.sort(...)sans[...]. MDN le dit clairement :sort()range le tableau sur place et renvoie le même tableau, et la documentation de React précise que les props sont immuables et qu'il ne faut jamais les modifier. Dans le diff, cherche donc chaque.sort(et.reverse(appliqué à des données venues des props. Chez nous, cette version est passée parnpm run lintetnpx tsc --noEmitsans un mot : demande donc aussi un test qui note l'ordre des catégories, dessine la barre et compare les données (résultat sous la liste). - Des unions plutôt que des chaînes.
typeetstatusdoivent être des unions, pas desstring. - position pilote vraiment. Dans les données de test, la catégorie vocale est placée avant la catégorie textuelle alors que
positiondit l'inverse. Sur la page, CANAUX TEXTUELS doit venir en premier, et chez nous c'était le cas. - La preuve. Les tests,
npm run lint,npx tsc --noEmitetnpm run build. Avant le premier build,tscne connaît pasPageProps<"/servers/[serverId]/[channelId]">; les types des routes sont générés parnpx next typegen.
Le résultat du test avec la version sans copie, c'est-à-dire avec server.categories.sort(...), ressemblait à ceci chez nous :
FAIL components/ServerSidebar.test.tsx > ne modifie pas l'ordre des catégories dans les données du serveur
AssertionError: expected [ 'textuels', 'vocaux' ] to deeply equal [ 'vocaux', 'textuels' ]Avec la copie, le test passe ; sans elle, il échoue. Les données du serveur ont changé du seul fait d'être affichées, et dans un Server Component ce changement atterrirait dans des données partagées par toutes les requêtes.
Étape suivante : la règle dans CLAUDE.md
Cette erreur revient, car sort a l'air innocent. Demande à Claude une seule ligne dans CLAUDE.md :
- Les données des props et de lib/ sont en lecture seule : trie une copie ([...liste].sort), jamais la liste sur place.Selon la documentation de Claude Code, CLAUDE.md est chargé au début de chaque session, mais Claude le traite comme une indication et non comme une règle stricte, et plus la ligne est concrète, plus il l'écoute. C'est pourquoi tu gardes aussi le test : la ligne prévient l'erreur, le test l'attrape. Demande ensuite un commit, par exemple "Modèle du serveur, barre des canaux, listes des serveurs et des membres".
Dans l'éditeur ci-dessous t'attend la guilde en miniature : replie les catégories, change de serveur et active le bug de l'agent pour voir comment l'ordre des données change du seul fait du dessin.
Retiens : le capitaine dessine la carte avant que l'équipage ne creuse, et une bonne carte ne change pas parce que quelqu'un l'a regardée.
Code de cette leçon : App.jsx
// Pirate's Cove en miniature : serveurs, catégories repliables et liste des membres.
// Dans le projet, les données sont dans lib/server-data.ts et les composants dans components/.
// L'interrupteur "bug de l'agent" trie les catégories sur place, comme server.categories.sort(...).
import { useState } from 'react';
const servers = [
{
id: 'black-pearl',
name: 'Guilde Black Pearl',
categories: [
{ id: 'vocaux', name: 'CANAUX VOCAUX', position: 1 },
{ id: 'textuels', name: 'CANAUX TEXTUELS', position: 0 },
],
channels: [
{ id: 'treasure-hunts', name: 'treasure-hunts', type: 'text', categoryId: 'textuels', position: 2 },
{ id: 'general', name: 'general', type: 'text', categoryId: 'textuels', position: 1 },
{ id: 'annonces', name: 'annonces', type: 'announcement', categoryId: 'textuels', position: 0 },
{ id: 'conseil-de-guerre', name: 'conseil-de-guerre', type: 'voice', categoryId: 'vocaux', position: 0 },
{ id: 'mesa', name: 'mesa', type: 'voice', categoryId: 'vocaux', position: 1 },
],
roles: [
{ id: 'equipage', name: 'Équipage', color: '#64748b', position: 1, isHoisted: false },
{ id: 'capitaine', name: 'Capitaine', color: '#e11d48', position: 3, isHoisted: true },
{ id: 'officier', name: 'Officier', color: '#2563eb', position: 2, isHoisted: true },
],
members: [
{ id: 'redbeard', displayName: 'Capitaine Barbe-Rousse', roleIds: ['capitaine', 'equipage'], status: 'online' },
{ id: 'anne', displayName: 'Anne Bonny', roleIds: ['officier', 'equipage'], status: 'online' },
{ id: 'jack', displayName: 'Jack Rackham', roleIds: ['equipage'], status: 'idle' },
{ id: 'mary', displayName: 'Mary Read', roleIds: ['officier', 'equipage'], status: 'offline' },
{ id: 'blackbeard', displayName: 'Blackbeard', roleIds: ['equipage'], status: 'dnd' },
],
},
{
id: 'tortuga',
name: 'Marché de la Tortue',
categories: [{ id: 'commerce', name: 'COMMERCE', position: 0 }],
channels: [{ id: 'prix', name: 'prix', type: 'text', categoryId: 'commerce', position: 0 }],
roles: [],
members: [],
},
{
id: 'kraken',
name: 'Chasseurs de Kraken',
categories: [],
channels: [{ id: 'pistes', name: 'pistes', type: 'text', categoryId: null, position: 0 }],
roles: [],
members: [],
},
];
const icons = { text: '#', voice: '♪', announcement: '!' };
const typeLabels = { text: 'canal textuel', voice: 'canal vocal', announcement: "canal d'annonces" };
const dotColors = { online: 'bg-green-500', idle: 'bg-yellow-400', dnd: 'bg-red-500', offline: 'bg-gray-500' };
const statusLabels = { online: 'en ligne', idle: 'de retour bientôt', dnd: 'ne pas déranger', offline: 'hors ligne' };
function getHighestRole(member, roles) {
const own = roles.filter((role) => member.roleIds.includes(role.id));
own.sort((a, b) => b.position - a.position);
return own[0] || null;
}
function groupMembers(members, roles) {
const hoisted = roles.filter((role) => role.isHoisted);
const byRole = [...hoisted]
.sort((a, b) => b.position - a.position)
.map((role) => ({ id: role.id, label: role.name, members: [] }));
const online = { id: 'online', label: 'En ligne', members: [] };
const offline = { id: 'offline', label: 'Hors ligne', members: [] };
for (const member of members) {
const top = getHighestRole(member, hoisted);
const group = member.status === 'offline' ? offline : byRole.find((g) => top && g.id === top.id) || online;
group.members.push(member);
}
return [...byRole, online, offline].filter((g) => g.members.length > 0);
}
function initials(name) {
return name.split(' ').map((word) => word[0]).join('').slice(0, 2).toUpperCase();
}
function StatusDot({ status }) {
return (
<>
<span aria-hidden="true" className={'inline-block h-2.5 w-2.5 shrink-0 rounded-full ' + dotColors[status]} />
<span className="sr-only">({statusLabels[status]})</span>
</>
);
}
export default function App() {
const [serverId, setServerId] = useState('black-pearl');
const [channelId, setChannelId] = useState('general');
const [collapsed, setCollapsed] = useState(() => new Set());
const [buggy, setBuggy] = useState(false);
const server = servers.find((s) => s.id === serverId);
const dataBefore = server.categories.map((c) => c.id).join(', ');
const categories = buggy
? server.categories.sort((a, b) => a.position - b.position) // bug : trie les données sur place
: [...server.categories].sort((a, b) => a.position - b.position);
const dataAfter = server.categories.map((c) => c.id).join(', ');
function toggle(id) {
setCollapsed((prev) => {
const next = new Set(prev);
if (next.has(id)) next.delete(id);
else next.add(id);
return next;
});
}
function resetData() {
servers[0].categories = [
{ id: 'vocaux', name: 'CANAUX VOCAUX', position: 1 },
{ id: 'textuels', name: 'CANAUX TEXTUELS', position: 0 },
];
setBuggy(false);
}
function renderChannel(channel) {
const active = channel.id === channelId;
return (
<li key={channel.id}>
<button
onClick={() => setChannelId(channel.id)}
aria-current={active ? 'page' : undefined}
className={'flex w-full items-center gap-2 rounded px-2 py-1 text-left text-sm ' + (active ? 'bg-gray-700 text-white' : 'text-gray-300 hover:bg-gray-700')}
>
<span aria-hidden="true" className="w-4 text-center text-gray-400">{icons[channel.type]}</span>
<span className="sr-only">{typeLabels[channel.type]}</span>
{channel.name}
</button>
</li>
);
}
const loose = server.channels.filter((c) => c.categoryId === null);
return (
<div className="min-h-screen bg-gray-700 text-gray-100">
<div className="flex flex-wrap items-center gap-3 bg-gray-900 p-2 text-xs">
<label className="flex items-center gap-1">
<input type="checkbox" checked={buggy} onChange={(e) => setBuggy(e.target.checked)} />
Bug de l'agent : server.categories.sort(...) sans copie
</label>
<span>Données avant l'affichage : {dataBefore}</span>
<span>après l'affichage : {dataAfter}</span>
<button onClick={resetData} className="rounded bg-gray-700 px-2 py-1">Réinitialiser les données</button>
</div>
<div className="flex h-[520px]">
<nav aria-label="Serveurs" className="flex w-16 flex-col items-center gap-2 bg-gray-950 py-3">
{servers.map((s) => (
<button
key={s.id}
title={s.name}
aria-label={s.name}
aria-current={s.id === serverId ? 'page' : undefined}
onClick={() => {
setServerId(s.id);
setChannelId(s.channels[0].id);
}}
className={'flex h-11 w-11 items-center justify-center font-bold ' + (s.id === serverId ? 'rounded-2xl bg-indigo-500' : 'rounded-full bg-gray-700 hover:rounded-2xl')}
>
{initials(s.name)}
</button>
))}
</nav>
<nav aria-label="Canaux du serveur" className="flex w-56 flex-col bg-gray-800">
<h2 className="border-b border-gray-900 px-3 py-2 font-bold">{server.name}</h2>
<div className="flex-1 overflow-y-auto p-2">
<ul>{loose.map(renderChannel)}</ul>
{categories.map((category) => {
const isCollapsed = collapsed.has(category.id);
const channels = server.channels
.filter((c) => c.categoryId === category.id)
.sort((a, b) => a.position - b.position);
return (
<section key={category.id} className="mt-2">
<button
onClick={() => toggle(category.id)}
aria-expanded={!isCollapsed}
className="flex w-full items-center gap-1 text-xs font-semibold text-gray-400 hover:text-gray-200"
>
<span aria-hidden="true">{isCollapsed ? '▸' : '▾'}</span>
{category.name}
</button>
{!isCollapsed && <ul className="mt-1">{channels.map(renderChannel)}</ul>}
</section>
);
})}
</div>
</nav>
<main className="flex-1 p-4 text-sm text-gray-300">
Canal : <strong>{channelId}</strong>. Replie une catégorie, change de serveur, puis active le bug de l'agent et change plusieurs fois de canal.
</main>
<aside aria-label="Membres" className="w-48 overflow-y-auto bg-gray-800 p-3">
{groupMembers(server.members, server.roles).map((group) => (
<section key={group.id} className="mb-3">
<h3 className="text-xs font-semibold uppercase text-gray-400">{group.label} - {group.members.length}</h3>
<ul>
{group.members.map((member) => {
const role = getHighestRole(member, server.roles);
return (
<li key={member.id} className={'flex items-center gap-2 text-sm ' + (member.status === 'offline' ? 'opacity-50' : '')}>
<StatusDot status={member.status} />
<span style={{ color: role ? role.color : undefined }}>{member.displayName}</span>
</li>
);
})}
</ul>
</section>
))}
{server.members.length === 0 && <p className="text-xs text-gray-400">Ce serveur n'a pas encore d'équipage.</p>}
</aside>
</div>
</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. Que contient l'objet Server dans le modèle de données de Pirate's Cove ?
2. Comment le type de canal est-il écrit dans types/server.ts ?
Voici 2 des 7 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri vertical
Ordonne les étapes de travail sur le modèle de données de Pirate's Cove dans l'ordre de la leçon :
- Éditeur de code
Navigation d'un serveur Discord
- Clique dans l'ordre
Clique pour construire le tri des catégories sans modifier les données des props : [...server.categories].sort((a, b) => a.position - b.position)
- Éditeur de code
Barre latérale de changement de serveur
- Tri horizontal
Ordonne la ligne qui garde les catégories repliées dans l'état : const [collapsed, setCollapsed] = useState<Set<string>>(() => new Set());
- Tri vertical
Ordonne les groupes de la liste des membres (MemberList) de haut en bas, quand les rôles Capitaine (position 3) et Officier (position 2) ont isHoisted: true :
- Tri horizontal
Ordonne la dernière ligne de la fonction getHighestRole : return own[0] ?? null;
- Clique dans l'ordre
Clique pour construire l'attribut du bouton de catégorie qui indique au lecteur d'écran si la liste est dépliée :
Exercices après cette leçon
- QuestionQuiz : Contenu d'un serveur
- QuestionQuiz : Type de canal
- QuestionQuiz : Statut d'un membre
- Remets dans l'ordreOrdre : étapes de travail sur le modèle
- Exercice de codePratique : Barre latérale du serveur
- QuestionQuiz : Canal et catégorie
- QuestionQuiz : Champ isHoisted dans Role
- Clique dans l'ordreOrdre : tri sur une copie
- QuestionQuiz : Tri des données des props
- Exercice de codePratique : Liste des serveurs
- Remets dans l'ordreOrdre : état des catégories repliées
- QuestionQuiz : getHighestRole
- Remets dans l'ordreOrdre : groupes de la liste des membres
- Remets dans l'ordreOrdre : retour du rôle le plus élevé
- Clique dans l'ordreOrdre : attribut aria-expanded