Cours Vibe coding avec Claude Code · Module 8: Clone de Slack
Le rapport pour l'armateur : un export CSV qui ne se disloque pas et un PDF depuis l'impression
Dans cette leçon8
Le quartier-maître veut l'historique d'un canal dans un tableur, et l'armateur le rapport du tableau de bord en PDF. Les deux fichiers doivent sortir corrects même quand l'équipage écrit des virgules, des guillemets et des retours à la ligne, et même quand un malveillant tape dans le chat un texte que le tableur prendra pour une formule.
Problème : du texte écrit par des humains dans un fichier pour des machines
Le CSV (valeurs séparées par des virgules) est du texte brut : une ligne est un enregistrement, et la virgule sépare les cellules. Les messages d'un chat enfreignent ces règles à chaque pas, car ils contiennent eux-mêmes des virgules et des retours à la ligne. Le standard CSV, RFC 4180 (https://www.rfc-editor.org/rfc/rfc4180), dit qu'une cellule contenant une virgule, un guillemet ou un retour à la ligne se met entre guillemets, et qu'un guillemet à l'intérieur se double. Le second danger a un nom : l'injection de formule (CSV Injection). Un tableur traite une cellule commençant par = comme une formule, et la page OWASP « CSV Injection » (https://community.owasp.org/attacks/CSV_Injection) décrit comment une telle formule peut faire sortir des données d'un tableur ouvert ou pousser quelqu'un à ignorer un avertissement. La troisième question est l'accès : l'export n'est qu'un autre chemin vers les mêmes messages, donc la même règle que pour la page du canal le garde.
Demande pour Claude Code :
Ajoute l'export de l'historique d'un canal en CSV : un Route Handler
GET sous /c/[channel]/export et un lien "Exporter en CSV" dans
l'en-tête du canal. Un canal que le membre connecté n'a pas le droit
de voir répond 404. D'abord les tests de la fonction toCsv dans
lib/csv.ts : virgule, guillemet et retour à la ligne dans le texte,
liste vide, valeur absente, texte commençant par =, +, - ou @
(règles de la page OWASP "CSV Injection", donne le lien). Les lettres
accentuées doivent fonctionner dans Excel. Pour finir, tests, lint,
types et build.Ce qu'a montré le premier passage
La première version de toCsv tenait en une ligne : row.join(",") pour chaque ligne et join("\n") pour l'ensemble. Cinq tests sur six ont échoué. Pour voir ce qui arriverait au quartier-maître, Claude a fait passer par cette fonction deux messages : une liste de courses avec une virgule, des guillemets et une deuxième ligne, et un texte commençant par =. Résultat :
Date,Auteur,Texte,Réactions
2026-11-14 09:00,Anne Bonny,Pour demain : eau, rhum et "biscuits"
le reste dans la cale,2
2026-11-14 09:05,Jack Rackham,=HYPERLINK("https://example.com";"Carte au trésor"),0Un parseur conforme au standard en a lu quatre enregistrements au lieu de trois. Dans la ligne d'Anne, la colonne « Texte » n'a reçu que « Pour demain : eau », et le reste de la phrase a atterri dans la colonne « Réactions ». La deuxième ligne du message est devenue un enregistrement à part avec deux cellules. Le texte de Jack est passé tel quel, donc un tableur y verrait une formule avec un lien.
Ce qu'a écrit Claude : une cellule qui ne se disloque pas
Ouvre lib/csv.ts dans Cursor. Le type Cell décrit la valeur d'une cellule : du texte, un nombre ou une absence de valeur. Toute la sécurité tient dans une seule fonction :
const FORMULA_START = /^[=+\-@\t\r\n=+-@]/;
export function escapeCell(value: Cell): string {
if (typeof value === "number") return String(value); // nombres calculés par le serveur
let text = value ?? "";
if (FORMULA_START.test(text)) {
text = `'${text}`; // apostrophe : le tableur affiche du texte, sans calculer la formule
}
return `"${text.replaceAll('"', '""')}"`;
}FORMULA_START vérifie le premier caractère : =, +, -, @, la tabulation et les retours à la ligne, plus leurs équivalents pleine largeur, que l'OWASP cite aussi. Un tel texte reçoit une apostrophe au début, puis chaque texte est mis entre guillemets, et les guillemets à l'intérieur sont doublés. Ce sont les trois étapes de la liste de l'OWASP, après lesquelles le tableur doit lire la cellule comme du texte. Les nombres calculés par le serveur, comme le nombre de réactions, restent des nombres sans guillemets, donc le moins d'un nombre négatif n'effraie personne. Le message dans les données ne change pas : l'apostrophe n'existe que dans le fichier.
Un des tests vérifie l'exemple de cette même page de l'OWASP : le texte =1+2";=1+2 essaie de fermer le guillemet et d'ouvrir après le point-virgule une nouvelle cellule avec une formule. Après le doublement du guillemet, il reste une seule cellule "'=1+2"";=1+2". L'OWASP ajoute honnêtement qu'aucune méthode ne marche dans tous les tableurs, et que dans Excel la protection peut disparaître après un enregistrement et une réouverture du fichier. Traite donc le fichier d'export comme un rapport à lire, et non comme des données à renvoyer à l'application.
toCsv elle-même relie les cellules par des virgules et les lignes par \r\n, car c'est ainsi que la RFC 4180 sépare les enregistrements. Une liste vide ne donne que l'en-tête, donc un canal vide ne fait pas tomber l'export.
Un fichier depuis le serveur : le Route Handler
Un Route Handler est un fichier route.ts dans le dossier app qui, au lieu d'une page, renvoie n'importe quelle réponse, ici un fichier. La documentation de Next.js dit qu'il ne peut pas se trouver dans le même segment que page.tsx, c'est pourquoi l'export a son propre dossier. Ouvre app/c/[channel]/export/route.ts. Le début ressemble à la page du canal de la leçon 7_1 :
export async function GET(
_request: Request,
ctx: RouteContext<"/c/[channel]/export">,
) {
const { channel: name } = await ctx.params;
const me = await getCurrentMember();
const channel = findChannel(name);
if (!channel || !canSeeChannel(channel, me)) {
return new Response("Ce canal n'existe pas", { status: 404 });
}GET dans le nom de la fonction signifie qu'elle traite un simple téléchargement d'adresse. RouteContext est un type d'aide de la documentation qui connaît les paramètres de la route, et params est une promesse, comme dans les pages. Un invité qui tape l'adresse d'export d'un canal privé reçoit un 404, et le fichier n'est même pas créé. Selon la documentation, les Route Handlers ne sont pas mis en cache par défaut, donc chaque export prend des messages frais. La fin de la fonction assemble la réponse :
return new Response("\uFEFF" + csv, {
headers: {
"Content-Type": "text/csv; charset=utf-8",
"Content-Disposition": `attachment; filename="${channel.name}-${dayKey(new Date())}.csv"`,
},
});Content-Type dit qu'il s'agit d'un CSV en encodage UTF-8. Content-Disposition: attachment demande au navigateur de télécharger le fichier au lieu de l'afficher et suggère un nom, par exemple general-2026-11-14.csv. Le caractère \uFEFF au début est le BOM, un marqueur d'encodage invisible. Microsoft écrit sur la page d'aide d'Excel (https://support.microsoft.com/en-us/office/opening-csv-utf-8-files-correctly-in-excel-8a935af5-3416-4edd-ba7e-3dfd2bc4a032) qu'un fichier CSV en UTF-8 avec BOM s'ouvre normalement, alors que sans lui il faut passer par l'import de l'onglet Données. Les lignes reçoivent la date dans le fuseau de Paris grâce à la fonction stamp, sœur de dayKey de la leçon précédente, puis l'auteur, le texte et le nombre de réactions.
Le lien dans components/ChannelHeader.tsx est une simple balise <a> avec l'adresse /c/<canal>/export, et non un Link de Next.js. La documentation précise que les Route Handlers ne participent pas à la navigation côté navigateur, que gère Link.
Sans serveur : un fichier depuis le navigateur
Quand les données sont déjà dans le navigateur, par exemple dans l'éditeur ci-dessous, où il n'y a pas de serveur, c'est la page elle-même qui construit le fichier :
function downloadCsv(csv, filename) {
const blob = new Blob(["\uFEFF" + csv], { type: "text/csv;charset=utf-8" });
const url = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = url;
link.download = filename;
link.click();
setTimeout(() => URL.revokeObjectURL(url), 1000);
}Un Blob est un fichier gardé dans la mémoire du navigateur, URL.createObjectURL lui donne une adresse temporaire, et un lien avec l'attribut download le télécharge sous le nom indiqué. Après un instant, URL.revokeObjectURL libère l'adresse, car d'après MDN on l'appelle quand l'adresse n'est plus nécessaire. Dans Ship's Comms, pourtant, le Route Handler l'emporte : le serveur vérifie l'accès avant d'envoyer quoi que ce soit, et le navigateur ne reçoit que des données que le membre connecté peut de toute façon voir.
Un PDF : l'impression plutôt qu'une bibliothèque
Le rapport pour l'armateur est le tableau de bord de la leçon précédente, donc le PDF naît de la même page.
Demande pour Claude Code :
Ajoute au tableau de bord un bouton "Imprimer ou enregistrer en PDF"
qui ouvre la fenêtre d'impression. À l'impression, il ne doit rester
que le rapport, sans barre latérale ni boutons. Pas de bibliothèque
pour le PDF. Vérifie l'impression d'une page plus longue : rien ne
doit être coupé.Claude a ajouté au tableau de bord un petit composant client, components/PrintButton.tsx :
"use client";
export function PrintButton() {
return (
<button
type="button"
onClick={() => window.print()}
className="rounded-md border border-gray-300 bg-white px-3 py-1.5 text-sm font-semibold hover:bg-gray-50 print:hidden"
>
Imprimer ou enregistrer en PDF
</button>
);
}window.print() ouvre la fenêtre d'impression du navigateur, où tu choisis l'enregistrement en PDF. Le composant a besoin de "use client", car il réagit à un clic. print: est la variante Tailwind pour @media print, c'est-à-dire des styles qui ne valent qu'à l'impression : print:hidden cache le bouton, et la même classe sur la barre latérale dans components/Sidebar.tsx ne laisse sur le papier que le rapport. Une bibliothèque de PDF serait une dépendance de plus et une mise en page à entretenir à part, alors que l'impression reprend le même HTML et les mêmes polices que le tableau de bord. Dans le PDF enregistré depuis Chrome, les lettres accentuées, par exemple dans le titre « Membres les plus actifs », sont sorties sans changement.
Un piège de l'impression, nous l'avons vérifié sur une page de canal plus longue. La liste des messages défile dans une boîte avec overflow-y-auto, et Chrome n'a imprimé que ce qui tenait dans la boîte : dix messages sur onze, et pour le dernier, seulement la signature de l'auteur. La classe print:overflow-visible lève cette limite le temps de l'impression, et la même impression a tenu sur deux pages. Le tableau de bord a la même mise en page, donc il a reçu cette classe tout de suite, avant de dépasser une page.
La revue du capitaine
- L'invité et l'export. Dans
lib/session.ts, remplace le membre connecté parmarchandet ouvre/c/secrets-du-capitaine/exportet/c/treasure-hunts/export. Chez nous, les deux adresses ont répondu 404, alors que/c/commerce/exporta téléchargé un fichier. Erreur typique d'un agent : vérifier l'accès sur la page du canal, mais pas dans le Route Handler qui se trouve juste à côté. - Chaque cellule. Cherche dans le diff
join(",")sansescapeCell. Souvent, l'agent échappe les guillemets et oublie les formules, ou l'inverse, donc le test avec=et le test avec une virgule doivent se tenir côte à côte. - Le fichier en main. Écris sur
#generalun message avec une virgule, un guillemet et une deuxième ligne (Maj+Entrée), et un autre commençant par=, télécharge le CSV et ouvre-le dans un tableur. Chez nous, le fichier commençait par les octets du BOMEF BB BF, et le parseur CSV a lu chacun des deux messages comme un seul enregistrement de quatre cellules. - La preuve. Les tests, le lint, les types et le build. Avant le premier build,
npx tsc --noEmitsignale une erreur surRouteContext<"/c/[channel]/export">, car les types des routes ne sont générés que parnext buildounext dev; c'est le même piège quePagePropsdans la leçon 7_1. Avant le commit, lance encore/code-review: l'export est l'endroit où les données sortent de l'application, donc un second regard est rentable.
Étape suivante
Demande un commit, par exemple « Export CSV et impression du tableau de bord ». Puis une petite étape avec la même fonction :
Ajoute sous le tableau des canaux du tableau de bord un lien "Exporter
en CSV" vers un Route Handler /panel/export, qui utilise toCsv et les
mêmes canaux que le tableau de bord. D'abord un test : un invité ne
reçoit pas la ligne d'un canal privé. Pour finir, tests, lint, types
et build.Dans l'éditeur ci-dessous t'attend l'export en miniature : ajoute un message avec une virgule, un guillemet ou un = au début, et compare combien d'enregistrements le parseur lit dans un fichier assemblé par join(",") et dans celui de toCsv. Le bouton « Exporter en CSV » télécharge le fichier par un Blob.
Retiens : qui expédie un rapport sans test expédie une cargaison sans contrôle des douanes, et les guillemets et l'apostrophe sont les scellés qui empêchent que quelqu'un glisse de la poudre au port.
Code de cette leçon : App.jsx
// Export en miniature : escapeCell et toCsv de la leçon, à côté d’un assemblage par join(","),
// lecture du fichier par un parseur CSV et téléchargement par Blob. Dans le projet, le fichier est construit
// par le Route Handler /c/[channel]/export, qui vérifie d’abord canSeeChannel.
import { useState } from 'react';
const FORMULA_START = /^[=+\-@\t\r\n=+-@]/;
function escapeCell(value) {
if (typeof value === 'number') return String(value);
let text = value ?? '';
if (FORMULA_START.test(text)) text = "'" + text;
return '"' + text.replaceAll('"', '""') + '"';
}
function toCsv(header, rows) {
return [header, ...rows].map((row) => row.map(escapeCell).join(',')).join('\r\n');
}
// Première version de l’agent : sans échappement
function naiveCsv(header, rows) {
return [header, ...rows].map((row) => row.join(',')).join('\n');
}
// Parseur simple conforme à la RFC 4180 : c’est ainsi qu’un programme qui connaît le standard lira le fichier
function parseCsv(text) {
const records = [];
let row = [];
let cell = '';
let quoted = false;
for (let i = 0; i < text.length; i++) {
const ch = text[i];
if (quoted) {
if (ch === '"' && text[i + 1] === '"') {
cell += '"';
i++;
} else if (ch === '"') quoted = false;
else cell += ch;
} else if (ch === '"' && cell === '') quoted = true;
else if (ch === ',') {
row.push(cell);
cell = '';
} else if (ch === '\n') {
row.push(cell);
records.push(row);
row = [];
cell = '';
} else if (ch !== '\r') cell += ch;
}
row.push(cell);
records.push(row);
return records;
}
function downloadCsv(csv, filename) {
const blob = new Blob(['\uFEFF' + csv], { type: 'text/csv;charset=utf-8' });
const url = URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = url;
link.download = filename;
link.click();
setTimeout(() => URL.revokeObjectURL(url), 1000);
}
const header = ['Date', 'Auteur', 'Texte', 'Réactions'];
const start = [
['2026-11-14 09:00', 'Anne Bonny', 'Pour demain : eau, rhum et "biscuits"\nle reste dans la cale', 2],
['2026-11-14 09:05', 'Jack Rackham', '=HYPERLINK("https://example.com";"Carte au trésor")', 0],
];
function Records({ title, csv, rows }) {
const records = parseCsv(csv);
return (
<section className="rounded-lg border border-gray-200 bg-white p-3">
<h2 className="font-semibold">{title}</h2>
<pre className="mt-2 overflow-x-auto rounded-md bg-gray-100 p-2 text-xs">{csv}</pre>
<p className="mt-2 text-sm">
Enregistrements lus par le parseur : <strong>{records.length}</strong> (l’en-tête et {rows} messages)
</p>
<ol className="mt-1 list-decimal pl-5 text-xs text-gray-700">
{records.map((r, i) => (
<li key={i}>{r.length} cell. : {r.map((c) => '[' + c.replaceAll('\n', ' / ') + ']').join(' ')}</li>
))}
</ol>
</section>
);
}
export default function App() {
const [rows, setRows] = useState(start);
const [text, setText] = useState('');
function add(e) {
e.preventDefault();
if (!text.trim()) return;
setRows([...rows, ['2026-11-14 10:00', 'Capitaine Barbe-Rousse', text, 0]]);
setText('');
}
return (
<div className="min-h-screen bg-gray-50 p-4 text-gray-900">
<form onSubmit={add} className="mb-4 rounded-lg border border-gray-200 bg-white p-3">
<label htmlFor="text" className="text-sm font-semibold">Ajoute un message (virgule, guillemet, = au début)</label>
<textarea id="text" rows={2} value={text} onChange={(e) => setText(e.target.value)} className="mt-1 w-full rounded-md border border-gray-300 p-2 text-sm" />
<div className="mt-2 flex flex-wrap gap-2">
<button className="rounded-md bg-blue-700 px-3 py-1 text-sm font-semibold text-white">Ajouter</button>
<button type="button" onClick={() => downloadCsv(toCsv(header, rows), 'general.csv')} className="rounded-md bg-green-700 px-3 py-1 text-sm font-semibold text-white">
Exporter en CSV
</button>
</div>
</form>
<div className="grid gap-3 md:grid-cols-2">
<Records title='join(",") sans échappement' csv={naiveCsv(header, rows)} rows={rows.length} />
<Records title="toCsv avec escapeCell" csv={toCsv(header, rows)} rows={rows.length} />
</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. Quels en-têtes de réponse du Route Handler /c/[channel]/export font que le navigateur télécharge le fichier CSV au lieu de l'afficher ?
2. Comment escapeCell écrit-elle le texte Pour demain : eau, rhum et "biscuits" pour qu'il reste dans une seule cellule ?
Voici 2 des 8 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Éditeur de code
Exporter des données vers un fichier CSV
- Tri vertical
Ordonne les étapes pour télécharger un fichier CSV construit dans le navigateur, sans serveur :
- Tri horizontal
Ordonne sur une seule ligne le matcher du hook PostToolUse du fichier .claude/settings.json qui se déclenche après Edit et Write :
Exercices après cette leçon
- QuestionQuiz : en-têtes de téléchargement
- QuestionQuiz : virgule et guillemet dans une cellule
- Exercice de codePratique : exporter un rapport CSV
- Remets dans l'ordreTri : télécharger un CSV construit dans le navigateur
- QuestionQuiz : le PDF depuis la vue d'impression
- QuestionQuiz : un graphique pour le lecteur d'écran
- QuestionQuiz : injection de formule dans le CSV
- Remets dans l'ordreTri : matcher d'un hook
- QuestionQuiz : hook ou ligne dans CLAUDE.md
- QuestionQuiz : quand Notification se déclenche
- QuestionQuiz : à quoi servent jq et file_path dans le hook
- Projet à envoyerEnvoie Communications du navire au mentor
- VidéoRésumé du module