Kurs vibe coding z Claude Code · Moduł 5: Klon Reddita

Wywiad w porcie: wyszukiwarka z frazą w adresie

8 min czytania ·
W tej lekcji9

Wczoraj skończyłeś na czerwonym teście przekreśleń. Otwierasz terminal w folderze crew-council i wpisujesz claude -c: Claude Code otwiera ostatnią rozmowę z tego folderu, razem z poleceniem i wynikiem testu. Wystarczy napisać "Dokończ: dodaj remark-gfm, aż test przejdzie. Testów nie zmieniaj", przeczytać diff i zrobić commit. Dzisiejsze zadanie to już nowa funkcja, więc zaczynasz je od /clear. Dlaczego tak, a nie inaczej, zobaczysz w ostatniej lekcji tej lokacji.

Na Crew Council przybywa postów. Jack pamięta, że ktoś pisał o wraku ze złotem, ale nie pamięta ani tytułu, ani gildii. Przewijanie kilkuset postów to nie wywiad, to tortura. Potrzebna jest wyszukiwarka, która zadziała razem z gildiami i sortowaniem.

Problem: najpierw zapytaj, ile tego jest

Zanim padnie słowo o kodzie, odpowiedz na jedno pytanie: ile postów będzie przeszukiwać wyszukiwarka? Przy kilkuset wystarczy przejrzeć listę, którą Feed i tak trzyma w przeglądarce. Przy setkach tysięcy szukałaby baza danych na serwerze. Agent bez tej informacji zgaduje i często wybiera rozmach: nowy endpoint, bibliotekę do wyszukiwania pełnotekstowego albo bazę, o którą nie prosiłeś. Liczba w poleceniu oszczędza Ci tej przeprawy.

Druga decyzja: kiedy szukać. Fraza trafi do adresu jako ?q=, obok ?community= z lekcji 4_3, żeby link do wyników dało się wysłać kompanowi. Każda zmiana adresu to jednak prośba do serwera o stronę, co widziałeś w terminalu w lekcji 3_5. Tam pomagał debounce, czyli czekanie z wysłaniem, aż piszący zrobi przerwę. Tu prościej: szukasz po naciśnięciu Enter, więc na jedno wyszukiwanie przypada jedna prośba i debounce nie jest potrzebny. Next.js ma do tego komponent Form z next/form: formularz, który po wysłaniu dopisuje swoje pola do adresu i przechodzi pod niego bez przeładowania strony.

Polecenie dla Claude Code

Polecenie zbiera obie decyzje i od razu zamawia sprawdzian:

Polecenie dla Claude Code:

Dodaj wyszukiwarkę postów do Crew Council. Postów będzie kilkaset, więc
szukaj w przeglądarce, na liście, którą trzyma @components/Feed.tsx:
bez bazy danych, bez nowego endpointu i bez nowych paczek. Fraza trafia
do adresu jako ?q= obok ?community=, a pole wysyła ją Enterem przez Form
z next/form w components/SearchBar.tsx. Szukaj w tytule i treści, bez
względu na wielkość liter; przy kilku słowach post musi zawierać każde.
Najpierw testy funkcji searchPosts(posts, query) w lib/search.test.ts,
w tym fraza z nawiasem "(dwa". Uruchom je przed kodem i po nim.
Na koniec testy, lint i build, pokaż wynik.

Polecenie mówi, ile jest danych, gdzie leżą i czego nie dodawać. Nawias w teście nie jest przypadkowy, za chwilę zobaczysz dlaczego.

Co napisał Claude: test

Otwórz lib/search.test.ts. Na górze stoją trzy posty zbudowane pomocnikiem makePost: mapa na Wyspie Czaszki, rejs na Tortugę z wrakiem w treści i łatanie kadłuba z treścią "Dziura nad linią wody (dwa łokcie)". Dwa przypadki z sześciu:

it("kilka słów: post musi zawierać każde z nich", () => {
  expect(ids(searchPosts(list, "mapa czaszki"))).toEqual(["p1"]);
  expect(ids(searchPosts(list, "czaszki mapa"))).toEqual(["p1"]);
  expect(ids(searchPosts(list, "mapa kraken"))).toEqual([]);
});

it("znaki specjalne nie psują wyszukiwania", () => {
  expect(ids(searchPosts(list, "(dwa"))).toEqual(["p3"]);
});

ids zamienia wynik na listę samych id, więc porównanie mieści się w jednej linii. Pierwszy test mówi, że kolejność słów nie ma znaczenia, a słowo, którego nie ma w poście, odrzuca go. Pozostałe sprawdzają pustą frazę, wielkie litery, szukanie w treści i to, że lista wejściowa się nie zmienia. Na pustym szkielecie cztery z sześciu testów padają, i dobrze.

Najprostsza wersja nie wystarcza

Agenci często sięgają po wyrażenie regularne, czyli wzorzec do wyszukiwania w tekście, w którym niektóre znaki mają specjalne znaczenie. Sprawdziliśmy taką wersję:

const pattern = new RegExp(query.trim().split(/\s+/).join(".*"), "i");
return posts.filter((post) => pattern.test(`${post.title} ${post.content}`));

Słowa sklejone przez .* znaczą "to słowo, coś, potem tamto", a flaga i wyłącza wielkość liter. Wynik testów:

     × kilka słów: post musi zawierać każde z nich
     × znaki specjalne nie psują wyszukiwania

