Kurs vibe coding z Claude Code · Moduł 8: Klon Slacka

Raport dla armatora: eksport CSV, który się nie rozsypie, i PDF z wydruku

9 min czytania
W tej lekcji8

Kwatermistrz chce historię kanału w arkuszu kalkulacyjnym, a armator raport z panelu w PDF. Oba pliki muszą wyjść poprawne także wtedy, gdy załoga pisze przecinki, cudzysłowy i nowe linie, a ktoś złośliwy wpisze do czatu tekst, który arkusz uzna za formułę.

Problem: tekst od ludzi w pliku dla maszyn

CSV (wartości rozdzielone przecinkami) to zwykły tekst: jeden wiersz to jeden rekord, a przecinek oddziela komórki. Wiadomości z czatu łamią te zasady na każdym kroku, bo same mają przecinki i nowe linie. Standard CSV, RFC 4180 (https://www.rfc-editor.org/rfc/rfc4180), mówi, że komórkę z przecinkiem, cudzysłowem albo nową linią bierze się w cudzysłów, a cudzysłów w środku podwaja. Drugie zagrożenie ma nazwę: wstrzyknięcie formuły (CSV Injection). Arkusz traktuje komórkę zaczynającą się od = jak formułę, a strona OWASP "CSV Injection" (https://community.owasp.org/attacks/CSV_Injection) opisuje, jak taka formuła potrafi wyprowadzić dane z otwartego arkusza albo nakłonić kogoś do zignorowania ostrzeżenia. Trzecia sprawa to dostęp: eksport to tylko inna droga do tych samych wiadomości, więc pilnuje go ta sama zasada co stronę kanału.

Polecenie dla Claude Code:

Dodaj eksport historii kanału do CSV: Route Handler GET pod
/c/[channel]/export i link "Eksportuj CSV" w nagłówku kanału.
Kanał, którego zalogowany nie może widzieć, odpowiada 404.
Najpierw testy funkcji toCsv w lib/csv.ts: przecinek, cudzysłów
i nowa linia w tekście, pusta lista, brak wartości, tekst
zaczynający się od =, +, - albo @ (zasady ze strony OWASP
"CSV Injection", podaj link). Polskie litery mają działać
w Excelu. Na koniec testy, lint, typy i build.

Co pokazał pierwszy przebieg

Pierwsza wersja toCsv mieściła się w jednej linii: row.join(",") dla każdego wiersza i join("\n") dla całości. Pięć z sześciu testów nie przeszło. Żeby zobaczyć, co trafiłoby do kwatermistrza, Claude przepuścił przez tę funkcję dwie wiadomości: listę zakupów z przecinkiem, cudzysłowami i drugą linią oraz tekst zaczynający się od =. Wynik:

Data,Autor,Tekst,Reakcje
2026-11-14 09:00,Anne Bonny,Na jutro: woda, rum i "suchary"
reszta w ładowni,2
2026-11-14 09:05,Jack Rackham,=HYPERLINK("https://example.com";"Mapa skarbu"),0

Parser zgodny ze standardem odczytał z tego cztery rekordy zamiast trzech. W wierszu Anne kolumna "Tekst" dostała tylko "Na jutro: woda", a reszta zdania wylądowała w kolumnie "Reakcje". Druga linia wiadomości stała się osobnym rekordem z dwiema komórkami. Tekst Jacka przeszedł bez zmian, więc arkusz zobaczyłby w nim formułę z linkiem.

Co napisał Claude: komórka, która się nie rozsypie

Otwórz w Cursorze lib/csv.ts. Typ Cell opisuje wartość komórki: tekst, liczbę albo brak wartości. Całe bezpieczeństwo mieści się w jednej funkcji:

const FORMULA_START = /^[=+\-@\t\r\n=+-@]/;

export function escapeCell(value: Cell): string {
  if (typeof value === "number") return String(value); // liczby policzył serwer
  let text = value ?? "";
  if (FORMULA_START.test(text)) {
    text = `'${text}`; // apostrof: arkusz pokaże tekst, nie policzy formuły
  }
  return `"${text.replaceAll('"', '""')}"`;
}

FORMULA_START sprawdza pierwszy znak: =, +, -, @, tabulator i znaki nowej linii, a do tego ich szerokie odpowiedniki, które OWASP też wymienia. Taki tekst dostaje na początku apostrof, potem każdy tekst ląduje w cudzysłowie, a cudzysłów w środku zostaje podwojony. To trzy kroki z listy OWASP, po których arkusz ma czytać komórkę jako tekst. Liczby policzone przez serwer, jak liczba reakcji, zostają liczbami bez cudzysłowu, więc minus przy liczbie ujemnej nikogo nie straszy. Wiadomość w danych się nie zmienia: apostrof istnieje tylko w pliku.

Jeden z testów sprawdza przykład z tej samej strony OWASP: tekst =1+2";=1+2 próbuje zamknąć cudzysłów i otworzyć za średnikiem nową komórkę z formułą. Po podwojeniu cudzysłowu zostaje jedną komórką "'=1+2"";=1+2". OWASP uczciwie dodaje, że żaden sposób nie działa we wszystkich arkuszach, a w Excelu ochrona może zniknąć po zapisaniu i ponownym otwarciu pliku. Plik z eksportu traktuj więc jak raport do czytania, a nie jak dane do odsyłania z powrotem.

Sama toCsv łączy komórki przecinkami, a wiersze znakami \r\n, bo tak RFC 4180 rozdziela rekordy. Pusta lista daje sam nagłówek, więc pusty kanał nie wywraca eksportu.

Plik z serwera: Route Handler

Route Handler to plik route.ts w folderze app, który zamiast strony zwraca dowolną odpowiedź, tutaj plik. Dokumentacja Next.js mówi, że nie może leżeć w tym samym segmencie co page.tsx, dlatego eksport ma własny folder. Otwórz app/c/[channel]/export/route.ts. Początek wygląda jak strona kanału z lekcji 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("Nie ma takiego kanału", { status: 404 });
  }

GET w nazwie funkcji znaczy, że obsługuje zwykłe pobranie adresu. RouteContext to pomocniczy typ z dokumentacji, który zna parametry trasy, a params jest obietnicą, tak jak w stronach. Gość, który wpisze adres eksportu kanału prywatnego, dostaje 404, a plik w ogóle nie powstaje. Według dokumentacji Route Handlery nie są domyślnie zapamiętywane w pamięci podręcznej, więc każdy eksport bierze świeże wiadomości. Koniec funkcji składa odpowiedź:

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 mówi, że to CSV w kodowaniu UTF-8. Content-Disposition: attachment każe przeglądarce pobrać plik zamiast go wyświetlić i podpowiada nazwę, na przykład general-2026-11-14.csv. Znak \uFEFF na początku to BOM, niewidoczny znacznik kodowania. Microsoft pisze na stronie pomocy Excela (https://support.microsoft.com/en-us/office/opening-csv-utf-8-files-correctly-in-excel-8a935af5-3416-4edd-ba7e-3dfd2bc4a032), że plik CSV w UTF-8 z BOM-em otwiera się normalnie, a bez niego trzeba importu przez kartę Dane. Wiersze dostają datę w strefie Warszawy z funkcji stamp, sąsiadki dayKey z poprzedniej lekcji, autora, tekst i liczbę reakcji.

Link w components/ChannelHeader.tsx to zwykły znacznik <a> z adresem /c/<kanał>/export, a nie Link z Next.js. Dokumentacja zaznacza, że Route Handlery nie biorą udziału w nawigacji po stronie przeglądarki, którą obsługuje Link.

Bez serwera: plik z przeglądarki

Gdy dane są już w przeglądarce, na przykład w edytorze poniżej, gdzie serwera nie ma, plik buduje sama strona:

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);
}

Blob to plik trzymany w pamięci przeglądarki, URL.createObjectURL daje mu tymczasowy adres, a link z atrybutem download pobiera go pod podaną nazwą. Po chwili URL.revokeObjectURL zwalnia adres, bo według MDN wołasz ją, gdy adres nie jest już potrzebny. W Ship's Comms wygrywa jednak Route Handler: serwer sprawdza dostęp, zanim cokolwiek wyśle, a do przeglądarki trafiają tylko dane, które zalogowany i tak może zobaczyć.

PDF: wydruk zamiast biblioteki

Raport dla armatora to panel z poprzedniej lekcji, więc PDF powstaje z tej samej strony.

Polecenie dla Claude Code:

Dodaj do panelu przycisk "Drukuj albo zapisz PDF", który otwiera
okno drukowania. Na wydruku ma zostać sam raport, bez paska
bocznego i przycisków. Bez biblioteki do PDF. Sprawdź wydruk
dłuższej strony, czy nic się nie ucina.

Claude dodał do panelu mały komponent kliencki 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"
    >
      Drukuj albo zapisz PDF
    </button>
  );
}

window.print() otwiera okno drukowania przeglądarki, a w nim wybierasz zapis do PDF. Komponent potrzebuje "use client", bo reaguje na kliknięcie. print: to wariant Tailwinda dla @media print, czyli stylów, które działają tylko przy drukowaniu: print:hidden chowa przycisk, a ta sama klasa na pasku bocznym w components/Sidebar.tsx zostawia na papierze sam raport. Biblioteka do PDF byłaby kolejną zależnością i osobnym układem strony do utrzymania, a wydruk korzysta z tego samego HTML-a i tych samych czcionek co panel. W PDF-ie zapisanym z Chrome'a polskie litery, na przykład w nagłówku "Najaktywniejsi członkowie", wyszły bez zmian.

Jedną pułapkę wydruku sprawdziliśmy na dłuższej stronie kanału. Lista wiadomości przewija się w pudełku z overflow-y-auto, a Chrome wydrukował tylko to, co mieściło się w pudełku: z jedenastu wiadomości dziesięć, a z ostatniej sam podpis autora. Klasa print:overflow-visible zdejmuje to ograniczenie na czas druku i ten sam wydruk zajął dwie strony. Panel ma taki sam układ, więc dostał tę klasę od razu, zanim urośnie ponad stronę.

Przegląd kapitana

  1. Gość i eksport. Zmień w lib/session.ts zalogowanego na kupiec i otwórz /c/sekrety-kapitana/export oraz /c/treasure-hunts/export. U nas oba adresy odpowiedziały 404, a /c/handel/export pobrał plik. Typowy błąd agenta: sprawdzenie dostępu na stronie kanału, ale nie w Route Handlerze, który stoi tuż obok.
  2. Każda komórka. Szukaj w diffie join(",") bez escapeCell. Agent często escapuje cudzysłowy i zapomina o formułach albo odwrotnie, więc test z = i test z przecinkiem muszą stać obok siebie.
  3. Plik w ręku. Napisz na #general wiadomość z przecinkiem, cudzysłowem i drugą linią (Shift+Enter) oraz drugą zaczynającą się od =, pobierz CSV i otwórz go w arkuszu. U nas plik zaczynał się od bajtów BOM EF BB BF, a parser CSV odczytał każdą z dwóch wiadomości jako jeden rekord z czterema komórkami.
  4. Dowód. Testy, lint, typy i build. Przed pierwszym buildem npx tsc --noEmit zgłasza błąd przy RouteContext<"/c/[channel]/export">, bo typy tras generuje dopiero next build albo next dev; to ta sama pułapka co z PageProps w lekcji 7_1. Przed commitem uruchom jeszcze /code-review: eksport to miejsce, w którym dane wychodzą poza aplikację, więc drugie spojrzenie się opłaca.

Następny krok

Poproś o commit, na przykład "Eksport CSV i wydruk panelu". Potem mały krok z tą samą funkcją:

