Kurs vibe coding z Claude Code · Moduł 13: Klon Twitcha

Archiwum najlepszych chwil: kategorie, klipy i nagrania

8 min czytania
W tej lekcji9

Kanał ma wizytówkę ale nowy widz nie wie jeszcze, czego szukać. Potrzebuje strony, na której przegląda kategorie, widzi, kto nadaje teraz, i ogląda krótkie klipy z najlepszymi chwilami. Streamer z kolei chce, żeby rejs nie znikał po transmisji: nagranie zostaje w archiwum, podzielone na rozdziały, a widz może wyciąć z niego klip. W tej lekcji Claude zbuduje stronę Przeglądaj z trzema zakładkami, stronę nagrania i tworzenie klipów. Ty sprawdzisz, gdzie naprawdę powstaje klip.

Czego się nauczysz

  • zamówić dużą funkcję w trybie planowania i od razu użyć konwencji zakładek z CLAUDE.md bez kolejnej kopii kodu;
  • przeczytać okładki o stałych proporcjach, które nie skaczą przy ładowaniu;
  • zrozumieć, że klip to przedział czasu w nagraniu, a pilnuje go serwer;
  • sprawdzić każdą zakładkę w przeglądarce, z Claude in Chrome albo ręcznie.

Polecenie dla Claude Code

Krok dotyka danych, trzech komponentów kart, dwóch stron, trasy API i odtwarzacza, więc zaczynasz od planu, jak w lekcji 1_6:

Polecenie dla Claude Code:

/plan Dodaj stronę /browse z zakładkami Kategorie, Na żywo i Klipy
(przez Tabs, zgodnie z CLAUDE.md). Kategorie: siatka okładek 3:4
z liczbą widzów, okładki z images.unsplash.com przez next/image.
Na żywo: kanały z lib/channels.ts, które nadają. Klipy: klip to
przedział czasu w nagraniu (vodId, start, end), bez cięcia wideo.
Strona /videos/[id] z odtwarzaczem nagrania, listą rozdziałów
i przyciskiem Utwórz klip. Klip zapisuje trasa POST /api/clips:
serwer sam liczy 30 sekund wokół wskazanego momentu i odrzuca
moment spoza nagrania. Testy Vitest dla rozdziałów i zakresu klipu.
Na koniec npm run test -- --run, npm run lint, npx tsc --noEmit
i npm run build.

W planie sprawdź jedno: czy Claude nie zamierza wycinać wideo w przeglądarce. Jeśli plan mówi o "przycinaniu pliku" w komponencie, odpowiedz "No, keep planning" i przypomnij, że klip to przedział.

Co napisał Claude: zakładki z konwencji

Otwórz app/browse/page.tsx. Strona nie ma własnego kodu zakładek, tylko listę i wspólny komponent z lekcji 12_2:

// app/browse/page.tsx
const BROWSE_TABS = [
  { key: "categories", label: "Kategorie" },
  { key: "live", label: "Na żywo" },
  { key: "clips", label: "Klipy" },
] as const;

Strona zaczyna się od nagłówka Przeglądaj, pod nim stoi <Tabs tabs={BROWSE_TABS} active={active} basePath="/browse" />, a niżej trzy sekcje, z których każda rysuje się tylko przy swojej zakładce. Sekcja kategorii to jedno wyrażenie: categories.map((c) => <CategoryCard key={c.slug} category={c} />). To dowód, że linia w CLAUDE.md zadziałała: Claude nie napisał szóstej kopii.

Co napisał Claude: okładki, które nie skaczą

Otwórz components/CategoryCard.tsx. Okładka kategorii jest wyższa niż szersza, jak pudełko gry:

// components/CategoryCard.tsx
<div className="relative aspect-3/4 overflow-hidden rounded-lg bg-zinc-800">
  <Image src={category.cover} alt="" fill sizes="(min-width: 1024px) 20vw, 45vw" className="object-cover" />
</div>

Pod okładką stoją nazwa kategorii w h3 i liczba widzów. aspect-3/4 rezerwuje miejsce o proporcjach 3 do 4, zanim obrazek się pobierze, więc tekst pod kartą nie podskakuje. fill rozciąga obrazek na rodzica z relative, sizes mówi przeglądarce, jaką część ekranu zajmie karta, a object-cover przycina zdjęcie do kształtu. To wszystko znasz z lekcji 3_1. Stamtąd pochodzi też wpis remotePatterns dla images.unsplash.com w next.config.ts. Bez niego next build przechodzi, a obrazek z innego serwera wywraca stronę dopiero w przeglądarce. Karta kanału na żywo, components/LiveCard.tsx, działa tak samo, tylko z aspect-video i plakietką NA ŻYWO, i prowadzi na stronę kanału. Tam zakładka Nagrania z lekcji 12_2 dostała listę linków do /videos/[id].

