Kurs vibe coding z Claude Code · Moduł 5: Klon Reddita
Rejestr gildii: społeczności i filtr w adresie
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
- Druga lista w stanie. To typowy błąd agenta:
filteredPostsw osobnymuseState, uzupełniane po kliknięciu gildii. Nowy post trafia doposts, ale nie dofilteredPosts, więc znika z widoku do następnego kliknięcia. Gdy agent synchronizuje kopię efektem,npm run lintzatrzymuje 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 effectLekarstwo nie polega na wyciszeniu reguły, tylko na usunięciu kopii: lista do pokazania to wynik filter przy każdym renderze.
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 zundefined.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.
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. Czym jest community (subreddit)?
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):
Zadania po tej lekcji
- PytanieQuiz: Communities
- PytanieQuiz: Filtrowanie po community
- Kliknij w kolejnościSekwencja: Filtr community
- Zadanie z kodemPraktyka: Community list
- Ułóż w kolejnościSortowanie: Porównanie community
- PytanieQuiz: formatMembers
- Zadanie z kodemPraktyka: Community header
- Ułóż w kolejnościSortowanie: Droga nowego posta
- PytanieQuiz: Gdzie mieszka stan Dołącz
- Ułóż w kolejnościSortowanie: Blokada przycisku Opublikuj
- PytanieQuiz: Walidacja formularza posta
- Zadanie z kodemPraktyka: Create post form
- Ułóż w kolejnościSortowanie: Communities po liczbie członków
- PytanieQuiz: All Communities
- Kliknij w kolejnościSekwencja: formatMembers milion
- Ułóż w kolejnościSortowanie: Nazwa community
- Ułóż w kolejnościSortowanie: Nieznana gildia w adresie
- PytanieQuiz: Reguły community
- Kliknij w kolejnościSekwencja: Znajdź wybraną społeczność
- Ułóż w kolejnościSortowanie: Limit znaków tytułu