Kurs vibe coding z Claude Code · Moduł 7: Klon LinkedIna

Tablica ofert: filtry w adresie i jeden model oferty

6 min czytania
W tej lekcji6

Ogłoszeń w Crew Connections przybywa. Pirat z Tortugi chce zobaczyć tylko kontrakty w swoim porcie, a potem wysłać link koledze z załogi, żeby ten zobaczył tę samą listę. Filtry trzymane w stanie komponentu znikną po odświeżeniu i nie da się ich nikomu przekazać. Dlatego filtr będzie częścią adresu: /jobs?type=contract&location=Tortuga. W lekcji 6_3 zrobiłeś tak z jedną frazą w sieci kontaktów, tu dochodzą dwie listy wyboru.

Druga sprawa to porządek na pokładzie. Oferta ma już swój typ JobPost z lekcji 6_2, kartę JobCard i listę rodzajów umowy jobTypes. Tablica ma z nich korzystać, a nie budować wszystkiego od nowa.

Polecenie dla Claude Code:

Dodaj filtry do strony /jobs: rodzaj umowy (type), port (location)
i fraza (q) w tytule, statku lub opisie, wszystkie w adresie, np.
/jobs?type=contract&location=Tortuga. Użyj typu JobPost, listy
jobTypes i komponentu JobCard, nie twórz nowego modelu oferty.
Filtrowanie jako czyste funkcje w lib/job-filters.ts: parseJobFilters
(nieznany type z adresu = brak filtra) i filterJobs, bez rozróżniania
wielkości liter; najpierw testy. Formularz przez next/form. Dodaj do
danych startowych trzy oferty, żeby było co filtrować. Na koniec
testy, lint, typy i build.

Zanim zaakceptujesz plan, sprawdź jedną rzecz: czy Claude nie zakłada nowego interfejsu Job obok JobPost. To częsty błąd agenta, który dostaje zadanie "tablica ofert" i zaczyna od zera. Dwa modele tej samej oferty szybko się rozjeżdżają, na przykład jeden zna trzy rodzaje umowy, a drugi cztery, i nikt nie wie, który jest prawdziwy.

Co napisał Claude: filtry z adresu

Otwórz w Cursorze lib/job-filters.ts. Typ JobFilters ma opcjonalny type (wartość z JobType) oraz teksty location i q. SearchParams to kształt parametrów adresu w Next.js: każda wartość jest tekstem, tablicą tekstów (gdy parametr się powtarza) albo jej brak. Pierwsza funkcja tłumaczy adres na filtry z pomocą dwóch małych pomocników z tego samego pliku:

export function parseJobFilters(params: SearchParams): JobFilters {
  return {
    type: isJobType(params.type) ? params.type : undefined,
    location: text(params.location),
    q: text(params.q),
  };
}

isJobType sprawdza wartość z tą samą tablicą jobTypes, której używa schemat Zod z lekcji 6_2, więc lista rodzajów umowy wciąż żyje w jednym miejscu. text zwraca obcięty tekst albo pusty napis, gdy parametru brak lub się powtarza. Adres to dane od użytkownika: ktoś może wpisać ?type=pirat-na-pół-etatu i strona nie może się od tego wywrócić ani pokazać pustej listy. Nieznana wartość znaczy po prostu "bez filtra".

Co napisał Claude: wynik liczony z pełnej listy

Druga funkcja, w tym samym pliku, zwraca oferty pasujące do wszystkich ustawionych filtrów naraz:

const lower = (value: string) => value.toLocaleLowerCase("pl-PL");

export function filterJobs(jobs: JobPost[], filters: JobFilters): JobPost[] {
  const phrase = lower(filters.q);
  return jobs.filter(
    (job) =>
      (!filters.type || job.type === filters.type) &&
      (!filters.location || lower(job.location) === lower(filters.location)) &&
      (!phrase || lower(`${job.title} ${job.company} ${job.description}`).includes(phrase)),
  );
}

Każda linia to jeden filtr, a pusty filtr przepuszcza wszystko. filter tworzy nową tablicę, więc pełna lista się nie zmienia, a wynik liczysz za każdym razem od nowa. Nie ma osobnego stanu z przefiltrowanymi ofertami ani useEffect, który by go synchronizował: jedna prawda, z której wszystko wynika. toLocaleLowerCase("pl-PL") zamienia też "Ł" na "ł", jak w wyszukiwarce kontaktów. Testy w lib/job-filters.test.ts sprawdzają takie przypadki:

it("łączy filtry: kontrakty w Tortudze", () => {
  expect(ids(filterJobs(jobs, parseJobFilters({ type: "contract", location: "tortuga" })))).toEqual(["j3"]);
});

jobs to trzy oferty testowe, a ids zamienia wynik na listę identyfikatorów, żeby porównanie było krótkie. Obok stoją testy nieznanego rodzaju umowy, frazy "ŁABĘDŹ", która znajduje statek "Łabędź", i pełnej listy, która po filtrowaniu wciąż ma trzy oferty.

Co napisał Claude: strona czyta adres

Otwórz app/jobs/page.tsx. To Server Component, więc filtruje na serwerze, a przeglądarka dostaje gotową listę:

export default async function JobsPage({ searchParams }: PageProps<"/jobs">) {
  const filters = parseJobFilters(await searchParams);
  const allJobs = await getJobs();
  const jobs = filterJobs(allJobs, filters);
  const locations = [...new Set(allJobs.map((job) => job.location))].toSorted((a, b) => a.localeCompare(b, "pl"));
  // niżej: <JobFilters filters={filters} locations={locations} />, licznik i karty
}

searchParams w Next.js 16 to obietnica, więc strona czeka na nią przez await, jak w lekcjach 4_5 i 6_3. Lista portów powstaje z ofert, a Set usuwa powtórzenia. Niżej strona pokazuje "Znalezione oferty: 1 z 5" i rysuje każdą ofertę tym samym JobCard co w lekcji 6_2. Zajrzyj do wyniku npm run build: przed tą lekcją /jobs miało znak ○, bo build wyrenderował listę raz, a teraz ma ƒ, bo strona czyta adres każdego żądania.

Co napisał Claude: formularz, który zmienia adres

Filtry rysuje components/jobs/JobFilters.tsx. Zamiast zwykłego <form> stoi tu komponent Form z next/form, który przy wysłaniu zamienia pola na parametry adresu (klasy i etykiety pominięte):

<Form action="/jobs">
  <input key={filters.q} id="q" name="q" defaultValue={filters.q} />
  <select key={filters.location} id="location" name="location" defaultValue={filters.location}>
    <option value="">Wszystkie porty</option>
    {/* porty z ofert */}
  </select>
  {/* rodzaj umowy: ten sam wzór, opcje z jobTypes i etykiety z lib/job-labels.ts */}
  <button>Filtruj</button>
</Form>

Po kliknięciu Filtruj Form przechodzi na nowy adres bez pełnego przeładowania strony. U nas po wybraniu Tortugi i kontraktu adres wyglądał tak: /jobs?q=&location=Tortuga&type=contract. Puste pole też trafia do adresu, a parseJobFilters traktuje je jak brak filtra. Obok przycisku stoi zwykły <Link href="/jobs"> z napisem "Wyczyść filtry". Przycisk Wstecz w przeglądarce wraca do poprzedniego filtra, bo każdy filtr to osobny adres w historii.

Przegląd kapitana

  1. Pola, które pamiętają stary adres. Typowy błąd agenta to pola bez key. Sprawdziliśmy: bez key po kliknięciu "Wyczyść filtry" lista pokazała 5 z 5 ofert, a listy wyboru dalej "Tortuga" i "kontrakt", więc następne "Filtruj" przywracało stary filtr. defaultValue działa tylko wtedy, gdy pole powstaje, a przejście, które zmienia same parametry adresu, zostawia stare pola. key z wartością z adresu tworzy pole od nowa. Stawiasz go na polach, nie na Form.
  2. Dwa modele oferty. Wyszukaj w Cursorze w całym projekcie interface Job i type Job . Jedynym modelem oferty ma być JobPost w types/job.ts.
  3. Śmieci w adresie. Otwórz /jobs?type=abc. U nas strona pokazała wszystkie pięć ofert, bez błędu i bez pustej listy.
  4. Wielkość liter. Otwórz /jobs?location=tortuga. U nas wyszły trzy oferty z Tortugi, choć w danych port zaczyna się wielką literą.

Następny krok

Gdy przegląd przejdzie, poproś o commit, na przykład "Tablica ofert z filtrami w adresie". Serwer deweloperski uruchom w tle tak jak w lekcji 6_4, żeby sprawdzać adresy w przeglądarce, a sesja była wolna. Potem mały krok z testem:

Dodaj filtr minimalnego wynagrodzenia (?min=8000): oferta bez widełek
nie pasuje, gdy filtr jest ustawiony, a wartość, która nie jest
liczbą, znaczy brak filtra. Najpierw testy filterJobs, potem kod.

W edytorze poniżej czeka tablica ofert z udawanym paskiem adresu. Ustaw filtr, kliknij Wstecz i obserwuj adres, a potem wyłącz pola z key, wyczyść filtry i zobacz, co zostaje w listach wyboru.

Pamiętaj: jedna tablica, jeden model oferty i jedna prawda, a adres w pasku to mapa, którą wolno przekazać dalej.

Kod do tej lekcji: App.jsx
// Tablica ofert w miniaturze: filtry żyją w adresie, a lista jest liczona z pełnej listy.
// Pasek na górze udaje przeglądarkę: formularz zmienia adres, a "strona" czyta z niego filtry,
// tak jak app/jobs/page.tsx czyta searchParams. Wstecz cofa do poprzedniego adresu.
import { useState } from 'react';

const jobTypes = ['full-time', 'part-time', 'contract', 'temporary'];
const jobTypeLabels = { 'full-time': 'pełny etat', 'part-time': 'część etatu', contract: 'kontrakt', temporary: 'na jeden rejs' };

const jobs = [
  { id: 'j5', title: 'Nawigator na jeden rejs', company: 'Zemsta Królowej Anny', location: 'Tortuga', type: 'temporary', description: 'Przez rafy do Nassau i z powrotem.' },
  { id: 'j2', title: 'Kartograf wyprawy', company: 'Zemsta Królowej Anny', location: 'Nassau', type: 'contract', description: 'Mapy wybrzeża i dziennik pomiarów.' },
  { id: 'j3', title: 'Cieśla okrętowy', company: 'Łabędź', location: 'Tortuga', type: 'contract', description: 'Naprawa poszycia po sztormie.' },
  { id: 'j1', title: 'Pierwszy oficer', company: 'Czarna Perła', location: 'Tortuga', type: 'full-time', description: 'Wachta nocna na wodach Karaibów.' },
  { id: 'j4', title: 'Kuk okrętowy', company: 'Czarna Perła', location: 'Port Royal', type: 'part-time', description: 'Trzy posiłki dziennie dla załogi.' },
];
const locations = [...new Set(jobs.map((job) => job.location))].sort((a, b) => a.localeCompare(b, 'pl'));

// Adres to dane od użytkownika: nieznany rodzaj umowy znaczy "bez filtra".
function parseJobFilters(params) {
  const type = params.get('type');
  return {
    type: jobTypes.includes(type) ? type : undefined,
    location: (params.get('location') ?? '').trim(),
    q: (params.get('q') ?? '').trim(),
  };
}

const lower = (value) => value.toLocaleLowerCase('pl-PL');

function filterJobs(list, filters) {
  const phrase = lower(filters.q);
  return list.filter(
    (job) =>
      (!filters.type || job.type === filters.type) &&
      (!filters.location || lower(job.location) === lower(filters.location)) &&
      (!phrase || lower(job.title + ' ' + job.company + ' ' + job.description).includes(phrase))
  );
}

function JobsPage({ search, navigate, keyed }) {
  const filters = parseJobFilters(new URLSearchParams(search));
  const found = filterJobs(jobs, filters);
  const key = (value) => (keyed ? value : undefined);

  // next/form robi to samo: pola formularza stają się parametrami adresu.
  const submit = (event) => {
    event.preventDefault();
    navigate('?' + new URLSearchParams(new FormData(event.currentTarget)).toString());
  };

  return (
    <div className="space-y-3">
      <form onSubmit={submit} className="grid gap-2 rounded-lg border border-gray-200 bg-white p-3 text-sm sm:grid-cols-3">
        <label className="font-semibold">
          Szukaj
          <input key={key(filters.q)} name="q" defaultValue={filters.q} placeholder="np. kartograf" className="mt-1 w-full rounded-lg border border-gray-300 px-2 py-1 font-normal" />
        </label>
        <label className="font-semibold">
          Port
          <select key={key(filters.location)} name="location" defaultValue={filters.location} className="mt-1 w-full rounded-lg border border-gray-300 px-2 py-1 font-normal">
            <option value="">Wszystkie porty</option>
            {locations.map((location) => <option key={location} value={location}>{location}</option>)}
          </select>
        </label>
        <label className="font-semibold">
          Rodzaj umowy
          <select key={key(filters.type ?? '')} name="type" defaultValue={filters.type ?? ''} className="mt-1 w-full rounded-lg border border-gray-300 px-2 py-1 font-normal">
            <option value="">Każdy</option>
            {jobTypes.map((type) => <option key={type} value={type}>{jobTypeLabels[type]}</option>)}
          </select>
        </label>
        <div className="flex items-center gap-3 sm:col-span-3">
          <button className="rounded-full bg-blue-600 px-4 py-1 font-semibold text-white">Filtruj</button>
          <button type="button" onClick={() => navigate('')} className="text-blue-700 underline">Wyczyść filtry</button>
        </div>
      </form>
      <p className="text-sm text-gray-600">Znalezione oferty: {found.length} z {jobs.length}</p>
      {found.map((job) => (
        <article key={job.id} className="rounded-lg border border-gray-200 bg-white p-3">
          <h2 className="font-bold text-blue-700">{job.title}</h2>
          <p className="text-sm text-gray-600">{job.company} · {job.location} · {jobTypeLabels[job.type]}</p>
        </article>
      ))}
    </div>
  );
}

