Kurs vibe coding z Claude Code · Moduł 9: Klon Discorda
Logowanie: kto wchodzi na pokład
W tej lekcji10
Otwórz w Cursorze lib/session.ts z lekcji 8_1. Stoi tam const CURRENT_MEMBER_ID = "redbeard", więc każdy, kto otworzy Pirate's Cove, jest kapitanem. Rangi z lekcji 8_3 mówią, co komu wolno, ale aplikacja wciąż nie wie, kto siedzi po drugiej stronie ekranu. Ustalenie, kim jest użytkownik, to uwierzytelnianie, czyli logowanie. Sprawdzenie, co mu wolno, to autoryzacja, którą już masz. W tej lekcji Claude Code doda prawdziwe logowanie, a Ty sprawdzisz, czy zamek naprawdę stoi na serwerze.
Czego się nauczysz
- wybrać bibliotekę logowania według aktualnej dokumentacji, a nie starego poradnika;
- zlecić logowanie z planem i sekretem, którego Claude nigdy nie zobaczy;
- sprawdzić sesję na serwerze w stronach i w trasach API;
- rozpoznać typowy błąd agenta: zamek tylko w komponencie.
Biblioteka: Better Auth
Własny system haseł łatwo zepsuć, dlatego dokumentacja Next.js odsyła do gotowych bibliotek, między innymi Auth0, Better Auth, Clerk i NextAuth.js. Projekt Auth.js, czyli dawny NextAuth.js, jest dziś częścią Better Auth, a jego opiekunowie zalecają nowym projektom Better Auth. Pirate's Cove idzie tą drogą: logowanie e-mailem i hasłem z bazą SQLite w jednym pliku, więc całość działa na Twoim komputerze bez kont w zewnętrznych serwisach.
W starszych poradnikach spotkasz NextAuth.js: npm install next-auth instaluje stabilną wersję 4 z funkcją getServerSession. Auth.js w wersji 5, z jedną funkcją auth() w pliku auth.ts, jest nadal oznaczony jako beta. Poradniki chronią strony plikiem middleware.ts, który w Next.js 16 nazywa się proxy.ts. Gdy agent zaproponuje któryś z tych wzorców, zapytaj, z której dokumentacji go wziął.
Polecenie dla Claude Code
Logowanie dotyka wielu plików, więc budujesz je na osobnej gałęzi logowanie, jak w lekcji 2_9, i zaczynasz od planu, jak w lekcji 8_1.
Polecenie dla Claude Code:
/plan Dodaj logowanie e-mailem i hasłem z Better Auth (better-auth
i better-sqlite3), baza w pliku sqlite.db, według dokumentacji
better-auth.com/docs/integrations/next. Konfiguracja w lib/auth.ts,
trasa app/api/auth/[...all]/route.ts, klient w lib/auth-client.ts,
strona app/sign-in/page.tsx. getCurrentMember() z @lib/session.ts
ma czytać prawdziwą sesję na serwerze i łączyć konto z członkiem po
adresie e-mail (lib/crew-accounts.ts). Bez sesji trasy w app/api
zwracają 401, a strony przekierowują na /sign-in. Pliku .env.local
nie twórz i nie czytaj, uzupełnię go sam. Przygotuj .env.example
z samymi nazwami zmiennych. Na koniec testy, lint, typy i build.W planie sprawdź trzy rzeczy: czy sqlite.db trafi do .gitignore, kto wpisze sekret i czy każda trasa z app/api jest na liście zmian.
Reguła z lekcji 8_4 działa
Pierwsza próba utworzenia .env.example skończyła się u nas odmową: File is covered by a Read deny rule in your permission settings and cannot be written.. Wzorzec Read(./.env.*) obejmuje też plik z samymi nazwami, a reguła Read blokuje również zapis. Dokumentacja pozwala wyciąć wyjątek wzorcem z wykrzyknikiem, który działa jak w .gitignore:
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)", "Read(!.env.example)"]
}
}Wyjątek działa tylko na reguły wypisane przed nim w tym samym pliku. Po tej zmianie Write utworzył .env.example, a odczyt .env.local nadal dostawał odmowę. Ta sama pułapka siedzi w Gicie: git check-ignore -v .env.example wypisał u nas .gitignore:34:.env*, więc wzorzec z create-next-app ukrywa także .env.example. Claude dopisał do .gitignore linię !.env.example.
Sekret, który wpisujesz sam
Better Auth potrzebuje dwóch zmiennych. BETTER_AUTH_SECRET według dokumentacji służy do szyfrowania i haszowania, ma mieć co najmniej 32 znaki i wysoką losowość, a wygenerujesz go komendą:
openssl rand -base64 32Uruchom ją w osobnej karcie terminala w Cursorze, nie przez ! w sesji Claude: dokumentacja Claude Code mówi, że wynik komendy z ! trafia do rozmowy. BETTER_AUTH_URL to adres aplikacji, lokalnie http://localhost:3000. Oba wpisujesz do .env.local, a .env.example pokazuje tylko nazwy.
Co napisał Claude: instancja auth
Otwórz lib/auth.ts:
import Database from "better-sqlite3";
import { betterAuth } from "better-auth";
export const auth = betterAuth({
database: new Database("./sqlite.db"),
emailAndPassword: {
enabled: true,
},
});betterAuth tworzy jeden obiekt, który obsługuje rejestrację, logowanie i sesje. better-sqlite3 to sterownik SQLite polecany w dokumentacji Better Auth, a cała baza to plik sqlite.db w folderze projektu. Tabele utworzyła komenda npx auth@latest migrate --yes, która zgłosiła u nas tabele user, session, account i verification. Hasło nie trafia do bazy jako tekst: u nas w tabeli account w jego miejscu stał długi ciąg cyfr szesnastkowych, czyli skrót.
Claude Code uruchamia komendy w rodzaju npm install czy tej migracji po Twojej zgodzie, a w trybie auto bez pytania. Dlatego przed commitem czytasz git diff: w package.json doszły u nas better-auth, better-sqlite3 i @types/better-sqlite3.
Trasa z dokumentacji ma trzy linie i obsługuje wszystkie adresy pod /api/auth:
import { toNextJsHandler } from "better-auth/next-js";
import { auth } from "@/lib/auth";
export const { GET, POST } = toNextJsHandler(auth);lib/auth-client.ts tworzy klienta przez createAuthClient() z better-auth/react. Strona /sign-in woła authClient.signIn.email albo authClient.signUp.email i po sukcesie przechodzi na panel rang.
Co napisał Claude: sesja na serwerze
Najważniejsza zmiana stoi w lib/session.ts:
export async function getCurrentMember(): Promise<Member | null> {
const session = await auth.api.getSession({ headers: await headers() });
if (!session) return null;
const memberId = crewAccounts.get(session.user.email);
return memberId ? (findMember(mainServer, memberId) ?? null) : null;
}headers() z next/headers daje nagłówki bieżącego żądania, w tym ciasteczko sesji, a auth.api.getSession sprawdza je w bazie. Bez ważnej sesji funkcja zwraca null. Konto łączy się z członkiem serwera przez mapę adresów w lib/crew-accounts.ts, na przykład anne@pirates-cove.test to anne.
Typ Member | null od razu pracuje na Ciebie. npx tsc --noEmit wskazał u nas 11 miejsc w 6 plikach, które zakładały, że członek zawsze istnieje, na przykład Argument of type 'Member | null' is not assignable to parameter of type 'Member'. Każda trasa dostała na początku zamek:
const me = await getCurrentMember();
if (!me) {
return Response.json({ error: "Zaloguj się" }, { status: 401 });
}Kod 401 znaczy "nie wiem, kim jesteś", a 403 z lekcji 8_3 "wiem, ale nie wolno ci". Strony, w tym panel rang, robią w tym miejscu redirect("/sign-in"), a test trasy wyrzucania dostał przypadek "bez sesji 401".
Discord jako druga brama
Discord dochodzi samą konfiguracją w lib/auth.ts, gdy zechcesz:
socialProviders: {
discord: {
clientId: process.env.DISCORD_CLIENT_ID as string,
clientSecret: process.env.DISCORD_CLIENT_SECRET as string,
},
},Według dokumentacji Better Auth w Discord Developer Portal rejestrujesz adres powrotu http://localhost:3000/api/auth/callback/discord, a na produkcji ten sam adres z Twoją domeną. Bez tych zmiennych build wypisał u nas ostrzeżenie Social provider discord is missing clientId or clientSecret.
Przegląd kapitana
- Sekrety poza Gitem. Przed poprawką
.gitignorepoleceniegit status --shortpokazało u nas?? sqlite.db. Ten plik trzyma konta i sesje, więc nie może trafić do repozytorium. Po poprawcegit statusnie pokazuje ani bazy, ani.env.local. - Bezpośrednie wejście bez sesji. Otwórz panel rang w oknie prywatnym. U nas
curl -ina ten adres dał307zlocation: /sign-in, ciasteczko z podrobionym tokenem też, aPOST /api/members/blackbeard/kickbez ciasteczka dostał401i{"error":"Zaloguj się"}. - Rangi po zalogowaniu. Anne, oficer bez
MANAGE_ROLES, dostała na panelu rang 404, a próba wyrzucenia kapitana skończyła się 403. Kapitan zobaczył panel i wyrzucił Blackbearda. - Typowy błąd agenta: zamek tylko w komponencie. Sprawdziliśmy go na liście załogi z adresami e-mail, którą agent dopisał do panelu rang. Client Component chował listę, gdy
authClient.useSession()nie miał sesji, ale dane brał z nowej trasy/api/crew, która sesji nie sprawdzała. Na ekranie wszystko wyglądało dobrze, acurlbez ciasteczka dostał od tej trasy200i adresy całej załogi. Dokumentacja Next.js każe traktować każdą trasę API jak publiczny endpoint, a Better Auth przypomina, że sesję trzeba sprawdzać na serwerze przy każdej chronionej stronie i akcji.
Na koniec testy, npm run lint, npx tsc --noEmit po npx next typegen i npm run build. Kroki w przeglądarce sprawdzasz na żywo: rejestracja, logowanie i wejście na panel bez sesji.
Następny krok
Poproś o commit, na przykład "Logowanie Better Auth, sesja na serwerze, 401 w trasach". Pirate's Cove ma teraz wszystko z mapy tej lokacji, zbudowane w tej kolejności: model serwera z kanałami, kanał głosowy ze statusem, rangi z zamkiem w trasach, pogodę z kluczem w ładowni i logowanie. Jeśli w Twoim projekcie powstała podobna lista albo inna trasa bez zamka, zapisz ją, ale jeszcze nie poprawiaj: w następnej lekcji sprawdzisz, czy przegląd bezpieczeństwa znajdzie ją sam.
W edytorze poniżej czeka symulacja portu z logowaniem: wejdź na panel bez sesji, zaloguj się jako różni piraci i włącz błąd agenta, w którym lista załogi ma zamek tylko na ekranie.
Pamiętaj: strażnik przy trapie pyta każdego o imię, a strażnik malowany na drzwiach tylko dobrze wygląda.
Kod do tej lekcji: App.jsx
// Port z logowaniem: ciasteczko sesji, getCurrentMember() i dwie trasy na udawanym serwerze.
// Hasła i konta są zmyślone; nic nie wychodzi do sieci.
import { useState } from 'react';
const crew = [
{ email: 'redbeard@pirates-cove.test', memberId: 'redbeard', name: 'Kapitan Redbeard', canManageRoles: true },
{ email: 'anne@pirates-cove.test', memberId: 'anne', name: 'Anne Bonny (Oficer)', canManageRoles: false },
{ email: 'jack@pirates-cove.test', memberId: 'jack', name: 'Jack Rackham (Załoga)', canManageRoles: false },
];
// Serwer: sesje w "bazie" i getCurrentMember jak w lib/session.ts.
const sessions = new Map();
function getCurrentMember(cookie) {
const email = cookie ? sessions.get(cookie) : undefined;
if (!email) return null;
return crew.find((c) => c.email === email) ?? null;
}
function rolesPage(cookie) {
const me = getCurrentMember(cookie);
if (!me) return { status: 307, body: 'location: /sign-in' };
if (!me.canManageRoles) return { status: 404, body: 'Nie znaleziono strony' };
return { status: 200, body: 'Panel rang dla: ' + me.name };
}
function crewRoute(cookie, buggy) {
if (!buggy && !getCurrentMember(cookie)) {
return { status: 401, body: JSON.stringify({ error: 'Zaloguj się' }) };
}
return { status: 200, body: JSON.stringify(crew.map((c) => c.email)) };
}
export default function App() {
const [cookie, setCookie] = useState(null);
const [buggy, setBuggy] = useState(true);
const [answers, setAnswers] = useState([]);
function signIn(email) {
const token = 'sesja-' + email.split('@')[0];
sessions.set(token, email);
setCookie(token);
}
function request(label, res) {
setAnswers((prev) => [label + ' → ' + res.status + ' ' + res.body, ...prev].slice(0, 6));
}
const me = getCurrentMember(cookie);
const screenCrew = me ? JSON.parse(crewRoute(cookie, buggy).body) : null;
return (
<div className="min-h-screen space-y-4 bg-slate-100 p-4 font-sans text-slate-900">
<section className="space-y-2 rounded-lg bg-slate-800 p-4 text-slate-100">
<h1 className="font-bold">Wejście na pokład</h1>
<p className="text-sm">Zalogowany: {me ? me.name : 'nikt'} {cookie ? '(ciasteczko: ' + cookie + ')' : ''}</p>
<div className="flex flex-wrap gap-2">
{crew.map((c) => (
<button key={c.email} onClick={() => signIn(c.email)} className="rounded bg-indigo-600 px-3 py-1 text-sm">Zaloguj: {c.memberId}</button>
))}
<button onClick={() => setCookie(null)} className="rounded border border-slate-400 px-3 py-1 text-sm">Wyloguj</button>
</div>
</section>
<section className="rounded-lg border border-slate-300 bg-white p-3">
<h2 className="font-bold">Ekran: lista załogi na panelu</h2>
<p className="text-xs text-slate-500">Komponent chowa listę, gdy useSession() nie ma sesji.</p>
{screenCrew ? (
<ul className="mt-2 list-disc pl-5 text-sm">{screenCrew.map((e) => <li key={e}>{e}</li>)}</ul>
) : (
<p className="mt-2 text-sm italic">Lista ukryta.</p>
)}
</section>
<label className="flex items-center gap-2 text-sm">
<input type="checkbox" checked={buggy} onChange={(e) => setBuggy(e.target.checked)} />
Błąd agenta: /api/crew nie sprawdza sesji, zamek stoi tylko w komponencie
</label>
<section className="space-y-2 rounded-lg border border-slate-300 bg-white p-3">
<h2 className="font-bold">Żądania prosto do serwera</h2>
<div className="flex flex-wrap gap-2 text-sm">
<button onClick={() => request('GET /servers/black-pearl/settings/roles', rolesPage(cookie))} className="rounded bg-slate-700 px-3 py-1 text-white">Otwórz panel rang</button>
<button onClick={() => request('curl /api/crew (bez ciasteczka)', crewRoute(null, buggy))} className="rounded bg-red-600 px-3 py-1 text-white">curl /api/crew bez ciasteczka</button>
<button onClick={() => request('GET /servers/... z podrobionym ciasteczkiem', rolesPage('podrobione'))} className="rounded bg-slate-700 px-3 py-1 text-white">Podrobione ciasteczko</button>
</div>
<ul className="space-y-1 font-mono text-xs">{answers.map((a, i) => <li key={i}>{a}</li>)}</ul>
</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. Jak getCurrentMember() z lib/session.ts ustala po lekcji o logowaniu, kto jest zalogowany?
2. Co się dzieje, gdy ktoś bez sesji otworzy adres panelu rang?
Zadania praktyczne w grze
- Układanie w poziomie
Ułóż odczyt adresu zalogowanego pirata: session.user.email
- Klikanie w kolejności
Klikaj, aby zbudować pobranie sesji na serwerze: await auth.api.getSession({ headers: await headers() })
- Układanie w pionie
Ułóż kolejność, w jakiej powstawał Pirate's Cove w tej lokacji: