Kurs vibe coding z Claude Code · Moduł 8: Klon Slacka

Tablica nawigacyjna: panel załogi liczony z wiadomości

8 min czytania
W tej lekcji10

Kapitan chce wiedzieć, czy Ship's Comms żyje: ile wiadomości płynie przez kanały, kto pisze najwięcej i czy w tym tygodniu jest ciszej niż w poprzednim. Liczba bez źródła to żegluga we mgle, a wykres z danymi wpisanymi na sztywno wygląda świetnie i kłamie. W tej lekcji panel liczy wszystko z prawdziwych wiadomości, a testy pilnują, żeby liczby się zgadzały.

Problem: trzy pułapki w prostym dodawaniu

Panel wygląda na zwykłe liczenie, ale ma trzy miejsca, w których łatwo o błąd. Pierwsze to strefa czasowa, czyli przesunięcie zegara względem czasu uniwersalnego UTC. Wiadomości mają datę ISO zapisaną w UTC, a załoga żyje w Warszawie, która jest godzinę przed UTC, a latem dwie. Wiadomość napisana pół godziny po północy należy do nowego dnia, choć w UTC jest jeszcze poprzedni dzień. Drugie miejsce to zmiana w procentach, gdy w poprzednim tygodniu nie było nic. Trzecie to dostęp: gość nie może z panelu wyczytać, ile się dzieje na kanale prywatnym, nawet jako sumy.

Polecenie dla Claude Code:

/plan Dodaj stronę /panel z aktywnością załogi z ostatnich 7 dni:
trzy karty (wiadomości, aktywni członkowie, odpowiedzi w wątkach)
ze zmianą w procentach wobec poprzednich 7 dni, wykres słupkowy
wiadomości dziennie, ranking kanałów i trzech najaktywniejszych
członków. Licz wszystko z wiadomości czystymi funkcjami
w lib/analytics.ts, najpierw testy. Dzień liczy się w strefie
Europe/Warsaw. Tylko kanały, które zalogowany może widzieć.
Wykres bez biblioteki, z krótkim opisem dla czytnika ekranu
i tabelą z danymi. Dopisz do danych testowych dwa tygodnie rozmów.
Na koniec testy, lint, typy i build.

Zdanie o bibliotece jest świadome. Siedem słupków to zwykłe elementy HTML z wysokością w procentach: renderują się na serwerze razem z resztą strony i nie dokładają do package.json zależności, którą trzeba potem aktualizować. Po bibliotekę wykresów sięgnij dopiero przy osiach, powiększaniu albo podpowiedziach po najechaniu, i wtedy poproś Claude, żeby najpierw pokazał w dokumentacji, że działa z Twoją wersją Reacta. W samym planie sprawdź, czy liczenie trafia do lib/analytics.ts, a nie do komponentów: tylko czyste funkcje przetestujesz bez przeglądarki.

Co pokazał pierwszy przebieg

Claude zaczął od testów w lib/analytics.test.ts, a potem napisał pierwszą wersję funkcji. Dzień wiadomości brał z createdAt.slice(0, 10), czyli z pierwszych dziesięciu znaków daty ISO. Cztery z dziesięciu testów nie przeszły, a pierwszy z nich wyglądał tak:

FAIL  lib/analytics.test.ts > dayKey > liczy dzień w strefie Europe/Warsaw, nie w UTC
AssertionError: expected '2026-11-13' to be '2026-11-14' // Object.is equality

Expected: "2026-11-14"
Received: "2026-11-13"

Test podał wiadomość z chwili 2026-11-13T23:30:00.000Z. W Warszawie to 00:30 czternastego listopada, a slice odciął datę w UTC i wrzucił wachtę nocną do poprzedniego dnia. Na ekranie nic by tego nie zdradziło: słupki wyglądałyby zwyczajnie, tylko jedna wiadomość stałaby dzień za wcześnie. Drugi test złapał to samo w lipcu, gdy różnica wynosi dwie godziny. Pozostałe dwie porażki to dzielenie przez zero, do którego dojdziemy za chwilę.

Co napisał Claude: dzień w strefie Warszawy

Otwórz w Cursorze lib/analytics.ts. Poprawiona funkcja dayKey pyta o datę wprost w strefie Warszawy:

export const TIME_ZONE = "Europe/Warsaw";

const dayParts = new Intl.DateTimeFormat("pl-PL", {
  timeZone: TIME_ZONE,
  year: "numeric",
  month: "2-digit",
  day: "2-digit",
});

