Kurs vibe coding z Claude Code · Moduł 13: Klon Twitcha
Archiwum najlepszych chwil: kategorie, klipy i nagrania
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.mdbez 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
- Wymyślone pomocniki. Typowy błąd agenta to
createClipw przeglądarce, który wołagenerateId(),getCurrentUser()igetCurrentStream(), choć nikt ich nie napisał. U nasnpm run lintprzy takim pliku milczał, anpx tsc --noEmitzgłosiłCannot find name 'generateId'i dwa podobne błędy. Ta sama wersja liczyłacurrentTimestamp - duration / 2, czyli ujemny początek przy trzeciej sekundzie nagrania. - Martwy stan. Wyszukaj
isPlaying. Agent lubiconst [isPlaying, setIsPlaying] = useState(false)iautoPlay={isPlaying}, choć nic tego stanu nie zmienia. Lint pokazał u nas tylko ostrzeżenie'setIsPlaying' is assigned a value but never usedi zakończył się sukcesem, więc ostrzeżenia czytaj, a nie przewijaj. - Okładki. Każdy
Imagezfillma rodzica zrelativei proporcjami. - 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. Czym jest klip w Live from the Deck?
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
Zadania po tej lekcji
- PytanieQuiz: czym jest klip
- PytanieQuiz: kto liczy zakres klipu
- Ułóż w kolejnościSortowanie: adres klipu
- Zadanie z kodemPraktyka: Browse categories
- PytanieQuiz: fragment medialny to nie zamek
- Ułóż w kolejnościSortowanie: rozdziały z kopii
- Ułóż w kolejnościSortowanie: trasa POST /api/clips
- Zadanie z kodemPraktyka: Clip player
- PytanieQuiz: bieżący rozdział
- Ułóż w kolejnościSortowanie: karta kategorii
- Kliknij w kolejnościBudowanie: czas rozdziału
- PytanieQuiz: clipRange na początku nagrania
- Ułóż w kolejnościSortowanie: lista rozdziałów
- Ułóż w kolejnościSortowanie: droga klipu
- Kliknij w kolejnościBudowanie: zakres klipu na serwerze
- Ułóż w kolejnościSortowanie: droga widza
- Ułóż w kolejnościSortowanie: pickTab w jednej linii
- PytanieQuiz: skąd odtwarzacz zna rozdział
- Ułóż w kolejnościSortowanie: odtwarzacz klipu
- Ułóż w kolejnościSortowanie: siatka kategorii
- PytanieQuiz: martwy stan isPlaying
- Ułóż w kolejnościSortowanie: bieżący rozdział
- PytanieQuiz: wymyślone pomocniki
- Ułóż w kolejnościSortowanie: strona Przeglądaj od góry
- PytanieQuiz: aria-pressed na przycisku Obserwuj
- Ułóż w kolejnościSortowanie: wynik formatTime
- PytanieQuiz: co sprawdzasz w przeglądarce