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

Rejestr gildii: społeczności i filtr w adresie

8 min czytania ·
W tej lekcji10

Crew Council rośnie i na jednej liście mieszają się mapy skarbów, porady o łataniu kadłuba i opowieści z bitew. Kto szuka tylko map, przekopuje całą rzekę postów. Reddit dzieli treści na społeczności, czyli subreddity, a my nazwiemy je gildiami: każda ma temat, opis, reguły i swoich członków. W tej lekcji Claude Code najpierw zaplanuje podział, a Ty sprawdzisz w planie i w przeglądarce, czy gildia to filtr, a nie druga księga.

Problem: jedna księga, wiele okien

Najważniejsza decyzja zapada przed kodem. Gildia nie ma własnej listy postów. Każdy post ma pole community z id gildii, a widok gildii to ta sama lista oglądana przez filtr. Gdyby gildie miały osobne kopie, nowy post trafiałby do jednej z nich, a głos oddany w jednej kopii nie istniałby w drugiej.

Druga decyzja: gdzie trzymać wybraną gildię. Mogłaby żyć w useState, ale wtedy znika po odświeżeniu i nie da się wysłać linku do gildii kompanowi. Dlatego trafi do adresu jako parametr wyszukiwania, który znasz z lekcji 3_5: /?community=sea-battles. Link da się wysłać, odświeżenie pamięta wybór, a przycisk Wstecz wraca do poprzedniej gildii.

Polecenie dla Claude Code: najpierw plan

Zmiana dotyka kilku plików i zostawia wybory, więc zaczynasz od trybu planowania z lekcji 0_4:

Polecenie dla Claude Code:

/plan Podziel posty Crew Council na społeczności. W lib/communities.ts
typ Community (id, name, displayName, description, members, rules)
i cztery gildie: treasure-hunting, sea-battles, pirate-life,
ship-building. Wybrana gildia żyje w adresie jako ?community=,
a @app/page.tsx czyta ją z searchParams; nieznane id daje 404. Pasek
boczny z linkami: Wszystkie i cztery gildie z liczbą członków skrótem
(12.5K). Nad postami nagłówek gildii z opisem, regułami i przyciskiem
Dołącz. Formularz nowego posta z wyborem gildii, tytułem do 300 znaków
i treścią. Przefiltrowanej listy nie trzymaj w osobnym stanie, wyliczaj
ją z postów. Każdy krok kończ testami, lintem i buildem.

W planie szukasz trzech rzeczy. Czy przefiltrowana lista jest wyliczana, a nie trzymana w drugim useState. Czy stan postów zostaje w Feed z lekcji 4_1, a nie przenosi się do nowego komponentu. Czy nie ma nowych paczek. Plan, który przechodzi, akceptujesz przez Yes, manually approve edits i czytasz każdą edycję.

Co napisał Claude: dane gildii

Otwórz lib/communities.ts. Typ Community opisuje jedną gildię:

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

Każde pole ma swojego odbiorcę. id, na przykład treasure-hunting, czyta program: stoi w adresie i w polu community posta. name to nazwa z przedrostkiem, r/TreasureHunting, a displayName to czytelny tytuł nagłówka. members to liczba członków, a rules to tablica reguł gildii. Liczbę członków pokazuje skrótem funkcja z tego samego pliku:

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

Od tysiąca dzieli przez 1000, toFixed(1) zostawia jedną cyfrę po kropce i dopisuje K, więc 12460 członków r/TreasureHunting to 12.5K, a 25670 członków r/PirateLife to 25.7K. Od miliona działa tak samo z literą M. Małe liczby wracają bez zmian.

Co napisał Claude: adres jako źródło prawdy

Otwórz app/page.tsx. Strona czyta gildię z adresu tak jak wyszukiwarka z lekcji 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" odrzuca brak parametru i listę z adresu w rodzaju ?community=a&community=b. find zwraca pierwszą gildię o pasującym id albo undefined, które ?? null zamienia na null, czyli "wszystkie gildie". Adres z nieznanym id, na przykład /?community=kraken, kończy się stroną 404 zamiast pustej listy, która udawałaby, że gildia istnieje. Poniżej strona składa pasek boczny i Feed, a obu przekazuje wybraną gildię.

Pasek boczny: linki zamiast przycisków

components/CommunitySidebar.tsx nie ma stanu, więc zostaje Server Componentem. Każda gildia to link:

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

href jako obiekt składa adres sam i koduje znaki specjalne, więc nie sklejasz tekstu ręcznie. aria-current="page" mówi czytnikowi ekranu, która gildia jest otwarta, a active i idle to dwa zestawy klas z góry pliku: wybrana gildia ma szare tło i pogrubienie. Pierwszy link, Wszystkie, prowadzi po prostu do /. Link z next/link przechodzi między gildiami bez przeładowania strony, jak w lekcji 2_1.

Filtr w Feed

Otwórz components/Feed.tsx. Doszedł prop community z wybraną gildią albo null, a lista do pokazania wylicza się z postów:

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