Dodaj pod tabelą kanałów w panelu link "Eksportuj CSV" do Route
Handlera /panel/export, który używa toCsv i tych samych kanałów
co panel. Najpierw test, że gość nie dostanie wiersza kanału
prywatnego. Na koniec testy, lint, typy i build.

W edytorze poniżej czeka eksport w miniaturze: dopisz wiadomość z przecinkiem, cudzysłowem albo = na początku i porównaj, ile rekordów parser odczyta z pliku sklejonego przez join(","), a ile z toCsv. Przycisk "Eksportuj CSV" pobiera plik przez Blob.

Pamiętaj: kto wypuszcza raport bez testu, wypuszcza ładunek bez kontroli celnej, a cudzysłów i apostrof to plomby, które pilnują, żeby w porcie nikt nie dosypał prochu.

Kod do tej lekcji: App.jsx
// Eksport w miniaturze: escapeCell i toCsv z lekcji obok sklejania przez join(","),
// odczyt pliku parserem CSV i pobranie przez Blob. W projekcie plik buduje Route Handler
// /c/[channel]/export, który najpierw sprawdza 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');
}

// Pierwsza wersja agenta: bez escapowania
function naiveCsv(header, rows) {
  return [header, ...rows].map((row) => row.join(',')).join('\n');
}

// Prosty parser zgodny z RFC 4180: tak plik odczyta program, który zna standard
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 = ['Data', 'Autor', 'Tekst', 'Reakcje'];
const start = [
  ['2026-11-14 09:00', 'Anne Bonny', 'Na jutro: woda, rum i "suchary"\nreszta w ładowni', 2],
  ['2026-11-14 09:05', 'Jack Rackham', '=HYPERLINK("https://example.com";"Mapa skarbu")', 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">
        Rekordy odczytane parserem: <strong>{records.length}</strong> (nagłówek i {rows} wiadomości)
      </p>
      <ol className="mt-1 list-decimal pl-5 text-xs text-gray-700">
        {records.map((r, i) => (
          <li key={i}>{r.length} kom.: {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', 'Kapitan Redbeard', 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">Dopisz wiadomość (przecinek, cudzysłów, = na początku)</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">Dopisz</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">
            Eksportuj CSV
          </button>
        </div>
      </form>
      <div className="grid gap-3 md:grid-cols-2">
        <Records title='join(",") bez escapowania' csv={naiveCsv(header, rows)} rows={rows.length} />
        <Records title="toCsv z escapeCell" csv={toCsv(header, rows)} rows={rows.length} />
      </div>
    </div>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Które nagłówki odpowiedzi Route Handlera /c/[channel]/export sprawiają, że przeglądarka pobiera plik CSV zamiast go wyświetlić?

  2. 2. Jak escapeCell zapisuje tekst Na jutro: woda, rum i "suchary", żeby został w jednej komórce?

To 2 z 8 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Eksport danych do pliku CSV

  • Układanie w pionie

    Uporządkuj kroki pobierania pliku CSV zbudowanego w przeglądarce, bez serwera:

  • Układanie w poziomie

    Ułóż w jednej linii matcher hooka PostToolUse z pliku .claude/settings.json, który rusza po Edit i Write:

  1. PytanieQuiz: Nagłówki pobierania pliku
  2. PytanieQuiz: Przecinek i cudzysłów w komórce
  3. Zadanie z kodemPraktyka: Eksport raportu CSV
  4. Ułóż w kolejnościSortowanie: Pobieranie pliku CSV
  5. PytanieQuiz: PDF z widoku do druku
  6. PytanieQuiz: Wykres dla czytnika ekranu
  7. PytanieQuiz: Wstrzyknięcie formuły w CSV
  8. Ułóż w kolejnościSortowanie: Matcher hooka
  9. PytanieQuiz: Hook czy linia w CLAUDE.md
  10. PytanieQuiz: Kiedy działa Notification
  11. PytanieQuiz: Po co jq i file_path w hooku
  12. Projekt do wysłaniaWyślij Ship's Comms do mentora
  13. WideoPodsumowanie modułu

Przydatne artykuły