SyntaxError: Invalid regular expression: /(dwa/i: Unterminated group

      Tests  2 failed | 29 passed (31)

Nawias we wzorcu otwiera grupę, której nikt nie zamknął, więc funkcja rzuca błąd. Na stronie oznaczałoby to biały ekran po wpisaniu nawiasu, a frazy "czaszki mapa" wzorzec nie znajdzie, bo pilnuje kolejności. Na ekranie z przykładowymi danymi wszystko wyglądało dobrze, test pokazał oba błędy.

Co napisał Claude: searchPosts

Wersja, która przechodzi, w ogóle nie używa wzorców:

export function searchPosts(posts: Post[], query: string): Post[] {
  const words = query.toLocaleLowerCase("pl").split(/\s+/).filter(Boolean);
  if (words.length === 0) {
    return posts;
  }
  return posts.filter((post) => {
    const text = `${post.title} ${post.content}`.toLocaleLowerCase("pl");
    return words.every((word) => text.includes(word));
  });
}

toLocaleLowerCase("pl") zamienia wielkie litery na małe według zasad polskiego, więc "Skarb" i "skarb" trafiają tak samo. split(/\s+/) tnie frazę na słowa w miejscach spacji, a filter(Boolean) wyrzuca puste kawałki, więc fraza z samych spacji działa jak pusta. every zwraca true, gdy warunek spełnia każde słowo, a includes szuka zwykłego tekstu, w którym nawias to po prostu nawias. Pusta fraza zwraca tę samą listę, a filter zawsze buduje nową, więc stan nie zmienia się po cichu. Wynik: Tests 31 passed (31).

Co napisał Claude: fraza w adresie

app/page.tsx czyta frazę tak jak gildię w lekcji 4_3 i przekazuje ją dalej:

const { community, q } = await searchParams;
const query = typeof q === "string" ? q : "";

Pod nagłówkiem stoi <SearchBar query={query} community={selected?.id ?? null} />, a Feed dostaje nowy prop query. Otwórz components/SearchBar.tsx; poniżej jego środek bez klas Tailwinda i tekstu podpowiedzi:

<Form action="/" role="search">
  {community && <input type="hidden" name="community" value={community} />}
  <input key={query} name="q" type="search" defaultValue={query} aria-label="Szukaj postów" />
  <button type="submit">Szukaj</button>
</Form>

Po Enterze Form składa adres z atrybutów name pól, na przykład /?community=pirate-life&q=wrak, i przechodzi pod niego bez przeładowania. Ukryte pole community sprawia, że szukasz w otwartej gildii. role="search" mówi czytnikowi ekranu, że to wyszukiwarka. Nie ma tu stanu ani "use client", więc pasek zostaje Server Componentem. Po co key, zobaczysz w przeglądzie.

W components/Feed.tsx przybyła jedna linia przed sortowaniem:

const found = searchPosts(filtered, query);
const visiblePosts = sortPosts(found, sortMode);

Najpierw filtr gildii z lekcji 4_3, potem fraza, na końcu sortowanie tego, co zostało. Oba filtry tylko zawężają listę, a stan posts się nie zmienia, więc głosy i nowe posty przetrwają każde wyszukiwanie. Gdy nic nie pasuje, Feed pisze "Żaden post nie pasuje do frazy" zamiast zostawiać pustą stronę.

useMemo na zapas

Claude lubi owinąć taki filtr w useMemo, hook, który zapamiętuje wynik obliczenia między renderami i liczy go od nowa tylko po zmianie wartości z listy zależności. Dokumentacja Reacta mówi, że obliczenie zwykle nie jest kosztowne, dopóki nie tworzysz albo nie przeglądasz tysięcy obiektów, i radzi zmierzyć je przez console.time. Zasada z lekcji 3_5 obowiązuje dalej: najpierw pomiar, potem useMemo. Gdy spotkasz useMemo w cudzym kodzie, wiesz już, co robi.

Przegląd kapitana

  1. Filtr na serwerze. To typowy błąd agenta: searchPosts w app/page.tsx i przefiltrowana lista podana do Feed jako initialPosts. Sprawdziliśmy go. Po Enterze adres się zmienia, a na liście dalej są wszystkie posty; dopiero odświeżenie strony pokazuje wynik. useState(initialPosts) bierze wartość startową tylko przy pierwszym renderze, jak Gallery w lekcji 3_5. Do tego nowe posty z formularza nigdy nie trafiłyby do wyników. W diffie searchPosts ma stać w Feed.
  2. Pole po zmianie gildii. Wyszukaj "mapa" i kliknij Wszystkie. Lista pokazuje wszystkie posty, a pole ma być puste. Bez key={query} zostaje w nim "mapa": pole, w którym ktoś pisał, trzyma wpisany tekst, nawet gdy zmieni się jego defaultValue. Sprawdziliśmy to. Nowy klucz każe Reactowi narysować pole od nowa, z frazą z adresu.
  3. Litery i nawiasy. Wpisz "MAPA", a potem "kraken (". Pierwsza fraza znajduje mapę, druga pokazuje komunikat o braku wyników, bez białego ekranu.
  4. Gildia, fraza i stan. Zagłosuj na post o Tortudze i dodaj w r/PirateLife post "Kto płynie po wrak?". Potem wejdź do r/PirateLife i wyszukaj "wrak". Adres to /?community=pirate-life&q=wrak, głos i nowy post są na miejscu, a przycisk Wstecz wraca do poprzedniego wyniku.

Następny krok

Gdy wszystko przejdzie, poproś o commit, na przykład "Wyszukiwarka: searchPosts z testami, fraza w adresie". Potem kolejny mały krok:

Wyszukiwanie ma działać bez polskich znaków: "kadlub smola" znajduje
"Jak załatać kadłub smołą?". Najpierw test w @lib/search.test.ts,
uruchom go przed kodem i po nim. Testów nie zmieniaj.

Pierwszy pomysł Claude to rozbicie liter z ogonkami na literę i znak przez normalize("NFD") i usunięcie znaków. Test i tak padnie: expected [] to deeply equal [ 'p3' ]. Litera ł nie rozkłada się na l i kreskę, więc "smoła" nie staje się "smola". Poprawka to jeszcze jedna zamiana, .replace(/ł/g, "l"), a test wyłapał ją, zanim zauważył to pierwszy pirat. Gdy zechcesz podświetlać znalezione słowa, każ Claude dzielić tekst na kawałki i owijać trafienia w element <mark> w JSX, a nie składać HTML dla dangerouslySetInnerHTML. W edytorze poniżej czeka wyszukiwarka z gildiami, sortowaniem i małym sprawdzianem searchPosts: wpisz frazę z nawiasem i obserwuj adres nad listą.

Pamiętaj: wywiad w porcie zaczynasz od pytania, ilu ludzi przesłuchać, a fraza zapisana w adresie to notatka, którą każdy kompan odczyta z tego samego miejsca.

Kod do tej lekcji: App.jsx
// Wywiad w porcie: wyszukiwarka z gildią i sortowaniem, fraza wysyłana Enterem
import { useState } from 'react';

const posts = [
  { id: 'p1', community: 'pirate-life', title: 'Płyniemy na Tortugę czy na północ?', content: 'Na północy leży wrak z ładownią złota.', score: 90 },
  { id: 'p2', community: 'treasure-hunting', title: 'Mapa z krzyżykiem na Wyspie Czaszki', content: 'Znalazłem ją w butelce.', score: 90 },
  { id: 'p3', community: 'ship-building', title: 'Jak załatać kadłub smołą?', content: 'Dziura nad linią wody (dwa łokcie).', score: 38 },
  { id: 'p4', community: 'sea-battles', title: 'Kraken zatopił nam szalupę', content: 'Omijajcie Zatokę Mgieł.', score: 45 },
  { id: 'p5', community: 'treasure-hunting', title: 'Druga mapa do tego samego wraku?', content: 'Ktoś sprzedaje ją w porcie.', score: 12 },
];

const communities = ['treasure-hunting', 'sea-battles', 'pirate-life', 'ship-building'];

// Ta sama funkcja co lib/search.ts: zwykły tekst zamiast wzorca, każde słowo musi wystąpić
function searchPosts(list, query) {
  const words = query.toLocaleLowerCase('pl').split(/\s+/).filter(Boolean);
  if (words.length === 0) return list;
  return list.filter((post) => {
    const text = `${post.title} ${post.content}`.toLocaleLowerCase('pl');
    return words.every((word) => text.includes(word));
  });
}

const ids = (list) => list.map((post) => post.id).join(',');
const checks = [
  { name: 'pusta fraza zwraca wszystko', ok: ids(searchPosts(posts, '   ')) === ids(posts) },
  { name: 'wielkie litery: MAPA', ok: ids(searchPosts(posts, 'MAPA')) === 'p2,p5' },
  { name: 'szukanie w treści: butelce', ok: ids(searchPosts(posts, 'butelce')) === 'p2' },
  { name: 'kolejność słów: wraku druga', ok: ids(searchPosts(posts, 'wraku druga')) === 'p5' },
  { name: 'nawias: (dwa', ok: ids(searchPosts(posts, '(dwa')) === 'p3' },
];

export default function App() {
  const [community, setCommunity] = useState('');
  const [query, setQuery] = useState('');
  const [sortMode, setSortMode] = useState('top');

  // W projekcie fraza i gildia żyją w adresie; tu pokazujemy, jak by wyglądał
  const params = new URLSearchParams();
  if (community) params.set('community', community);
  if (query) params.set('q', query);
  const address = '/' + (params.toString() ? '?' + params.toString() : '');

  // Najpierw gildia, potem fraza, na końcu sortowanie kopii
  const inCommunity = community ? posts.filter((post) => post.community === community) : posts;
  const found = searchPosts(inCommunity, query);
  const visible = [...found].sort((a, b) => (sortMode === 'top' ? b.score - a.score : a.title.localeCompare(b.title, 'pl')));

  const handleSubmit = (event) => {
    event.preventDefault();
    setQuery(new FormData(event.currentTarget).get('q'));
  };

  return (
    <div className="min-h-screen bg-gray-100 p-4 text-gray-900">
      <div className="mx-auto max-w-2xl space-y-3">
        <h1 className="text-2xl font-bold">Crew Council: wyszukiwarka</h1>
        <form onSubmit={handleSubmit} role="search" className="flex gap-2">
          <input key={query} name="q" type="search" defaultValue={query} aria-label="Szukaj postów" placeholder="Szukaj w tytułach i treści, Enter wysyła" className="flex-1 rounded border border-gray-300 bg-white p-2" />
          <button type="submit" className="rounded bg-gray-900 px-4 text-white">Szukaj</button>
        </form>
        <div className="flex flex-wrap gap-2">
          <select value={community} onChange={(event) => setCommunity(event.target.value)} aria-label="Gildia" className="rounded border border-gray-300 bg-white p-1">
            <option value="">Wszystkie gildie</option>
            {communities.map((id) => <option key={id} value={id}>{id}</option>)}
          </select>
          {['top', 'a-z'].map((mode) => (
            <button key={mode} type="button" onClick={() => setSortMode(mode)} aria-pressed={sortMode === mode} className={sortMode === mode ? 'rounded bg-orange-600 px-3 py-1 text-white' : 'rounded px-3 py-1 hover:bg-gray-200'}>
              {mode}
            </button>
          ))}
        </div>
        <p className="font-mono text-sm text-gray-600">Adres: {address}</p>
        {visible.length === 0 && <p className="text-gray-500">Żaden post nie pasuje do frazy: {query}</p>}
        {visible.map((post) => (
          <article key={post.id} className="rounded-lg border border-gray-200 bg-white p-3">
            <p className="text-xs text-gray-500">r/{post.community} · score {post.score}</p>
            <h2 className="font-semibold">{post.title}</h2>
            <p className="text-sm text-gray-700">{post.content}</p>
          </article>
        ))}
        <section className="rounded-lg bg-white p-3 text-sm">
          <h2 className="mb-2 font-bold">Sprawdzian searchPosts</h2>
          <ul className="space-y-1">
            {checks.map((check) => (
              <li key={check.name} className={check.ok ? 'text-green-700' : 'font-semibold text-red-700'}>
                {check.ok ? 'ZALICZONY' : 'NIEZALICZONY'}: {check.name}
              </li>
            ))}
          </ul>
          <p className="mt-2 text-gray-600">Zamień includes na wyrażenie regularne i wpisz nawias: zobacz, co się stanie.</p>
        </section>
      </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. Co zwróci searchPosts z lekcji dla frazy "czaszki mapa", gdy jeden z postów ma tytuł "Mapa z krzyżykiem na Wyspie Czaszki"?

  2. 2. Kiedy według lekcji warto owinąć filtrowanie postów w useMemo?

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

Zadania praktyczne w grze

  • Edytor kodu

    Search and filter posts

  • Układanie w pionie

    Uporządkuj, co dzieje się po wpisaniu "wrak" w r/PirateLife i naciśnięciu Enter:

  • Układanie w pionie

    Dodajesz przekreślenia przez remark-gfm. Uporządkuj kroki pętli z testem, od prośby do commita:

  1. PytanieQuiz: Kilka słów w searchPosts
  2. Zadanie z kodemPraktyka: Search & filter
  3. PytanieQuiz: Kiedy useMemo przy filtrowaniu
  4. Ułóż w kolejnościSortowanie: Droga frazy wyszukiwania
  5. PytanieQuiz: Gdzie filtrować wyszukiwanie
  6. PytanieQuiz: key na polu wyszukiwania
  7. Ułóż w kolejnościSortowanie: Najpierw test, potem commit
  8. PytanieQuiz: Co jest dowodem
  9. PytanieQuiz: Zmieniona wartość w teście

Przydatne artykuły