Klip to przedział, nie nowy plik

Wycięcie fragmentu filmu to ciężka praca: trzeba odczytać plik, zakodować kawałek na nowo i zapisać go jako nowe wideo. Robi się to na serwerze, programem takim jak ffmpeg, którym w lekcji 12_1 zrobiłeś plik testowy. Komponent Reacta w przeglądarce widza to złe miejsce na taką pracę: telefon musiałby pobrać całe nagranie i przekodować jego kawałek. Nasz klon idzie prostszą drogą: zapisuje tylko przedział czasu w istniejącym nagraniu. Otwórz components/ClipPlayer.tsx:

// components/ClipPlayer.tsx
<video
  src={`${vod.src}#t=${clip.start},${clip.end}`}
  controls
  preload="metadata"
  className="aspect-video w-full rounded-lg bg-black"
/>

#t=40,55 na końcu adresu to fragment medialny. MDN opisuje go jako sposób, by odtworzyć tylko część pliku: od pierwszej liczby sekund do drugiej. Pod odtwarzaczem stoją tytuł klipu w h3 i nazwa nagrania z zakresem, na przykład 0:40-0:55. U nas Chrome ustawił klip na 0:40, a po starcie odtwarzania zatrzymał się sam na 55,1 sekundy. Pamiętaj, że to nie zabezpieczenie: kontrolki pokazują całe nagranie (0:40 / 1:00), a przewinięcie na 5. sekundę zadziałało bez oporu.

Sprawdzian na serwerze: zakres klipu

Przycisk Utwórz klip wysyła tylko vodId i bieżącą sekundę. Długość klipu i jego granice liczy serwer, jak zamek z lekcji 8_3, bo żądanie można wysłać z pominięciem przycisku. Otwórz lib/clipRange.ts:

// lib/clipRange.ts
export const CLIP_SECONDS = 30; // reguła naszego klonu

export function clipRange(at: number, duration: number): { start: number; end: number } | null {
  if (!Number.isFinite(at) || at < 0 || at > duration) return null;
  const start = Math.max(0, Math.min(Math.round(at) - CLIP_SECONDS / 2, duration - CLIP_SECONDS));
  return { start, end: Math.min(duration, start + CLIP_SECONDS) };
}

Trzydzieści sekund to nasza reguła, nie zasada Twitcha. Number.isFinite odrzuca NaN, czyli wynik Number("abc"). Math.min i Math.max przesuwają klip tak, żeby nie wystawał przed początek ani za koniec nagrania. Test sprawdza klip przy 3. sekundzie (0-30) i przy 58. (30-60). Trasa app/api/clips/route.ts najpierw czyta ciało żądania przez request.json().catch(() => null), potem szuka nagrania po vodId (brak to 404). Dalej liczy const range = clipRange(Number(body.at), vod.duration) i odpowiada 400, gdy dostanie null. Na końcu zapisuje klip i odpowiada 201. Sprawdź ją przy działającym npm run dev:

curl -s -w ' %{http_code}\n' -X POST -H 'Content-Type: application/json' -d '{"vodId":"rejs-1","at":9999}' localhost:3000/api/clips

-w dopisuje kod odpowiedzi na końcu linii. U nas wyszło {"error":"Ten moment leży poza nagraniem"} 400, a dla nieznanego nagrania 404. Klipy trzyma tablica na globalThis, z powodu z lekcji 11_2: trasa i strona inaczej widziałyby osobne kopie.

Co napisał Claude: rozdziały z posortowanej kopii

Streamer dodaje rozdziały w trakcie montażu, w dowolnej kolejności, więc w danych mogą stać nie po kolei. Otwórz lib/chapters.ts:

// lib/chapters.ts
export function sortChapters(chapters: readonly Chapter[]): Chapter[] {
  return [...chapters].sort((a, b) => a.start - b.start);
}

export function currentChapter(chapters: readonly Chapter[], time: number): Chapter | undefined {
  return sortChapters(chapters).findLast((chapter) => chapter.start <= time);
}