filter zostawia posty, których community zgadza się z wybraną gildią. Gdy gildii nie wybrano, selectedCommunity ma wartość null i przechodzą wszystkie posty. Sortowanie z lekcji 4_1 działa na przefiltrowanej liście. Stan postów nie zmienił się wcale: przejście do innej gildii zmienia tylko adres, a Feed zostaje na swoim miejscu na stronie, więc głosy i nowe posty przetrwają spacer między gildiami.

Nagłówek i przycisk Dołącz

Nad postami stoi CommunityHeader z banerem, pierwszą literą nazwy w kółku jako ikoną, opisem, liczbą członków i regułami. Przycisk Dołącz zmienia napis na Dołączono. Gdzie trzymać tę informację? Gdyby nagłówek miał własny useState, React zachowałby ten stan przy przejściu z jednej gildii do drugiej, bo to ten sam komponent w tym samym miejscu, i r/SeaBattles pokazałoby "Dołączono" po kliknięciu w r/TreasureHunting. Dlatego listę gildii, do których dołączyłeś, trzyma Feed:

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

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

includes sprawdza, czy id jest już na liście. Jest, to filter buduje listę bez niego; nie ma, to spread dopisuje go na końcu. Nagłówek dostaje isJoined={joined.includes(community.id)} i funkcję onToggleJoin, a sam niczego nie pamięta.

Formularz nowego posta

components/CreatePostForm.tsx to formularz kontrolowany z lekcji 2_3 z polami gildii, tytułu i treści. Przycisk wysyłki pilnuje dwóch warunków:

<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"
>
  Opublikuj
</button>

Bez wybranej gildii albo z pustym tytułem przycisk jest zablokowany. Pole tytułu ma maxLength={300}, więc przeglądarka nie przyjmie dłuższego tekstu. Wysłany formularz woła addPost w Feed, a ta dopisuje post na początek listy z jednym głosem za od autora, userVote: "up". Formularz zaczyna od gildii z adresu, a w Feed ma key={selectedCommunity ?? "all"}: nowy klucz po zmianie gildii każe Reactowi zacząć formularz od nowa, z nową gildią w polu wyboru.

Przegląd kapitana

  1. Druga lista w stanie. To typowy błąd agenta: filteredPosts w osobnym useState, uzupełniane po kliknięciu gildii. Nowy post trafia do posts, ale nie do filteredPosts, więc znika z widoku do następnego kliknięcia. Gdy agent synchronizuje kopię efektem, npm run lint zatrzymuje go regułą 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

Lekarstwo nie polega na wyciszeniu reguły, tylko na usunięciu kopii: lista do pokazania to wynik filter przy każdym renderze.

  1. Nieznana gildia. Wpisz /?community=kraken. Ma być strona 404, a nie biały ekran z błędem. Agent lubi pisać communities.find(...)!; wykrzyknik każe TypeScriptowi uwierzyć, że gildia się znajdzie, a przy złym adresie strona pada na odczycie pola z undefined.

  2. Spacer między gildiami. Daj głos postowi, wejdź do jego gildii, dodaj tam post i wróć do Wszystkie. Głos i nowy post mają zostać. Dołącz do r/TreasureHunting i przejdź do r/SeaBattles: tam przycisk ma mówić Dołącz.

  3. Sprawdzian w przeglądarce. Ten spacer możesz zlecić przez Claude in Chrome z lekcji 3_8: "Otwórz localhost:3000, wejdź do r/TreasureHunting, dodaj post, kliknij Wszystkie, cofnij się przyciskiem Wstecz i powiedz, co widzisz w liście i w konsoli". To ta sama pętla co z testami: sprawdzian, który daje odpowiedź, zamiast zapewnienia agenta.

Następny krok

Gdy przegląd przejdzie, poproś o commit, na przykład "Społeczności: filtr w adresie, nagłówek i formularz posta". Potem test dla formatMembers, bo to czysta funkcja z liczbami na wejściu i tekstem na wyjściu:

Napisz testy formatMembers w lib/communities.test.ts: 950 daje "950",
12460 daje "12.5K", 999950 daje "1.0M". Uruchom je przed zmianami
w kodzie i pokaż wynik.

Ostatni przypadek nie przejdzie: Vitest zgłosi expected '1000.0K' to be '1.0M', bo 999 950 to jeszcze nie milion, a po zaokrągleniu tysięcy wychodzi 1000.0. Każ Claude poprawić funkcję, nie test, i przeczytaj poprawkę w diffie. Przed następną lekcją wpisz /clear: nowa funkcja to nowa rozmowa, a stara zostaje do wznowienia. W edytorze poniżej czeka rejestr gildii; adresu tam nie ma, więc wybór trzyma useState, a w projekcie trzyma go adres. Dołącz do gildii, dodaj post i przełączaj filtr.

Pamiętaj: gildia to ten sam rejestr postów oglądany przez inne okno, a adres strony mówi, które okno jest otwarte.

Kod do tej lekcji: App.jsx
// Rejestr gildii: społeczność to filtr na tej samej liście postów.
// W edytorze nie ma paska adresu, więc wybór trzyma useState;
// w projekcie Crew Council trzyma go adres (?community=).
import { useState } from 'react';