export function dayKey(date: Date | string): string {
  const parts = dayParts.formatToParts(new Date(date));
  const part = (type: Intl.DateTimeFormatPartTypes) =>
    parts.find((p) => p.type === type)?.value;
  return `${part("year")}-${part("month")}-${part("day")}`;
}

Intl.DateTimeFormat z polem timeZone przelicza czas na zegar Warszawy, razem z czasem letnim, a formatToParts oddaje rok, miesiąc i dzień osobno zamiast gotowego napisu z kropkami (Intl.DateTimeFormatPartTypes to typ z nazwami tych części). Wynik to klucz w rodzaju "2026-11-14", który da się porównywać i sortować jak zwykły tekst. Dane się nie zmieniają: wiadomość wciąż trzyma czas w UTC, a strefa wchodzi do gry dopiero przy liczeniu. Tę samą zasadę widziałeś w lekcji 7_2 przy formatowaniu godziny.

Okres i liczenie

Obok stoją dwie małe funkcje. lastDays("2026-11-14", 7) zwraca siedem kluczy dni kończących się na podanym dniu, a inPeriod zostawia tylko wiadomości z tych dni. Strona app/panel/page.tsx bierze czternaście dni i dzieli je na dwie połowy:

const days = lastDays(dayKey(new Date()), 14);
const week = inPeriod(messages, days.slice(7)); // ostatnie 7 dni
const before = inPeriod(messages, days.slice(0, 7)); // 7 dni wcześniej

messages to tu wiadomości przefiltrowane wcześniej przez canSeeChannel, tę samą funkcję, która w lekcji 7_1 pilnowała paska bocznego i trasy kanału. Gość kupiec widzi więc w panelu tylko general i handel, a ruch na sekrety-kapitana nie wycieknie mu nawet jako suma. Ranking kanałów i członków powstaje z countBy(week, (m) => m.channelId), która zwraca mapę "identyfikator, liczba". Żadna z tych funkcji nie zapisuje liczników obok danych, więc tak jak w dzienniku z 7_2 nic nie może się rozjechać.

Zmiana w procentach bez dzielenia przez zero

Pierwsza wersja liczyła zmianę wzorem z podręcznika. Dla pustego poprzedniego tygodnia zwracała Infinity, a dla dwóch pustych tygodni NaN, więc na kartach pojawiłyby się napisy "wzrost o Infinity%" i "spadek o NaN%". Poprawka:

export function percentChange(
  current: number,
  previous: number,
): number | null {
  if (previous === 0) return null; // nie ma z czym porównać
  return Math.round(((current - previous) / previous) * 100);
}

null znaczy "brak porównania", a nie zero: skok z niczego do pięciu wiadomości nie jest wzrostem o żadną konkretną liczbę procent. Funkcja formatChange zamienia wynik na słowa: "wzrost o 25%", "spadek o 10%", "bez zmian" albo "brak danych do porównania". Kolor dobiera dopiero komponent.

Karty: liczby, nie napisy

Otwórz components/StatsGrid.tsx. Karta dostaje trzy pola: label z nazwą, value z liczbą z ostatnich 7 dni i previous z liczbą z tygodnia wcześniej. Wartości to liczby, a nie gotowe napisy w rodzaju "12.5K", bo z napisu nic się już nie policzy. Oto jedna karta:

<div className="rounded-lg border border-gray-200 bg-white p-4">
  <dt className="text-sm text-gray-600">{stat.label}</dt>
  <dd className="text-3xl font-bold">{stat.value}</dd>
  <dd className={`text-sm ${tone[direction]}`}>{formatChange(change)}</dd>
</div>

Siatka kart to lista definicji <dl>: <dt> to nazwa liczby, a <dd> jej wartość, więc "Wiadomości" i "19" tworzą parę także w kodzie strony, nie tylko na oko. tone to mały słownik klas: text-green-700 przy wzroście, text-red-700 przy spadku i szary, gdy nie ma zmiany albo porównania. Kolor tylko podkreśla kierunek, który już podaje słowo, tak jak kropka obecności w 7_1 miała obok ukryty tekst. Ta sama karta pokaże każdą liczbę: w sklepie byłyby to wyświetlenia, kliknięcia i konwersje.

Wykres z HTML i CSS

Otwórz components/ActivityChart.tsx. Wysokość słupka liczy czysta funkcja barPercent:

export function barPercent(count: number, max: number): number {
  return max === 0 ? 0 : (count / max) * 100;
}

Najwyższy słupek dostaje 100%, pozostałe proporcjonalnie mniej. To był czwarty czerwony test: w tygodniu bez wiadomości max wynosi 0, a 0 / 0 daje NaN. Sam wykres to rząd kolumn, po jednej na dzień:

<div role="img" aria-label={summary} className="mt-4 flex gap-2">
  {data.map((d) => (
    <div key={d.day} className="flex flex-1 flex-col items-center">
      <span className="text-xs font-semibold">{d.count}</span>
      <div className="flex h-32 w-full items-end">
        <div
          className="w-full rounded-t bg-blue-600"
          style={{ height: `${barPercent(d.count, max)}%` }}
        />
      </div>
      <span className="mt-1 text-xs text-gray-600">{formatDay(d.day)}</span>
    </div>
  ))}
</div>

Słupek stoi w osobnym pudełku o stałej wysokości h-32, a liczba i data są nad nim i pod nim. W pierwszej wersji słupek dzielił kolumnę z etykietami i flexbox ściskał najwyższy, żeby wszystko się zmieściło: siódemka wyszła niecałe dwa razy wyższa od trójki, choć powinna być wyższa dwa i jedną trzecią raza. Test tego nie złapie, dlatego panel trzeba też obejrzeć. Wykres nie ma "use client", bo nie reaguje na kliknięcia: przeglądarka dostaje gotowy HTML.

Wykres dla tych, którzy go nie widzą

Słupki to obraz, a obraz trzeba opisać. Poradnik W3C o złożonych obrazach (https://www.w3.org/WAI/tutorials/images/complex/) mówi, że wykres potrzebuje opisu z dwóch części: krótkiej, która mówi, co przedstawia obraz, i dłuższej z najważniejszymi danymi. Krótką niesie role="img" z aria-label, na przykład "Wykres słupkowy wiadomości dziennie. Najwięcej: 14 lis, 7. Dokładne liczby w tabeli pod wykresem.". role="img" każe czytnikowi traktować całe pudełko jak jeden obraz, więc nie przeczyta czternastu luźnych liczb bez kontekstu. Dłuższą część daje tabela w <details> z podpisem "Dane wykresu w tabeli", z kolumnami "Dzień" i "Wiadomości". Przyda się każdemu, kto chce przepisać liczby do raportu.

Przegląd kapitana

  1. Strefa w teście, nie tylko w kodzie. Szukaj w diffie testu z godziną tuż po północy w Warszawie. Typowy błąd agenta: slice(0, 10) albo getDate() bez strefy i test z godziną 12:00, który przejdzie w każdej strefie i niczego nie sprawdzi.
  2. Gość. Zmień w lib/session.ts zalogowanego na kupiec i otwórz /panel. U nas ranking pokazał tylko #general i #handel, a karta "Wiadomości" spadła z 19 do 10.
  3. Pusty tydzień. Karta "Odpowiedzi w wątkach" pokazała "brak danych do porównania", bo w danych testowych poprzedni tydzień nie miał żadnej odpowiedzi. Tak ma być, a nie "Infinity%".
  4. Dowód. Testy (u nas 33 zielone), npm run lint, npx tsc --noEmit i npm run build. Wszystkie nowe pliki przyszły już sformatowane, bo pracuje hook z lekcji 7_1.

Następny krok

Poproś o commit, na przykład "Panel załogi z testami". Potem mały krok z tym samym rytmem:

Dodaj wybór okresu w adresie panelu: ?dni=7 albo ?dni=30, domyślnie 7.
Każda inna wartość wraca do 7. Najpierw testy funkcji, która czyta
parametr. Pokaż wynik testów i build.

W edytorze poniżej czeka panel w miniaturze: przełącz strefę z Warszawy na UTC i zobacz, jak wachta nocna przeskakuje do poprzedniego dnia, a potem zaloguj się jako gość.

Pamiętaj: tablica nawigacyjna jest warta tyle, co pomiary, z których powstała, a test ze strefą czasową sprawdza, czy zegar na mostku chodzi tak jak w porcie.

Kod do tej lekcji: App.jsx
// Panel załogi w miniaturze: dzień w strefie czasowej, karty ze zmianą i wykres z HTML.
// W projekcie funkcje leżą w lib/analytics.ts (z testami), a strona /panel liczy je na serwerze.
import { useState } from 'react';

const REPORT_DAY = '2026-11-14'; // dzień raportu na sztywno, żeby przykład się nie zmieniał

const members = [
  { id: 'u1', name: 'Kapitan Redbeard', role: 'owner' },
  { id: 'u2', name: 'Anne Bonny', role: 'admin' },
  { id: 'u3', name: 'Łukasz Sternik', role: 'member' },
  { id: 'u4', name: 'Jack Rackham', role: 'member' },
  { id: 'u5', name: 'Kupiec z Tortugi', role: 'guest' },
];

const channels = [
  { id: 'c1', name: 'general', isPrivate: false, memberIds: ['u1', 'u2', 'u3', 'u4', 'u5'] },
  { id: 'c2', name: 'treasure-hunts', isPrivate: false, memberIds: ['u1', 'u2', 'u3', 'u4'] },
  { id: 'c4', name: 'handel', isPrivate: false, memberIds: ['u1', 'u2', 'u5'] },
  { id: 'c5', name: 'sekrety-kapitana', isPrivate: true, memberIds: ['u1', 'u2'] },
];

// [kanał, autor, czas w UTC]
const rows = [
  ['c1', 'u1', '2026-11-14T09:00:00.000Z'],
  ['c1', 'u2', '2026-11-14T09:05:00.000Z'],
  ['c2', 'u2', '2026-11-14T10:15:00.000Z'],
  ['c5', 'u1', '2026-11-14T12:05:00.000Z'],
  ['c1', 'u3', '2026-11-13T23:30:00.000Z'], // wachta nocna: 00:30 w Warszawie
  ['c4', 'u5', '2026-11-13T09:20:00.000Z'],
  ['c4', 'u2', '2026-11-13T09:45:00.000Z'],
  ['c1', 'u1', '2026-11-12T08:30:00.000Z'],
  ['c2', 'u4', '2026-11-12T16:45:00.000Z'],
  ['c1', 'u2', '2026-11-11T07:55:00.000Z'],
  ['c2', 'u1', '2026-11-11T13:30:00.000Z'],
  ['c1', 'u4', '2026-11-10T18:20:00.000Z'],
  ['c1', 'u1', '2026-11-08T10:30:00.000Z'],
  ['c1', 'u1', '2026-11-06T09:15:00.000Z'],
  ['c2', 'u2', '2026-11-06T12:40:00.000Z'],
  ['c1', 'u2', '2026-11-04T08:10:00.000Z'],
  ['c5', 'u2', '2026-11-03T17:25:00.000Z'],
];
const messages = rows.map(([channelId, authorId, createdAt], i) => ({ id: 'm' + i, channelId, authorId, createdAt }));

function canSeeChannel(channel, member) {
  if (channel.isPrivate || member.role === 'guest') return channel.memberIds.includes(member.id);
  return true;
}

function dayKey(iso, timeZone) {
  const parts = new Intl.DateTimeFormat('pl-PL', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).formatToParts(new Date(iso));
  const part = (type) => parts.find((p) => p.type === type).value;
  return part('year') + '-' + part('month') + '-' + part('day');
}

function lastDays(endDay, count) {
  const end = Date.parse(endDay + 'T00:00:00.000Z');
  return Array.from({ length: count }, (_, i) => new Date(end - (count - 1 - i) * 86400000).toISOString().slice(0, 10));
}

function percentChange(current, previous) {
  if (previous === 0) return null;
  return Math.round(((current - previous) / previous) * 100);
}

function formatChange(change) {
  if (change === null) return 'brak danych do porównania';
  if (change === 0) return 'bez zmian';
  return change > 0 ? 'wzrost o ' + change + '%' : 'spadek o ' + -change + '%';
}

function barPercent(count, max) {
  return max === 0 ? 0 : (count / max) * 100;
}

function formatDay(day) {
  return new Intl.DateTimeFormat('pl-PL', { day: 'numeric', month: 'short', timeZone: 'UTC' }).format(new Date(day + 'T00:00:00.000Z'));
}

const tone = { up: 'text-green-700', down: 'text-red-700', none: 'text-gray-600' };

export default function App() {
  const [timeZone, setTimeZone] = useState('Europe/Warsaw');
  const [meId, setMeId] = useState('u1');

  const me = members.find((m) => m.id === meId);
  const visible = channels.filter((c) => canSeeChannel(c, me));
  const mine = messages.filter((m) => visible.some((c) => c.id === m.channelId));
  const days = lastDays(REPORT_DAY, 14);
  const inPeriod = (period) => mine.filter((m) => period.includes(dayKey(m.createdAt, timeZone)));
  const week = inPeriod(days.slice(7));
  const before = inPeriod(days.slice(0, 7));
  const authors = (list) => new Set(list.map((m) => m.authorId)).size;
  const stats = [
    { label: 'Wiadomości', value: week.length, previous: before.length },
    { label: 'Aktywni członkowie', value: authors(week), previous: authors(before) },
  ];
  const data = days.slice(7).map((day) => ({ day, count: week.filter((m) => dayKey(m.createdAt, timeZone) === day).length }));
  const max = Math.max(0, ...data.map((d) => d.count));
  const peak = data.find((d) => d.count === max);
  const summary = max === 0
    ? 'Wykres słupkowy: w tym okresie nie było wiadomości.'
    : 'Wykres słupkowy wiadomości dziennie. Najwięcej: ' + formatDay(peak.day) + ', ' + max + '. Dokładne liczby w tabeli pod wykresem.';
  const watch = messages.find((m) => m.createdAt === '2026-11-13T23:30:00.000Z');

  return (
    <div className="min-h-screen bg-gray-50 p-4 text-gray-900">
      <div className="mb-4 flex flex-wrap items-center gap-3 text-sm">
        <label htmlFor="tz">Strefa liczenia dni:</label>
        <select id="tz" value={timeZone} onChange={(e) => setTimeZone(e.target.value)} className="rounded-md border border-gray-300 bg-white px-2 py-1">
          <option value="Europe/Warsaw">Europe/Warsaw (poprawnie)</option>
          <option value="UTC">UTC (jak createdAt.slice(0, 10))</option>
        </select>
        <label htmlFor="me">Zalogowany:</label>
        <select id="me" value={meId} onChange={(e) => setMeId(e.target.value)} className="rounded-md border border-gray-300 bg-white px-2 py-1">
          <option value="u1">Kapitan Redbeard (owner)</option>
          <option value="u5">Kupiec z Tortugi (guest)</option>
        </select>
      </div>
      <p className="mb-4 text-sm text-gray-700">
        Wachta nocna (23:30 UTC, 13 listopada) liczy się do dnia: <strong>{formatDay(dayKey(watch.createdAt, timeZone))}</strong>
      </p>

      <dl className="mb-4 grid gap-3 sm:grid-cols-2">
        {stats.map((stat) => {
          const change = percentChange(stat.value, stat.previous);
          const direction = change === null || change === 0 ? 'none' : change > 0 ? 'up' : 'down';
          return (
            <div key={stat.label} className="rounded-lg border border-gray-200 bg-white p-4">
              <dt className="text-sm text-gray-600">{stat.label}</dt>
              <dd className="text-3xl font-bold">{stat.value}</dd>
              <dd className={'text-sm ' + tone[direction]}>{formatChange(change)}</dd>
            </div>
          );
        })}
      </dl>

      <figure className="rounded-lg border border-gray-200 bg-white p-4">
        <figcaption className="font-semibold">Wiadomości dziennie, 8-14 listopada</figcaption>
        <div role="img" aria-label={summary} className="mt-4 flex gap-2">
          {data.map((d) => (
            <div key={d.day} className="flex flex-1 flex-col items-center">
              <span className="text-xs font-semibold">{d.count}</span>
              <div className="flex h-32 w-full items-end">
                <div className="w-full rounded-t bg-blue-600" style={{ height: barPercent(d.count, max) + '%' }} />
              </div>
              <span className="mt-1 text-xs text-gray-600">{formatDay(d.day)}</span>
            </div>
          ))}
        </div>
        <details className="mt-3 text-sm">
          <summary className="cursor-pointer text-blue-700">Dane wykresu w tabeli</summary>
          <table className="mt-2 w-full text-left">
            <thead>
              <tr className="border-b border-gray-200">
                <th scope="col" className="py-1">Dzień</th>
                <th scope="col" className="py-1">Wiadomości</th>
              </tr>
            </thead>
            <tbody>
              {data.map((d) => (
                <tr key={d.day} className="border-b border-gray-100">
                  <td className="py-1">{formatDay(d.day)}</td>
                  <td className="py-1">{d.count}</td>
                </tr>
              ))}
            </tbody>
          </table>
        </details>
      </figure>
      <p className="mt-3 text-xs text-gray-600">Kanały w panelu: {visible.map((c) => '#' + c.name).join(', ')}</p>
    </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. Wiadomość ma createdAt "2026-11-13T23:30:00.000Z". Do którego dnia panel Ship's Comms powinien ją doliczyć?

  2. 2. Co zwraca percentChange(5, 0), gdy w poprzednim tygodniu nie było żadnej wiadomości?

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

Zadania praktyczne w grze

  • Edytor kodu

    Analytics dashboard z kartami i wykresem

  • Układanie w poziomie

    Ułóż w jednej linii zwrot z barPercent, który daje 0, gdy w całym okresie nie było wiadomości:

  1. PytanieQuiz: Dzień w strefie czasowej
  2. PytanieQuiz: Zmiana bez poprzedniego okresu
  3. Zadanie z kodemPraktyka: Analytics dashboard
  4. Ułóż w kolejnościSortowanie: Wysokość słupka
  5. PytanieQuiz: Kierunek zmiany słowem

Przydatne artykuły