Ta sama zasada co w parserze emotek: kopia przed sortowaniem i readonly w typie. findLast szuka od końca, więc zwraca ostatni rozdział, który zaczął się przed bieżącą sekundą. formatTime z tego samego pliku zamienia sekundy na m:ss albo h:mm:ss (65,9 sekundy to "1:05"), a lista rozdziałów pokazuje formatTime(ch.start) przed tytułem. VodPlayer liczy rozdział w trakcie renderu z time, który ustawia onTimeUpdate elementu <video>. MDN podaje, że to zdarzenie przychodzi mniej więcej od 4 do 66 razy na sekundę, zależnie od obciążenia, więc do wyświetlenia rozdziału wystarczy.

Przegląd kapitana

  1. Wymyślone pomocniki. Typowy błąd agenta to createClip w przeglądarce, który woła generateId(), getCurrentUser() i getCurrentStream(), choć nikt ich nie napisał. U nas npm run lint przy takim pliku milczał, a npx tsc --noEmit zgłosił Cannot find name 'generateId' i dwa podobne błędy. Ta sama wersja liczyła currentTimestamp - duration / 2, czyli ujemny początek przy trzeciej sekundzie nagrania.
  2. Martwy stan. Wyszukaj isPlaying. Agent lubi const [isPlaying, setIsPlaying] = useState(false) i autoPlay={isPlaying}, choć nic tego stanu nie zmienia. Lint pokazał u nas tylko ostrzeżenie 'setIsPlaying' is assigned a value but never used i zakończył się sukcesem, więc ostrzeżenia czytaj, a nie przewijaj.
  3. Okładki. Każdy Image z fill ma rodzica z relative i proporcjami.
  4. Przeglądarka. To jest krok, którego nie zastąpi żaden test. Z Claude in Chrome z lekcji 3_8 wystarczy jedno polecenie:
Otwórz localhost:3000/browse i przejdź po zakładkach Kategorie,
Na żywo i Klipy. Na każdej sprawdź, czy karty się wyświetlają,
i zajrzyj do konsoli po błędy. Na /videos/rejs-1 kliknij rozdział
Odtwarzacz, potem Utwórz klip i sprawdź, czy klip pojawia się
w zakładce Klipy. Zgłoś, co widzisz.

Bez rozszerzenia zrób to samo ręcznie. U nas trzy zakładki pokazały karty, konsola była pusta, rozdział przełączył się na "Odtwarzacz", a POST /api/clips odpowiedział 201.

Następny krok

Gdy przegląd przejdzie, poproś o commit "Przeglądaj, klipy i rozdziały nagrań". Potem mały krok: "Na stronie kategorii pokaż kanały na żywo z tej kategorii, najpierw plan". Klon ma już czym się pochwalić, ale do portu jeszcze daleko: w następnych lekcjach zamkniesz go w kontenerze i postawisz pipeline, który sprawdza każdą zmianę. W edytorze poniżej czeka strona Przeglądaj w miniaturze: przełączaj zakładki i twórz klipy z udawanego nagrania.

Zapamiętaj: archiwum jest warte tyle, ile mapa, która do niego prowadzi, a nożyce do taśmy trzyma bosman w ładowni, nie widz na pokładzie.

Kod do tej lekcji: App.tsx
// Przeglądaj w miniaturze: zakładki, okładki 3:4, klip jako przedział liczony przez udawany serwer i rozdziały
import { useState } from 'react';

interface Chapter {
  start: number;
  title: string;
}

interface Clip {
  id: string;
  start: number;
  end: number;
}

const DURATION = 60; // nagranie trwa minutę
const CLIP_SECONDS = 30; // reguła naszego klonu
const CHAPTERS: readonly Chapter[] = Object.freeze([
  { start: 40, title: 'Czat i emotki' },
  { start: 0, title: 'Powitanie załogi' },
  { start: 15, title: 'Odtwarzacz' },
]);
const CATEGORIES = [
  { slug: 'programowanie', name: 'Programowanie', viewers: 1247, colors: 'from-sky-600 to-indigo-900' },
  { slug: 'szanty', name: 'Szanty', viewers: 310, colors: 'from-amber-500 to-rose-800' },
  { slug: 'nawigacja', name: 'Nawigacja', viewers: 88, colors: 'from-emerald-500 to-teal-900' },
];
const TABS = [
  { key: 'categories', label: 'Kategorie' },
  { key: 'live', label: 'Na żywo' },
  { key: 'clips', label: 'Klipy' },
] as const;
type BrowseTab = (typeof TABS)[number]['key'];

function sortChapters(chapters: readonly Chapter[]): Chapter[] {
  return [...chapters].sort((a, b) => a.start - b.start);
}

function currentChapter(chapters: readonly Chapter[], time: number): Chapter | undefined {
  return sortChapters(chapters).findLast((chapter) => chapter.start <= time);
}

function clipRange(at: number, duration: number): { start: number; end: number } | null {
  if (!Number.isFinite(at) || at < 0 || at > duration) return null;
  const start = Math.max(0, Math.min(Math.round(at) - CLIP_SECONDS / 2, duration - CLIP_SECONDS));
  return { start, end: Math.min(duration, start + CLIP_SECONDS) };
}

function formatTime(seconds: number): string {
  const s = Math.floor(seconds);
  return Math.floor(s / 60) + ':' + String(s % 60).padStart(2, '0');
}

// W projekcie id daje crypto.randomUUID(); tu wystarczy licznik
let nextId = 1;

// Udawany serwer: sam liczy zakres; wersja agenta przyjmuje to, co policzyła przeglądarka
function fakeServer(body: { at: number; start?: number; end?: number }, trustClient: boolean) {
  if (trustClient && body.start !== undefined && body.end !== undefined) {
    return { status: 201, clip: { id: 'c' + nextId++, start: body.start, end: body.end } };
  }
  const range = clipRange(body.at, DURATION);
  if (!range) return { status: 400, clip: null };
  return { status: 201, clip: { id: 'c' + nextId++, ...range } };
}

export default function App() {
  const [active, setActive] = useState<BrowseTab>('categories');
  const [time, setTime] = useState(3);
  const [clips, setClips] = useState<Clip[]>([]);
  const [trustClient, setTrustClient] = useState(false);
  const [status, setStatus] = useState('');
  const chapter = currentChapter(CHAPTERS, time);

  function createClip() {
    // Wersja agenta liczy zakres w przeglądarce: at - 15, bez granic nagrania
    const body = trustClient ? { at: time, start: time - CLIP_SECONDS / 2, end: time + CLIP_SECONDS / 2 } : { at: time };
    const res = fakeServer(body, trustClient);
    if (res.clip) {
      const clip = res.clip;
      setClips((prev) => [clip, ...prev]);
    }
    setStatus('Serwer odpowiedział ' + res.status);
  }

  return (
    <div className="min-h-screen space-y-4 bg-zinc-950 p-4 text-zinc-100">
      <h1 className="text-2xl font-bold">Przeglądaj</h1>
      <nav aria-label="Zakładki" className="flex gap-1 border-b border-zinc-800">
        {TABS.map((tab) => (
          <button
            key={tab.key}
            type="button"
            onClick={() => setActive(tab.key)}
            aria-current={tab.key === active ? 'page' : undefined}
            className={tab.key === active ? 'border-b-2 border-purple-500 px-4 py-2 font-semibold' : 'border-b-2 border-transparent px-4 py-2 text-zinc-400'}
          >
            {tab.label}
          </button>
        ))}
      </nav>

      {active === 'categories' && (
        <section className="grid max-w-md grid-cols-3 gap-3">
          {CATEGORIES.map((c) => (
            <article key={c.slug}>
              <div className={'aspect-3/4 rounded-lg bg-linear-to-b ' + c.colors} />
              <h2 className="mt-2 font-semibold">{c.name}</h2>
              <p className="text-sm text-zinc-400">{c.viewers} widzów</p>
            </article>
          ))}
        </section>
      )}

      {active === 'live' && <p>Kapitan Redbeard nadaje: Rejs przez Morze Kodu (1247 widzów)</p>}

      {active === 'clips' && (
        <section className="space-y-3">
          <label className="block text-sm">
            Udawane nagranie, sekunda {formatTime(time)} z {formatTime(DURATION)}
            <input type="range" min={0} max={DURATION} value={time} onChange={(e) => setTime(Number(e.target.value))} className="block w-full" aria-label="Sekunda nagrania" />
          </label>
          <p>Rozdział: <strong>{chapter?.title ?? 'brak'}</strong></p>
          <ol className="text-sm text-zinc-400">
            {sortChapters(CHAPTERS).map((ch) => (
              <li key={ch.start}>{formatTime(ch.start)} {ch.title}</li>
            ))}
          </ol>
          <button type="button" onClick={createClip} className="rounded bg-purple-600 px-4 py-2 font-semibold">
            Utwórz klip
          </button>
          <p role="status">{status}</p>
          <ul className="space-y-1">
            {clips.map((clip) => (
              <li key={clip.id} className={clip.start < 0 || clip.end > DURATION ? 'text-red-400' : ''}>
                Klip {formatTime(Math.max(0, clip.start))}-{formatTime(clip.end)} (start {clip.start}, koniec {clip.end})
              </li>
            ))}
          </ul>
          <label className="flex items-center gap-2 text-sm">
            <input type="checkbox" checked={trustClient} onChange={(e) => setTrustClient(e.target.checked)} />
            Wersja agenta: zakres liczy przeglądarka, serwer go przyjmuje
          </label>
        </section>
      )}
    </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 klip w Live from the Deck?

  2. 2. Kto w Live from the Deck liczy początek i koniec nowego klipu?

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

Zadania praktyczne w grze

  • Układanie w poziomie

    Ułóż adres, który odtwarza klip od 40. do 55. sekundy nagrania (jedna linia):

  • Edytor kodu

    Zbuduj stronę przeglądania kategorii

  • Układanie w poziomie

    Ułóż wnętrze sortChapters, które sortuje kopię rozdziałów (jedna linia):

  • Układanie w pionie

    Uporządkuj kroki trasy, która zapisuje klip:

  • Edytor kodu

    Stwórz odtwarzacz clipów

  • Układanie w pionie

    Uporządkuj elementy CategoryCard od góry:

  • Klikanie w kolejności

    Zbuduj wywołanie, które pokazuje początek rozdziału jako m:ss

  • Układanie w pionie

    Rozdziały stoją w danych jako 0:40, 0:00, 0:15. Uporządkuj je tak, jak pokaże je lista z sortChapters:

  • Układanie w pionie

    Uporządkuj drogę klipu od kliknięcia do zakładki Klipy:

  • Klikanie w kolejności

    Zbuduj linię trasy POST /api/clips, która liczy zakres klipu

  • Układanie w pionie

    Uporządkuj drogę widza od strony Przeglądaj do nagrania:

  • Układanie w poziomie

    Ułóż treść funkcji pickTab (jedna linia):

  • Układanie w pionie

    Uporządkuj elementy ClipPlayer od góry:

  • Układanie w poziomie

    Ułóż wyrażenie, które rysuje karty w zakładce Kategorie (jedna linia):

  • Układanie w poziomie

    Ułóż treść funkcji currentChapter (jedna linia):

  • Układanie w pionie

    Uporządkuj elementy strony Przeglądaj od góry:

  • Układanie w poziomie

    Ułóż wynik formatTime(65.9) dla nagrania krótszego niż godzina (jedna linia): 1:05

  1. PytanieQuiz: czym jest klip
  2. PytanieQuiz: kto liczy zakres klipu
  3. Ułóż w kolejnościSortowanie: adres klipu
  4. Zadanie z kodemPraktyka: Browse categories
  5. PytanieQuiz: fragment medialny to nie zamek
  6. Ułóż w kolejnościSortowanie: rozdziały z kopii
  7. Ułóż w kolejnościSortowanie: trasa POST /api/clips
  8. Zadanie z kodemPraktyka: Clip player
  9. PytanieQuiz: bieżący rozdział
  10. Ułóż w kolejnościSortowanie: karta kategorii
  11. Kliknij w kolejnościBudowanie: czas rozdziału
  12. PytanieQuiz: clipRange na początku nagrania
  13. Ułóż w kolejnościSortowanie: lista rozdziałów
  14. Ułóż w kolejnościSortowanie: droga klipu
  15. Kliknij w kolejnościBudowanie: zakres klipu na serwerze
  16. Ułóż w kolejnościSortowanie: droga widza
  17. Ułóż w kolejnościSortowanie: pickTab w jednej linii
  18. PytanieQuiz: skąd odtwarzacz zna rozdział
  19. Ułóż w kolejnościSortowanie: odtwarzacz klipu
  20. Ułóż w kolejnościSortowanie: siatka kategorii
  21. PytanieQuiz: martwy stan isPlaying
  22. Ułóż w kolejnościSortowanie: bieżący rozdział
  23. PytanieQuiz: wymyślone pomocniki
  24. Ułóż w kolejnościSortowanie: strona Przeglądaj od góry
  25. PytanieQuiz: aria-pressed na przycisku Obserwuj
  26. Ułóż w kolejnościSortowanie: wynik formatTime
  27. PytanieQuiz: co sprawdzasz w przeglądarce

Przydatne artykuły