Cours Vibe coding avec Claude Code · Module 14: Clone de Pinterest

Coffres au trésor : tableaux et enregistrement

9 min de lecture
Dans cette leçon10

Le bouton Enregistrer brille déjà sur chaque pin mais il n'a nulle part où enregistrer. Dans Treasure Map, les pins vont dans des tableaux, c'est-à-dire des coffres avec un nom : "Îles à visiter", "Vieilles cartes". Certains coffres sont secrets : seul leur propriétaire les voit, ainsi que les personnes qu'il a invitées à participer, les collaborateurs. Chaque coffre a aussi une couverture, un pin qui le représente sur le profil. Dans cette leçon, Claude construira les tableaux, la fenêtre de création d'un tableau et la fenêtre d'enregistrement d'un pin. Toi, tu surveilleras l'endroit où l'agent économise le plus volontiers : la serrure.

Ce que tu vas apprendre

  • commander des tableaux dont les règles d'accès tiennent dans un seul module et sont vérifiées sur le serveur ;
  • lire la couverture issue de coverPinId avec une solution de repli raisonnable ;
  • construire deux fenêtres sur <dialog>, comme dans la leçon 6_2, et les tester au clavier ;
  • prouver avec curl qu'un tableau secret ne quitte pas le serveur pour des inconnus.

Une habitude : un diff propre

Ce changement touchera une quinzaine de fichiers : avant de commencer, mets de l'ordre dans le diff. Si le nouveau projet n'a pas encore le hook PostToolUse de la leçon 7_1, demande-le en une phrase ou reprends .claude/settings.json de Ship's Comms, avec Prettier dans le projet. Le hook formate chaque fichier juste après son édition : dans Source Control, tu ne verras que les changements de logique, pas des indentations déplacées. Ainsi, tu n'as pas à demander le formatage dans chaque demande.

Demande pour Claude Code

L'étape touche des données, quatre routes, deux pages et deux fenêtres : tu commences donc par un plan :

Demande pour Claude Code :

/plan Ajoute les tableaux, c'est-à-dire des coffres pour les pins.
lib/boards.ts : Board avec ownerId, name, description, isSecret,
coverPinId, pinIds et collaboratorIds, magasin de démo sur globalThis.
L'identité vient uniquement de getCurrentUserId() dans lib/session.ts
(cookie demo-user, comme dans la leçon 11_3), jamais du corps de la
requête. Un tableau secret est vu par son propriétaire et ses
collaborateurs : c'est le serveur qui le filtre dans lib/boards.ts, un
inconnu reçoit 404. Routes : GET et POST /api/boards, POST
/api/boards/[id]/pins, DELETE /api/boards/[id] (propriétaire
uniquement). Couverture issue de coverPinId, et à défaut le premier
pin. Fenêtres de création de tableau et d'enregistrement d'un pin sur
<dialog> avec showModal, comme dans la leçon 6_2. D'abord les tests de
la couverture et de la route GET. À la fin : tests, lint,
npx tsc --noEmit et npm run build.

Dans le plan, vérifie une seule phrase : où disparaît le tableau secret. Si le plan parle de le "cacher dans le composant", réponds que c'est le serveur qui doit le filtrer.

Ce que Claude a écrit : les règles au même endroit

Ouvre lib/boards.ts dans Cursor. Qui voit quoi et qui peut quoi, deux petites fonctions le disent :

// lib/boards.ts
export function canView(board: Board, viewerId: string | null): boolean {
  return !board.isSecret || board.ownerId === viewerId || board.collaboratorIds.includes(viewerId ?? "");
}

export function canSavePins(board: Board, viewerId: string | null): boolean {
  return viewerId !== null && (board.ownerId === viewerId || board.collaboratorIds.includes(viewerId));
}

viewerId est l'identifiant de la personne qui regarde la page, ou null si personne n'est connecté. Un tableau public est vu de tous, un tableau secret seulement par son propriétaire et ses collaborateurs. Seuls le propriétaire et les collaborateurs ajoutent des pins, et seul le propriétaire peut supprimer un tableau. Chaque route et chaque page appellent les mêmes fonctions : la règle tient donc en un seul endroit. Si un nouveau rôle arrive demain, tu changeras un fichier, pas six.

Ce que Claude a écrit : la couverture

L'ancien code de ce module vérifiait coverPinId, mais montrait quand même le premier pin : le champ n'existait que pour la forme. La version de Claude :