const communities = [
  { id: 'treasure-hunting', name: 'r/TreasureHunting', displayName: 'Treasure Hunting', description: 'Mapy, odkrycia i skarby ze wszystkich mórz.', members: 12460, rules: ['Dziel się prawdziwymi znaleziskami', 'Nie zdradzaj miejsc trwających wypraw'] },
  { id: 'sea-battles', name: 'r/SeaBattles', displayName: 'Sea Battles', description: 'Bitwy morskie, strategie i taktyki.', members: 8920, rules: ['Opisuj bitwy ze szczegółami', 'Szanuj przeciwnika'] },
  { id: 'pirate-life', name: 'r/PirateLife', displayName: 'Pirate Life', description: 'Codzienne życie na pokładzie.', members: 25670, rules: ['Bądź sobą', 'Szanuj kodeks piracki'] },
  { id: 'ship-building', name: 'r/ShipBuilding', displayName: 'Ship Building', description: 'Budowa i naprawa okrętów.', members: 5430, rules: ['Pokazuj plany i szkice', 'Pomagaj początkującym'] },
];

const startPosts = [
  { id: 'p1', community: 'pirate-life', title: 'Płyniemy na Tortugę czy na północ?' },
  { id: 'p2', community: 'treasure-hunting', title: 'Mapa z krzyżykiem na Wyspie Czaszki' },
  { id: 'p3', community: 'ship-building', title: 'Jak załatać kadłub smołą?' },
  { id: 'p4', community: 'sea-battles', title: 'Kraken zatopił nam szalupę' },
];

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)} członków</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 ? 'Dołączono' : 'Dołącz'}
        </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="Społeczność" className="w-full rounded border border-gray-300 p-2">
        <option value="">Wybierz społeczność</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="Tytuł" aria-label="Tytuł posta" 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">
        Opublikuj
      </button>
    </form>
  );
}

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

  // Lista do pokazania: wyliczona przy każdym renderze, bez drugiego stanu
  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="Społeczności" 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)}>
            Wszystkie
          </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)} członków</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">Ta gildia nie ma jeszcze postów.</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>
  );
}

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. Czym jest community (subreddit)?

  2. 2. Jak filtruje się posty należące do wybranego community?

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

Zadania praktyczne w grze

  • Klikanie w kolejności

    Zbuduj filtr postów według community, klikając tokeny w kolejności:

  • Edytor kodu

    Communities sidebar

  • Układanie w poziomie

    Ułóż warunek porównujący community posta z wybranym (jedna linia, od lewej do prawej):

  • Edytor kodu

    Community header

  • Układanie w pionie

    Uporządkuj, co dzieje się po kliknięciu Opublikuj w formularzu w r/TreasureHunting:

  • Układanie w poziomie

    Ułóż atrybut, który blokuje przycisk Opublikuj bez gildii albo bez tytułu (jedna linia, od lewej do prawej):

  • Edytor kodu

    Create post in community

  • Układanie w pionie

    Uporządkuj społeczności od największej do najmniejszej liczby członków (PirateLife 25670, TreasureHunting 12460, SeaBattles 8920, ShipBuilding 5430):

  • Klikanie w kolejności

    Zbuduj wyrażenie formatujące miliony członków, klikając tokeny w kolejności:

  • Układanie w poziomie

    Ułóż zapis nazwy community (jedna linia, od lewej do prawej):

  • Układanie w pionie

    Uporządkuj, co robi strona główna z lekcji po wejściu na adres /?community=kraken:

  • Klikanie w kolejności

    Zbuduj wyszukanie gildii o id odczytanym z adresu, klikając tokeny w kolejności:

  • Układanie w poziomie

    Ułóż atrybut limitu znaków pola input tytułu (jedna linia, od lewej do prawej):

  1. PytanieQuiz: Communities
  2. PytanieQuiz: Filtrowanie po community
  3. Kliknij w kolejnościSekwencja: Filtr community
  4. Zadanie z kodemPraktyka: Community list
  5. Ułóż w kolejnościSortowanie: Porównanie community
  6. PytanieQuiz: formatMembers
  7. Zadanie z kodemPraktyka: Community header
  8. Ułóż w kolejnościSortowanie: Droga nowego posta
  9. PytanieQuiz: Gdzie mieszka stan Dołącz
  10. Ułóż w kolejnościSortowanie: Blokada przycisku Opublikuj
  11. PytanieQuiz: Walidacja formularza posta
  12. Zadanie z kodemPraktyka: Create post form
  13. Ułóż w kolejnościSortowanie: Communities po liczbie członków
  14. PytanieQuiz: All Communities
  15. Kliknij w kolejnościSekwencja: formatMembers milion
  16. Ułóż w kolejnościSortowanie: Nazwa community
  17. Ułóż w kolejnościSortowanie: Nieznana gildia w adresie
  18. PytanieQuiz: Reguły community
  19. Kliknij w kolejnościSekwencja: Znajdź wybraną społeczność
  20. Ułóż w kolejnościSortowanie: Limit znaków tytułu

Przydatne artykuły