export default function App() {
  const [history, setHistory] = useState(['']);
  const [keyed, setKeyed] = useState(true);
  const search = history[history.length - 1];
  const navigate = (next) => setHistory((current) => [...current, next]);
  const back = () => setHistory((current) => (current.length > 1 ? current.slice(0, -1) : current));

  return (
    <div className="min-h-screen bg-gray-100 p-4 text-gray-900">
      <div className="mx-auto max-w-2xl space-y-3">
        <div className="flex items-center gap-2 rounded-lg border border-gray-200 bg-white p-2 text-sm">
          <button onClick={back} disabled={history.length < 2} className="rounded border border-gray-300 px-2 disabled:opacity-40">Wstecz</button>
          <code className="flex-1 truncate rounded bg-gray-100 px-2 py-1">/jobs{search}</code>
        </div>
        <label className="flex items-center gap-2 text-sm">
          <input type="checkbox" checked={keyed} onChange={(e) => setKeyed(e.target.checked)} />
          Pola z key (wyłącz, żeby zobaczyć typowy błąd)
        </label>
        <JobsPage search={search} navigate={navigate} keyed={keyed} />
      </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 pokaże strona /jobs?type=abc?

  2. 2. Jak strona /jobs wybiera oferty do pokazania?

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

Zadania praktyczne w grze

  • Układanie w poziomie

    Ułóż w jednej linii adres tablicy ofert: /jobs?type=contract&location=Tortuga&q=cieśla

  • Układanie w pionie

    Uporządkuj, co się dzieje po kliknięciu Filtruj:

  • Układanie w poziomie

    Ułóż w jednej linii ścieżkę pliku skilla z lekcji 6_1: .claude/skills/nowy-formularz/SKILL.md

  • Układanie w pionie

    Uporządkuj sprawdzian czatu, który Claude robi z serwerem w tle:

  • Klikanie w kolejności

    Ułóż sprzątanie efektu w useChat: return () => source.close()

  • Klikanie w kolejności

    Ułóż odczyt filtrów na stronie /jobs: parseJobFilters(await searchParams)

  1. PytanieQuiz: Nieznany rodzaj umowy w adresie
  2. PytanieQuiz: Filtrowanie ofert (filterJobs)
  3. Ułóż w kolejnościSortowanie: Adres z filtrami
  4. Ułóż w kolejnościSortowanie: Od Filtruj do listy ofert
  5. PytanieQuiz: Skill czy CLAUDE.md
  6. Ułóż w kolejnościSortowanie: Ścieżka skilla
  7. PytanieQuiz: disable-model-invocation
  8. PytanieQuiz: Co robi Ctrl+B
  9. Ułóż w kolejnościSortowanie: Sprawdzian czatu z serwerem w tle
  10. PytanieQuiz: Praca w tle (/tasks)
  11. Kliknij w kolejnościSortowanie: Sprzątanie strumienia w przeglądarce
  12. PytanieQuiz: cancel w strumieniu na serwerze
  13. PytanieQuiz: Nadawca wiadomości
  14. Kliknij w kolejnościSortowanie: Filtry z adresu
  15. PytanieQuiz: Filtry w adresie
  16. PytanieQuiz: key na polu filtra
  17. Projekt do wysłaniaWyślij Crew Connections do mentora
  18. WideoPodsumowanie modułu

Przydatne artykuły