// lib/boards.ts
export function boardCover(board: Board, pins: ReadonlyMap<string, Pin>): Pin | undefined {
  const coverId = board.coverPinId && board.pinIds.includes(board.coverPinId) ? board.coverPinId : board.pinIds[0];
  return coverId ? pins.get(coverId) : undefined;
}

coverPinId l'emporte, mais seulement si ce pin est toujours dans le coffre. Quelqu'un a pu le retirer, et une couverture venue du pin d'un autre serait étrange. Sinon, la couverture est le premier pin, et un tableau vide n'a pas de couverture du tout : le profil affiche un rectangle gris. ReadonlyMap est une table en lecture seule, de l'identifiant vers le pin. Quatre tests surveillent chaque branche. Sur le profil /u/capitaine, le coffre "Îles à visiter" a montré chez nous le Lagon de coverPinId, et non le premier pin du tableau.

Le tableau secret disparaît sur le serveur

Ouvre app/api/boards/route.ts :

// app/api/boards/route.ts
export async function GET(request: Request) {
  const owner = new URL(request.url).searchParams.get("owner");
  if (!owner) return Response.json({ error: "Indique le propriétaire." }, { status: 400 });
  const viewerId = await getCurrentUserId();
  return Response.json(listBoards(owner, viewerId).map(({ id, name, isSecret }) => ({ id, name, isSecret })));
}

listBoards filtre avec canView avant que quoi que ce soit ne sorte du serveur, et map n'envoie que les champs utiles à la liste. Voici l'erreur typique de l'agent à cet endroit : la route renvoie tous les tableaux, et le composant cache les secrets avec la condition !board.isSecret || isOwner. À l'écran, tout semble correct, mais le nom du coffre secret part vers tous les navigateurs et se voit dans l'onglet Network. Vérifie-le avec npm run dev en marche, en inconnu puis en propriétaire :

curl -s -b demo-user=perroquet 'localhost:3000/api/boards?owner=capitaine'
curl -s -b demo-user=capitaine 'localhost:3000/api/boards?owner=capitaine'

-b envoie le cookie, c'est-à-dire qu'il fait passer curl pour une personne connectée. Chez nous, Polly le perroquet n'a reçu que [{"id":"b1","name":"Îles à visiter","isSecret":false}], et le capitaine a aussi reçu "Cachette du trésor". La page du tableau fonctionne de la même façon : getBoard renvoie null pour le tableau secret d'un autre, et la page appelle notFound(). Un inconnu reçoit 404, pas 403. Un code 403 trahirait l'existence du tableau.

Ce que Claude a écrit : la fenêtre d'enregistrement

Ouvre components/SavePinDialog.tsx. PinFeed garde dans son état le pin que quelqu'un veut enregistrer, et la fenêtre s'ouvre quand ce pin apparaît :

// components/SavePinDialog.tsx
useEffect(() => {
  if (pin) dialogRef.current?.showModal();
}, [pin]);

L'effet ne modifie pas d'état, il appelle une méthode de l'élément : la règle set-state-in-effect n'a donc rien à lui reprocher. La fenêtre elle-même :

// components/SavePinDialog.tsx
<dialog ref={dialogRef} aria-labelledby="save-pin-title" onClose={() => { setStatus(null); onClose(); }} className="m-auto w-full max-w-sm rounded-2xl bg-white p-5 backdrop:bg-black/50">
  <h2 id="save-pin-title">Enregistrer : {pin?.title}</h2>
  <button type="button" onClick={() => dialogRef.current?.close()} aria-label="Fermer la fenêtre d'enregistrement">×</button>

Tu sais depuis la leçon 6_2 que showModal() déplace le focus dans la fenêtre, qu'Échap la ferme et que m-auto la place au centre malgré la remise à zéro des marges de Tailwind 4. L'évènement onClose arrive après Échap comme après close(), donc le parent efface dans les deux cas le pin choisi. La croix a un aria-label, car le seul signe "×" ne dit pas au lecteur d'écran ce que fait le bouton. Sous le titre figure la liste des tableaux de la personne connectée, avec la mention "(secret)" pour les tableaux secrets. Un clic envoie POST /api/boards/[id]/pins, et un champ role="status" dit si cela a réussi.

La fenêtre de création de tableau, components/CreateBoardDialog.tsx, a un formulaire avec le nom (required, maxLength={50}) et une case "Tableau secret". La route POST /api/boards revérifie la longueur du nom, car les contraintes du formulaire ne sont que des suggestions du navigateur. En cas de succès, la fenêtre se ferme et router.refresh() rafraîchit les données du Server Component : le nouveau coffre apparaît sur le profil sans rechargement.

