Cours Vibe coding avec Claude Code · Module 5: Clone de Reddit

Le registre des guildes : des communautés et un filtre dans l'adresse

10 min de lecture ·
Dans cette leçon10

Crew Council grandit et sur une seule liste se mélangent des cartes au trésor, des conseils pour réparer une coque et des récits de batailles. Celui qui ne cherche que des cartes doit fouiller tout le fleuve de posts. Reddit divise les contenus en communautés, les subreddits, et nous les appellerons des guildes : chacune a un thème, une description, des règles et ses membres. Dans cette leçon, Claude Code planifie d'abord la division, et toi tu vérifies dans le plan et dans le navigateur que la guilde est un filtre, et non un second livre de bord.

Problème : un seul livre, plusieurs fenêtres

La décision la plus importante tombe avant le code. Une guilde n'a pas sa propre liste de posts. Chaque post a un champ community avec l'id de la guilde, et la vue d'une guilde est la même liste regardée à travers un filtre. Si les guildes avaient des copies séparées, un nouveau post irait dans l'une d'elles, et un vote donné sur une copie n'existerait pas dans l'autre.

Seconde décision : où garder la guilde choisie. Elle pourrait vivre dans useState, mais elle disparaîtrait au rechargement et on ne pourrait pas envoyer le lien d'une guilde à un compagnon. Elle ira donc dans l'adresse, comme paramètre de recherche, que tu connais depuis la leçon 3_5 : /?community=sea-battles. Le lien peut être envoyé, le rechargement retient le choix, et le bouton Retour revient à la guilde précédente.

Demande pour Claude Code : d'abord un plan

Le changement touche plusieurs fichiers et laisse des choix ouverts, tu commences donc par le mode plan de la leçon 0_4 :

Demande pour Claude Code :

/plan Divise les posts de Crew Council en communautés. Dans
lib/communities.ts, le type Community (id, name, displayName,
description, members, rules) et quatre guildes : treasure-hunting,
sea-battles, pirate-life, ship-building. La guilde choisie vit dans
l'adresse comme ?community=, et @app/page.tsx la lit depuis
searchParams ; un id inconnu donne un 404. Une barre latérale avec des
liens : Toutes et les quatre guildes avec le nombre de membres abrégé
(12.5K). Au-dessus des posts, un en-tête de guilde avec la description,
les règles et un bouton Rejoindre. Un formulaire de nouveau post avec
le choix de la guilde, un titre jusqu'à 300 caractères et le contenu.
Ne garde pas la liste filtrée dans un état séparé, calcule-la à partir
des posts. Termine chaque étape par les tests, le lint et le build.

Dans le plan, tu cherches trois choses. La liste filtrée est-elle calculée, et non gardée dans un second useState ? L'état des posts reste-t-il dans Feed de la leçon 4_1, sans partir dans un nouveau composant ? N'y a-t-il aucun nouveau paquet ? Un plan qui passe, tu l'acceptes par Yes, manually approve edits et tu lis chaque modification.

Ce que Claude a écrit : les données des guildes

Ouvre lib/communities.ts. Le type Community décrit une guilde :

export interface Community {
  id: string;
  name: string;
  displayName: string;
  description: string;
  members: number;
  rules: string[];
}

Chaque champ a son destinataire. id, par exemple treasure-hunting, est lu par le programme : il se trouve dans l'adresse et dans le champ community du post. name est le nom avec préfixe, r/TreasureHunting, et displayName est le titre lisible de l'en-tête. members est le nombre de membres, et rules un tableau des règles de la guilde. Le nombre de membres est affiché de façon abrégée par une fonction du même fichier :

export function formatMembers(count: number): string {
  if (count >= 1000000) return (count / 1000000).toFixed(1) + "M";
  if (count >= 1000) return (count / 1000).toFixed(1) + "K";
  return String(count);
}

À partir de mille, elle divise par 1000, toFixed(1) garde un chiffre après le point et ajoute K : 12460 membres de r/TreasureHunting font donc 12.5K, et 25670 membres de r/PirateLife font 25.7K. À partir d'un million, c'est pareil avec la lettre M. Les petits nombres reviennent sans changement.

Ce que Claude a écrit : l'adresse comme source de vérité

Ouvre app/page.tsx. La page lit la guilde dans l'adresse comme le moteur de recherche de la leçon 3_5 :

export default async function Home({ searchParams }: PageProps<"/">) {
  const { community } = await searchParams;
  const id = typeof community === "string" ? community : null;
  const selected = communities.find((c) => c.id === id) ?? null;
  if (id && !selected) {
    notFound();
  }

typeof community === "string" écarte l'absence de paramètre et une liste venant d'une adresse comme ?community=a&community=b. find renvoie la première guilde dont l'id correspond, ou undefined, que ?? null transforme en null, c'est-à-dire "toutes les guildes". Une adresse avec un id inconnu, par exemple /?community=kraken, se termine par une page 404 au lieu d'une liste vide qui ferait semblant que la guilde existe. En dessous, la page assemble la barre latérale et Feed, et transmet aux deux la guilde choisie.

La barre latérale : des liens plutôt que des boutons

components/CommunitySidebar.tsx n'a pas d'état, il reste donc un Server Component. Chaque guilde est un lien :

<Link
  key={community.id}
  href={{ pathname: "/", query: { community: community.id } }}
  aria-current={selectedCommunity === community.id ? "page" : undefined}
  className={selectedCommunity === community.id ? active : idle}
>

href sous forme d'objet assemble l'adresse seul et encode les caractères spéciaux, tu ne colles donc pas du texte à la main. aria-current="page" dit au lecteur d'écran quelle guilde est ouverte, et active et idle sont deux jeux de classes en haut du fichier : la guilde choisie a un fond gris et du gras. Le premier lien, Toutes, mène simplement à /. Un lien de next/link passe d'une guilde à l'autre sans recharger la page, comme dans la leçon 2_1.

Le filtre dans Feed

Ouvre components/Feed.tsx. Une prop community est arrivée, avec la guilde choisie ou null, et la liste à afficher se calcule à partir des posts :

const selectedCommunity = community?.id ?? null;
const filtered = selectedCommunity
  ? posts.filter((post) => post.community === selectedCommunity)
  : posts;
const visiblePosts = sortPosts(filtered, sortMode);

filter garde les posts dont community correspond à la guilde choisie. Quand aucune guilde n'est choisie, selectedCommunity vaut null et tous les posts passent. Le tri de la leçon 4_1 agit sur la liste filtrée. L'état des posts n'a pas bougé du tout : passer à une autre guilde ne change que l'adresse, et Feed reste à sa place dans la page, donc les votes et les nouveaux posts survivent à la promenade entre les guildes.

L'en-tête et le bouton Rejoindre

Au-dessus des posts se tient CommunityHeader, avec une bannière, la première lettre du nom dans un rond comme icône, la description, le nombre de membres et les règles. Le bouton Rejoindre change son texte en Rejoint. Où garder cette information ? Si l'en-tête avait son propre useState, React garderait cet état en passant d'une guilde à l'autre, car c'est le même composant au même endroit, et r/SeaBattles afficherait "Rejoint" après un clic sur r/TreasureHunting. C'est pourquoi la liste des guildes que tu as rejointes est tenue par Feed :

const [joined, setJoined] = useState<string[]>([]);

const toggleJoin = (id: string) => {
  setJoined((prev) => (prev.includes(id) ? prev.filter((x) => x !== id) : [...prev, id]));
};

includes vérifie si l'id est déjà dans la liste. S'il y est, filter construit la liste sans lui ; sinon, le spread l'ajoute à la fin. L'en-tête reçoit isJoined={joined.includes(community.id)} et la fonction onToggleJoin, et ne retient rien lui-même.

Le formulaire de nouveau post

components/CreatePostForm.tsx est un formulaire contrôlé de la leçon 2_3 avec les champs guilde, titre et contenu. Le bouton d'envoi surveille deux conditions :

<button
  type="submit"
  disabled={!community || !title.trim()}
  className="rounded-full bg-orange-600 px-4 py-1 font-semibold text-white disabled:bg-gray-300"
>
  Publier
</button>

Sans guilde choisie, ou avec un titre vide, le bouton est bloqué. Le champ du titre a maxLength={300}, donc le navigateur n'accepte pas un texte plus long. Le formulaire envoyé appelle addPost dans Feed, qui ajoute le post au début de la liste avec un vote pour de l'auteur, userVote: "up". Le formulaire part de la guilde de l'adresse, et dans Feed il a key={selectedCommunity ?? "all"} : une nouvelle clé après le changement de guilde ordonne à React de repartir de zéro avec le formulaire, avec la nouvelle guilde dans le champ de choix.

La revue du capitaine

  1. Une seconde liste dans l'état. C'est l'erreur typique de l'agent : filteredPosts dans un useState séparé, complété au clic sur une guilde. Un nouveau post va dans posts, mais pas dans filteredPosts, donc il disparaît de la vue jusqu'au clic suivant. Quand l'agent synchronise la copie avec un effet, npm run lint l'arrête avec la règle react-hooks/set-state-in-effect :
error  Error: Calling setState synchronously within an effect can trigger cascading renders
  > 11 |     setFilteredPosts(
       |     ^^^^^^^^^^^^^^^^ Avoid calling setState() directly within an effect

Le remède n'est pas de faire taire la règle, mais de supprimer la copie : la liste à afficher est le résultat de filter à chaque rendu.

  1. Une guilde inconnue. Tape /?community=kraken. Il doit y avoir une page 404, et non un écran blanc avec une erreur. L'agent aime écrire communities.find(...)! ; le point d'exclamation ordonne à TypeScript de croire que la guilde sera trouvée, et avec une mauvaise adresse la page plante sur la lecture d'un champ de undefined.

  2. La promenade entre les guildes. Donne un vote à un post, va dans sa guilde, ajoute-y un post et reviens à Toutes. Le vote et le nouveau post doivent rester. Rejoins r/TreasureHunting et passe à r/SeaBattles : là le bouton doit dire Rejoindre.

  3. Un contrôle dans le navigateur. Tu peux confier cette promenade à Claude in Chrome de la leçon 3_8 : "Ouvre localhost:3000, va dans r/TreasureHunting, ajoute un post, clique sur Toutes, reviens avec le bouton Retour et dis-moi ce que tu vois dans la liste et dans la console". C'est la même boucle qu'avec les tests : une épreuve qui donne une réponse, au lieu de l'assurance de l'agent.

Étape suivante

Quand la revue passe, demande un commit, par exemple "Communautés : filtre dans l'adresse, en-tête et formulaire de post". Puis un test pour formatMembers, car c'est une fonction pure avec des nombres en entrée et du texte en sortie :

Écris les tests de formatMembers dans lib/communities.test.ts : 950
donne "950", 12460 donne "12.5K", 999950 donne "1.0M". Lance-les avant
toute modification du code et montre le résultat.

Le dernier cas ne passera pas : Vitest signalera expected '1000.0K' to be '1.0M', car 999 950 n'est pas encore un million, et après l'arrondi des milliers on obtient 1000.0. Ordonne à Claude de corriger la fonction, pas le test, et lis la correction dans le diff. Avant la leçon suivante, tape /clear : une nouvelle fonctionnalité est une nouvelle conversation, et l'ancienne reste disponible pour être reprise. Dans l'éditeur ci-dessous t'attend le registre des guildes ; il n'y a pas d'adresse là-bas, donc le choix est tenu par useState, alors que dans le projet c'est l'adresse qui le tient. Rejoins une guilde, ajoute un post et fais basculer le filtre.

À retenir : une guilde est le même registre de posts regardé par une autre fenêtre, et l'adresse de la page dit quelle fenêtre est ouverte.

Code de cette leçon : App.jsx
// Registre des guildes : une communauté est un filtre sur la même liste de posts.
// L'éditeur n'a pas de barre d'adresse, donc le choix est tenu par useState ;
// dans le projet Crew Council, c'est l'adresse (?community=) qui le tient.
import { useState } from 'react';

const communities = [
  { id: 'treasure-hunting', name: 'r/TreasureHunting', displayName: 'Treasure Hunting', description: 'Cartes, découvertes et trésors de toutes les mers.', members: 12460, rules: ['Partage de vraies trouvailles', "Ne révèle pas les lieux d'expéditions en cours"] },
  { id: 'sea-battles', name: 'r/SeaBattles', displayName: 'Sea Battles', description: 'Batailles navales, stratégies et tactiques.', members: 8920, rules: ['Décris les batailles en détail', "Respecte l'adversaire"] },
  { id: 'pirate-life', name: 'r/PirateLife', displayName: 'Pirate Life', description: 'La vie de tous les jours à bord.', members: 25670, rules: ['Sois toi-même', 'Respecte le code pirate'] },
  { id: 'ship-building', name: 'r/ShipBuilding', displayName: 'Ship Building', description: 'Construction et réparation des navires.', members: 5430, rules: ['Montre tes plans et croquis', 'Aide les débutants'] },
];

const startPosts = [
  { id: 'p1', community: 'pirate-life', title: 'Cap sur Tortuga ou vers le nord ?' },
  { id: 'p2', community: 'treasure-hunting', title: "Une carte avec une croix sur l'île du Crâne" },
  { id: 'p3', community: 'ship-building', title: 'Comment colmater la coque avec du goudron ?' },
  { id: 'p4', community: 'sea-battles', title: 'Le Kraken a coulé notre chaloupe' },
];

function formatMembers(count) {
  if (count >= 1000000) return (count / 1000000).toFixed(1) + 'M';
  if (count >= 1000) return (count / 1000).toFixed(1) + 'K';
  return String(count);
}

function CommunityHeader({ community, isJoined, onToggleJoin }) {
  return (
    <header className="overflow-hidden rounded-lg border border-gray-200 bg-white">
      <div className="h-12 bg-linear-to-r from-red-900 to-gray-900" />
      <div className="flex items-start gap-3 p-3">
        <span aria-hidden="true" className="-mt-8 flex h-12 w-12 items-center justify-center rounded-full border-4 border-white bg-red-800 text-xl font-bold text-white">
          {community.displayName[0]}
        </span>
        <div className="flex-1">
          <h2 className="font-bold">{community.displayName}</h2>
          <p className="text-xs text-gray-500">{community.name} · {formatMembers(community.members)} membres</p>
          <p className="text-sm">{community.description}</p>
        </div>
        <button
          type="button"
          onClick={onToggleJoin}
          aria-pressed={isJoined}
          className={isJoined ? 'rounded-full border px-3 py-1 text-sm' : 'rounded-full bg-blue-600 px-3 py-1 text-sm text-white'}
        >
          {isJoined ? 'Rejoint' : 'Rejoindre'}
        </button>
      </div>
      <ol className="list-inside list-decimal border-t border-gray-200 px-3 py-2 text-sm">
        {community.rules.map((rule) => (
          <li key={rule}>{rule}</li>
        ))}
      </ol>
    </header>
  );
}

function CreatePostForm({ defaultCommunity, onSubmit }) {
  const [community, setCommunity] = useState(defaultCommunity ?? '');
  const [title, setTitle] = useState('');
  const handleSubmit = (event) => {
    event.preventDefault();
    if (!community || !title.trim()) return;
    onSubmit({ community, title: title.trim() });
    setTitle('');
  };
  return (
    <form onSubmit={handleSubmit} className="space-y-2 rounded-lg border border-gray-200 bg-white p-3">
      <select value={community} onChange={(event) => setCommunity(event.target.value)} aria-label="Communauté" className="w-full rounded border border-gray-300 p-2">
        <option value="">Choisis une communauté</option>
        {communities.map((c) => (
          <option key={c.id} value={c.id}>{c.name}</option>
        ))}
      </select>
      <input value={title} onChange={(event) => setTitle(event.target.value)} maxLength={300} placeholder="Titre" aria-label="Titre du post" className="w-full rounded border border-gray-300 p-2" />
      <button type="submit" disabled={!community || !title.trim()} className="rounded-full bg-orange-600 px-4 py-1 font-semibold text-white disabled:bg-gray-300">
        Publier
      </button>
    </form>
  );
}

export default function App() {
  const [posts, setPosts] = useState(startPosts);
  const [selectedCommunity, setSelectedCommunity] = useState(null);
  const [joined, setJoined] = useState([]);

  // Liste à afficher : calculée à chaque rendu, sans second état
  const filtered = selectedCommunity ? posts.filter((post) => post.community === selectedCommunity) : posts;
  const community = communities.find((c) => c.id === selectedCommunity) ?? null;

  const toggleJoin = (id) => {
    setJoined((prev) => (prev.includes(id) ? prev.filter((x) => x !== id) : [...prev, id]));
  };

  const addPost = (draft) => {
    setPosts((prev) => [{ ...draft, id: String(Date.now()) }, ...prev]);
  };

  const linkClass = (active) => (active ? 'block w-full rounded px-3 py-2 text-left bg-gray-200 font-semibold' : 'block w-full rounded px-3 py-2 text-left hover:bg-gray-200');

  return (
    <div className="min-h-screen bg-gray-100 p-4 text-gray-900">
      <div className="mx-auto flex max-w-3xl flex-col gap-4 md:flex-row">
        <nav aria-label="Communautés" className="space-y-1 md:w-48 md:shrink-0">
          <button type="button" onClick={() => setSelectedCommunity(null)} aria-current={selectedCommunity === null ? 'page' : undefined} className={linkClass(selectedCommunity === null)}>
            Toutes
          </button>
          {communities.map((c) => (
            <button key={c.id} type="button" onClick={() => setSelectedCommunity(c.id)} aria-current={selectedCommunity === c.id ? 'page' : undefined} className={linkClass(selectedCommunity === c.id)}>
              <span className="block text-sm">{c.name}</span>
              <span className="block text-xs text-gray-500">{formatMembers(c.members)} membres</span>
            </button>
          ))}
        </nav>
        <main className="flex-1 space-y-3">
          {community && (
            <CommunityHeader community={community} isJoined={joined.includes(community.id)} onToggleJoin={() => toggleJoin(community.id)} />
          )}
          <CreatePostForm key={selectedCommunity ?? 'all'} defaultCommunity={selectedCommunity} onSubmit={addPost} />
          {filtered.length === 0 && <p className="text-gray-500">Cette guilde n&apos;a pas encore de posts.</p>}
          {filtered.map((post) => (
            <article key={post.id} className="rounded-lg border border-gray-200 bg-white p-3">
              <p className="text-xs text-gray-500">{communities.find((c) => c.id === post.community)?.name}</p>
              <h3 className="font-semibold">{post.title}</h3>
            </article>
          ))}
        </main>
      </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. 1. Qu'est-ce qu'une communauté (subreddit) ?

  2. 2. Comment filtres-tu les posts appartenant à la communauté sélectionnée ?

Voici 2 des 7 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre pour construire le filtre des posts par communauté :

  • Éditeur de code

    Barre latérale des communautés

  • Tri horizontal

    Ordonne la condition qui compare la communauté d'un post à celle sélectionnée (sur une seule ligne, de gauche à droite) :

  • Éditeur de code

    En-tête de communauté

  • Tri vertical

    Ordonne ce qui se passe après un clic sur Publier dans le formulaire de r/TreasureHunting :

  • Tri horizontal

    Ordonne l'attribut qui bloque le bouton Publier sans guilde ou sans titre (une ligne, de gauche à droite) :

  • Éditeur de code

    Créer un post dans une communauté

  • Tri vertical

    Ordonne les communautés du plus grand au plus petit nombre de membres (PirateLife 25670, TreasureHunting 12460, SeaBattles 8920, ShipBuilding 5430) :

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre pour construire l'expression qui formate les millions de membres :

  • Tri horizontal

    Ordonne la notation du nom de communauté (sur une seule ligne, de gauche à droite) :

  • Tri vertical

    Ordonne ce que fait la page d'accueil de la leçon à l'ouverture de l'adresse /?community=kraken :

  • Clique dans l'ordre

    Construis la recherche de la guilde dont l'id est lu dans l'adresse, en cliquant sur les éléments dans l'ordre :

  • Tri horizontal

    Ordonne l'attribut de limite de caractères du champ titre (sur une seule ligne, de gauche à droite) :

  1. QuestionQuiz : Communautés
  2. QuestionQuiz : Filtrage par communauté
  3. Clique dans l'ordreClic dans l'ordre : Filtre de communauté
  4. Exercice de codePratique : Liste des communautés
  5. Remets dans l'ordreTri : Comparaison de communauté
  6. QuestionQuiz : formatMembers
  7. Exercice de codePratique : En-tête de communauté
  8. Remets dans l'ordreTri : le chemin d'un nouveau post
  9. QuestionQuiz : où vit l'état Rejoindre
  10. Remets dans l'ordreTri : le blocage du bouton Publier
  11. QuestionQuiz : Validation du formulaire de post
  12. Exercice de codePratique : Formulaire de création de post
  13. Remets dans l'ordreTri : Communautés par nombre de membres
  14. QuestionQuiz : Toutes les communautés
  15. Clique dans l'ordreClic dans l'ordre : formatMembers en millions
  16. Remets dans l'ordreTri : Nom de communauté
  17. Remets dans l'ordreTri : une guilde inconnue dans l'adresse
  18. QuestionQuiz : Règles de la communauté
  19. Clique dans l'ordreClic dans l'ordre : trouver la guilde choisie
  20. Remets dans l'ordreTri : Limite de caractères du titre

Articles utiles