Les actions du propriétaire sur le serveur

La page du tableau n'affiche les boutons Modifier le tableau et Supprimer que si viewerId === board.ownerId. Un bouton caché ne protège pourtant rien, car on peut envoyer la requête sans passer par la page. C'est pourquoi DELETE /api/boards/[id] revérifie tout, dans l'ordre : l'identité avec getCurrentUserId(), puis getBoard (un tableau absent ou le tableau secret d'un autre donne 404), et seulement ensuite le propriétaire (403). La suppression vient tout à la fin. Chez nous, Polly, bien que collaboratrice, a reçu en tentant de supprimer {"error":"Seul le propriétaire supprime le tableau."} avec le code 403. Cette même Polly a ajouté un pin à "Îles à visiter" (201), et pour le tableau secret "Cachette du trésor" elle a reçu 404.

Sous le titre du tableau, les sections seront utiles : ce sont des cloisons dans le coffre, par exemple Caraïbes et Pacifique. La section choisie est un simple état activeSection du composant, et la liste des pins visibles est calculée par le rendu à partir de cet état, comme les colonnes de la leçon 13_1.

La revue du capitaine

  1. La serrure sur le serveur. Cherche isSecret dans components/. On a le droit de l'afficher comme "(secret)", jamais de filtrer avec. Lance ensuite les deux commandes curl de cette leçon.
  2. Qui demande. Cherche body.ownerId et ownerId: dans les routes. Le propriétaire d'un nouveau tableau doit venir de getCurrentUserId(). L'agent aime accepter ownerId depuis le formulaire, et alors n'importe qui peut créer un tableau au nom d'un autre.
  3. La couverture. Mets sur un tableau un coverPinId qui pointe vers un pin extérieur et regarde le profil : le premier pin doit revenir.
  4. Le clavier. Tab jusqu'au bouton Enregistrer, Entrée, Échap. Chez nous, le focus est entré sur la croix, puis est revenu sur "Enregistrer le pin : Crique à l'aube" après Échap. La fenêtre de création de tableau s'est placée au centre, avec le focus dans le champ Nom. L'agent construit souvent la fenêtre avec un div et fixed inset-0. Alors Échap ne fait rien et Tab s'échappe vers la page en dessous.

Étape suivante

Quand la revue passe, demande un commit "Tableaux, coffres secrets et enregistrement des pins". Puis une petite étape, de nouveau avec un plan : "Ajoute les sections du tableau : sections avec id, name et pinIds, changées par des boutons au-dessus de la grille ; seul le propriétaire peut ajouter une section, ce que la route vérifie". Dans l'éditeur ci-dessous t'attend un coffre en miniature : la fenêtre d'enregistrement sur <dialog>, le sélecteur entre inconnu et propriétaire, les sections et la couverture issue de coverPinId.

Retiens ceci : un coffre sans serrure n'est qu'un écrin, et la serrure se pose au cœur du port, sur le serveur, pas sur le couvercle peint de l'interface.

Code de cette leçon : App.tsx
// Coffre en miniature : serrure côté serveur, couverture issue de coverPinId, fenêtre d’enregistrement sur <dialog> et sections
import { useRef, useState } from 'react';

interface Pin {
  id: string;
  title: string;
  color: string;
  sectionId: string | null;
}

interface Board {
  id: string;
  ownerId: string;
  name: string;
  isSecret: boolean;
  coverPinId: string | null;
  pinIds: string[];
  collaboratorIds: string[];
}

const PINS: Pin[] = [
  { id: 'p1', title: 'Sable sous le palmier', color: '#e8c868', sectionId: 'caraibes' },
  { id: 'p2', title: 'Lagon', color: '#a8c808', sectionId: 'caraibes' },
  { id: 'p3', title: 'Jungle sur l’île', color: '#284858', sectionId: 'pacifique' },
  { id: 'p4', title: 'Or dans le coffre', color: '#f88808', sectionId: null },
  { id: 'p5', title: 'Vieille carte', color: '#986848', sectionId: null },
];
const pinsById = new Map(PINS.map((pin) => [pin.id, pin]));
const SECTIONS = [
  { id: 'caraibes', name: 'Caraïbes' },
  { id: 'pacifique', name: 'Pacifique' },
];

const BOARDS: Board[] = [
  { id: 'b1', ownerId: 'capitaine', name: 'Îles à visiter', isSecret: false, coverPinId: 'p2', pinIds: ['p1', 'p2', 'p3'], collaboratorIds: ['perroquet'] },
  { id: 'b2', ownerId: 'capitaine', name: 'Cachette du trésor', isSecret: true, coverPinId: null, pinIds: ['p4', 'p5'], collaboratorIds: [] },
];

// "Serveur" : ces fonctions se trouvent dans le projet, dans lib/boards.ts et les routes d’API
function canView(board: Board, viewerId: string | null) {
  return !board.isSecret || board.ownerId === viewerId || board.collaboratorIds.includes(viewerId ?? '');
}
function serverListBoards(viewerId: string | null) {
  return BOARDS.filter((board) => canView(board, viewerId));
}
function serverDeleteBoard(board: Board, viewerId: string | null) {
  return board.ownerId === viewerId ? '204: tableau supprimé' : '403: Seul le propriétaire supprime le tableau.';
}
function boardCover(board: Board): Pin | undefined {
  const coverId = board.coverPinId && board.pinIds.includes(board.coverPinId) ? board.coverPinId : board.pinIds[0];
  return coverId ? pinsById.get(coverId) : undefined;
}

const VIEWERS = [
  { id: 'capitaine', label: 'Capitaine (propriétaire)' },
  { id: 'perroquet', label: 'Polly (collaboratrice)' },
  { id: '', label: 'Inconnu (non connecté)' },
];

export default function App() {
  const [viewer, setViewer] = useState('capitaine');
  const viewerId = viewer || null;
  const [openBoardId, setOpenBoardId] = useState('b1');
  const [activeSection, setActiveSection] = useState<string | null>(null);
  const [message, setMessage] = useState('');
  const [savedTo, setSavedTo] = useState<string | null>(null);
  const dialogRef = useRef<HTMLDialogElement>(null);

  const boards = serverListBoards(viewerId);
  const board = boards.find((b) => b.id === openBoardId) ?? boards[0];
  const visiblePins = board.pinIds
    .map((id) => pinsById.get(id))
    .filter((pin): pin is Pin => pin !== undefined && (activeSection === null || pin.sectionId === activeSection));
  const myBoards = boards.filter((b) => viewerId !== null && (b.ownerId === viewerId || b.collaboratorIds.includes(viewerId)));

  return (
    <div className="min-h-screen space-y-4 bg-amber-50 p-4 text-zinc-900">
      <label className="flex items-center gap-2 text-sm">
        Qui regarde :
        <select value={viewer} onChange={(e) => { setViewer(e.target.value); setMessage(''); }} className="rounded border border-zinc-300 px-2 py-1">
          {VIEWERS.map((v) => (
            <option key={v.id} value={v.id}>{v.label}</option>
          ))}
        </select>
      </label>
      <p className="rounded bg-zinc-900 p-2 font-mono text-xs text-green-300">
        GET /api/boards?owner=capitaine → {JSON.stringify(boards.map((b) => b.name))}
      </p>
      <ul className="grid grid-cols-2 gap-3">
        {boards.map((b) => {
          const cover = boardCover(b);
          return (
            <li key={b.id}>
              <button type="button" onClick={() => { setOpenBoardId(b.id); setActiveSection(null); }} className="w-full text-left">
                <div className="aspect-square rounded-xl" style={{ backgroundColor: cover?.color ?? '#d4d4d8' }} />
                <p className="font-semibold">{b.name}{b.isSecret ? ' (secret)' : ''}</p>
                <p className="text-xs text-zinc-500">Couverture : {cover?.title ?? 'aucune'}</p>
              </button>
            </li>
          );
        })}
      </ul>
      <section className="rounded-xl bg-white p-3">
        <h1 className="text-lg font-bold">{board.name}</h1>
        <div className="my-2 flex flex-wrap gap-2">
          <button type="button" onClick={() => setActiveSection(null)} className={activeSection === null ? 'rounded-full bg-black px-3 py-1 text-white' : 'rounded-full bg-zinc-200 px-3 py-1'}>
            Tous
          </button>
          {SECTIONS.map((section) => (
            <button key={section.id} type="button" onClick={() => setActiveSection(section.id)} className={activeSection === section.id ? 'rounded-full bg-black px-3 py-1 text-white' : 'rounded-full bg-zinc-200 px-3 py-1'}>
              {section.name}
            </button>
          ))}
        </div>
        <ul className="flex flex-wrap gap-2">
          {visiblePins.map((pin) => (
            <li key={pin.id} className="rounded-lg px-3 py-6 text-sm text-white" style={{ backgroundColor: pin.color }}>
              <span className="rounded bg-black/50 px-1">{pin.title}</span>
            </li>
          ))}
        </ul>
        <div className="mt-3 flex flex-wrap gap-2">
          <button type="button" onClick={() => { setSavedTo(null); dialogRef.current?.showModal(); }} className="rounded-full bg-red-600 px-4 py-2 font-semibold text-white">
            Enregistrer le pin Récif corallien
          </button>
          {viewerId === board.ownerId && (
            <button type="button" className="rounded-full bg-zinc-200 px-4 py-2">Modifier le tableau</button>
          )}
          <button type="button" onClick={() => setMessage(serverDeleteBoard(board, viewerId))} className="rounded-full bg-zinc-200 px-4 py-2">
            Envoyer DELETE (sans passer par le bouton)
          </button>
        </div>
        {message && <p role="status" className="mt-2 text-sm">{message}</p>}
      </section>
      <dialog ref={dialogRef} aria-labelledby="save-title" className="m-auto w-full max-w-sm rounded-2xl bg-white p-5 backdrop:bg-black/50">
        <div className="flex items-start justify-between">
          <h2 id="save-title" className="text-lg font-bold">Enregistrer : Récif corallien</h2>
          <button type="button" onClick={() => dialogRef.current?.close()} aria-label="Fermer la fenêtre d’enregistrement" className="px-2 text-xl">×</button>
        </div>
        {myBoards.length === 0 ? (
          <p className="mt-3">Connecte-toi pour enregistrer des pins.</p>
        ) : (
          <ul className="mt-3 space-y-2">
            {myBoards.map((b) => (
              <li key={b.id}>
                <button type="button" onClick={() => setSavedTo(b.name)} className="w-full rounded-lg bg-zinc-100 px-3 py-2 text-left">
                  {b.name}{b.isSecret ? ' (secret)' : ''}
                </button>
              </li>
            ))}
          </ul>
        )}
        <p role="status" className="mt-2 text-sm">{savedTo ? 'Enregistré dans le coffre : ' + savedTo : ''}</p>
      </dialog>
      <p className="text-sm text-zinc-600">Ouvre la fenêtre d’enregistrement, puis appuie sur Échap : la fenêtre se ferme et le focus revient sur le bouton.</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. 1. Qu'est-ce qu'un tableau dans notre clone ?

  2. 2. Qui voit un tableau secret, et où est-il caché au reste du monde ?

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

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne l'appel qui ouvre la fenêtre d'enregistrement en modal :

  • Clique dans l'ordre

    Clique sur les éléments pour construire la ligne de la route qui détermine l'identité d'après le cookie, et non d'après le corps de la requête :

  • Éditeur de code

    Crée une modale pour créer un tableau

  • Tri vertical

    Ordonne les étapes de l'enregistrement d'un pin par SavePinDialog :

  • Éditeur de code

    Crée une modale pour enregistrer une épingle

  • Tri vertical

    Ordonne les étapes de la route DELETE /api/boards/[id], de la première à la dernière :

  • Clique dans l'ordre

    Clique sur les éléments pour construire la gestion du clic sur un bouton de section :

  • Tri horizontal

    Ordonne la dernière ligne de la fonction boardCover :

  1. QuestionQuiz : Le tableau dans Treasure Map
  2. QuestionQuiz : Qui voit le tableau secret
  3. Remets dans l'ordreTri : Ouverture de la fenêtre dialog
  4. Clique dans l'ordreConstruction : Qui demande
  5. Exercice de codePratique : la modale de création de tableau
  6. QuestionQuiz : Les sections du tableau
  7. QuestionQuiz : Les droits d'un collaborateur
  8. Remets dans l'ordreTri : Enregistrer un pin dans un coffre
  9. Exercice de codePratique : la modale d'enregistrement d'épingle
  10. QuestionQuiz : La couverture issue de coverPinId
  11. Remets dans l'ordreTri : Les contrôles de la route DELETE
  12. Clique dans l'ordreConstruction : Choix de la section
  13. QuestionQuiz : Les actions du propriétaire sur le serveur
  14. Remets dans l'ordreTri : La couverture ou rien

Articles utiles