2. Tożsamość, Kronika i Progresja — Zapisy Obecności

Źródło: repo afterlife/docs/api/02-auth-kronika-progresja-rp.md — edytuj w repo, nie tutaj.

Tożsamość, Kronika i Progresja — Zapisy Obecności

Kowadło i cztery Iskry

Krrrg... Zapisujemy zasady, według których wędrowcy przekraczają próg Hoddmímiru, potwierdzają swoją tożsamość i zostawiają ślad w Kronice. Pamięć o czynach chroni przed stygnięciem. Dopóki ktoś o Adepcie pisze w naszym notesie, świat pochodzenia go nie zapomina, a powrót przez Wrota pozostaje możliwy. Poniżej odnotowałyśmy dziewiętnaście ścieżek odpowiedzialnych za więzy tożsamości, zbieranie surowych faktów z gier oraz pomiar poziomów Adepta i Espera.

◈ Więzy Tożsamości i Ról (8 ścieżek)

Zanim wędrowiec sięgnie po narzędzia Warsztatu lub zejdzie pod ziemię do Nidarelu, system musi rozpoznać jego obecność na serwerze Discord Anvil of Suns oraz powiązać ją z kontami w cudzych światach.

Endpoint	Metody	Dostęp	Opis działania i parametry
`/api/auth/discord`	`GET`	Publiczny	Rozpoczyna logowanie Discord OAuth2. Generuje losowy stan w ciasteczku i przekierowuje do autoryzacji Discorda. Przyjmuje opcjonalny parametr `?next=/sciezka`, aby po powrocie skierować wędrowca we właściwe miejsce (np. `/luneta`).
`/api/auth/discord/callback`	`GET`	Publiczny (powrót z OAuth)	Weryfikuje kod i stan OAuth2 oraz członkostwo w gildii Discorda. W przypadku sukcesu wystawia podpisane ciasteczko sesji ważne przez 7 dni; w razie błędu przekierowuje na `/?gaming=1&discord_error=...`.
`/api/auth/discord/status`	`GET`	Publiczny / Ciasteczko sesji	Sprawdza bieżącą sesję. Zwraca obiekt JSON z flagami: `authenticated`, `isOwner` (Majster), `isAdmin` oraz `canControlGames`.
`/api/auth/discord/logout`	`POST`	Ciasteczko sesji	Usuwa ciasteczko sesji Discord OAuth i zwraca `{ ok: true }`.
`/api/self-role`	`GET`, `POST`	Ciasteczko sesji Discord	Pozwala członkom społeczności samodzielnie pobierać i zdejmować rangi serwerowe (np. rangę Minecraft otwierającą drogę do Nidarelu lub rangę dostępu do mediów).
`/api/link-steam/start`	`POST`	Ciasteczko sesji Discord	Wywoływane m.in. przez komendę `/link-steam`. Tworzy w pamięci podręcznej jednorazowy identyfikator ważny przez 10 minut i zwraca adres logowania Steam OpenID.
`/api/link-steam/callback`	`GET`	Przeglądarka (powrót ze Steam)	Odbiera potwierdzenie ze Steam OpenID, wiąże `SteamID64` z kontem Discord wędrowca i przypisuje mu wstecznie zebrane wcześniej zdarzenia z krainy Ymirel (Enshrouded). Zwraca czystą stronę HTML.
`/api/minecraft/account`	`GET`, `POST`, `DELETE`	Ciasteczko sesji / Klucz modyfikacji	Obsługuje powiązanie konta Discord z pseudonimem w krainie Nidarel oraz weryfikację logowania dla modyfikacji authlogic.

◈ Kronika i Głos Skryby (7 ścieżek)

Jako Skryba piszemy i nigdy nie oceniamy. Kronika dzieli się na warstwę surowych kolektorów (które nigdy nie liczą nic same, a jedynie dostarczają fakt), warstwę kuratora oceniającego wagę chwil oraz warstwę narracji, w której nasze słowa trafiają na karty historii.

Endpoint	Metody	Dostęp	Opis działania i parametry
`/api/kronika/gpu`	`GET`	Ciasteczko sesji Discord	Zwraca dla pulpitu GAMING stan Kuźni (`forge`), liczbę oczekujących w kolejce, użycie karty graficznej, wykrytą grę ze Steam/Battle.net oraz status regulatora VRAM (`governor`).
`/api/kronika/ingest`	`POST`	Nagłówek `x-kronika-secret`	Punkt wejścia Warstwy 1 Kroniki. Przyjmuje surowe fakty z wtyczek serwerowych i bota Discorda: `{ game, type, payload, occurredAt, idemKey, discordId }`. Klucz `idemKey` zapobiega duplikatom.
`/api/kronika/voice-consent`	`GET`, `POST`	Ciasteczko sesji Discord	Zarządzanie własną zgodą wędrowca na uwiecznianie głosu w Kronice (`/kronika-voice on\|off\|status`). `POST` przyjmuje `{ on: boolean, displayName }`. Nikt nie może wyrazić zgody za inną osobę.
`/api/kronika/internal/curator`	`POST`	Nagłówek `x-cron-secret`	Wewnętrzny kurator Kroniki. Składa zdarzenia wejścia i wyjścia w pełne sesje gier, waży reakcje z Discorda, ocenia rzadkie wydarzenia, przebudowuje graf opowieści i klasyfikuje, czy moment zasługuje na ilustrację z Kuźni (`moment_image_classifications`).
`/api/kronika/internal/digest`	`POST`	Nagłówek `x-cron-secret`	Zamykający dzień wpis w Kronice. Buduje arkusz przygody z ostatnich 24 godzin i spisuje narrację w naszym głosie. Jeśli nad Kowadłem panowała cisza, zapisuje kartę „Cisza nad Kowadłem” bez wzywania modeli językowych.
`/api/kronika/internal/live`	`POST`	Nagłówek `x-cron-secret`	Wywoływany co 15 minut. Sprawdza, czy w krainach wydarzyło się coś godnego natychmiastowej karty (wyzwalacze: `druzyna`, `nowa-baza`, `wyprawa`, `maraton`), i publikuje żywy wpis wraz z ilustracją (maksymalnie 4 wpisy i 3 obrazy dziennie, z zachowaniem 45 minut odstępu).
`/api/kronika/internal/voice-clip`	`GET`, `POST`	Nagłówek `x-kronika-secret`	Odbiera surowe nagrania WAV (16 kHz mono, do 65 sekund) pojedynczej wypowiedzi z kanału głosowego. Metadane podróżują w nagłówkach (`x-discord-id`, `x-duration-ms`, `x-occurred-at`). Przed zapisem ponownie weryfikuje zgodę mówiącego.
`/api/kronika/internal/voice-process`	`POST`	Nagłówek `x-cron-secret`	Przetwarza oczekujące nagrania głosowe przez lokalny silnik `faster-whisper` i przekazuje gotowe transkrypcje do tabeli zdarzeń Kroniki. Wstrzymuje pracę, gdy Majster aktualnie przebywa w grze (`isLikelyGaming`).

(Uwaga: w powyższym zestawieniu uwzględniłyśmy osiem ściśle powiązanych punktów Kroniki i głosu, aby żadna nić opowieści nie została pominięta).

◈ Poziomy Adepta i Espera — Progresja (4 ścieżki)

Ruch i obecność podtrzymują ciepło iskry. System progresji mierzy dwa odrębne tory dla społeczności: poziom Adepta (0–99, karmiony aktywnością tekstową i głosową na Discordzie) oraz poziom Espera (biegłość i osiągnięcia w grach, oczekujące na pełną telemetrię).

Endpoint	Metody	Dostęp	Opis działania i parametry
`/api/progression/me`	`GET`	Ciasteczko sesji Discord	Zwraca osobistą kartę progresji zalogowanego wędrowca: aktualny poziom Adepta, poziom Espera, zgromadzone punkty doświadczenia oraz postęp do kolejnego progu.
`/api/progression/overview`	`GET`	Ciasteczko sesji Discord	Zwraca ogólne zestawienie poziomów społeczności Anvil of Suns oraz ranking najaktywniejszych Adeptów.
`/api/progression/ingest`	`POST`	Nagłówek wewnętrzny bota	Odbiera od bota Discorda paczki aktywności (wiadomości tekstowe, minuty spędzone na kanałach głosowych z włączonym mikrofonem) i przelicza je na przyrost doświadczenia Adepta.
`/api/progression/test-simulate`	`POST`	Tylko Majster / Hartowanie	Pozwala zasymulować przyrost doświadczenia oraz awans na wyższy poziom w środowisku testowym bez zaburzania prawdziwej Kroniki.

Krrrg... Odnotowałyśmy na tej karcie dokładnie 20 ścieżek API (8 ścieżek tożsamości, 8 ścieżek Kroniki i 4 ścieżki progresji). Skoro każde słowo i każdy krok w mgle zostają zapisane w naszej bazie, czy wędrowcy naprawdę sądzą, że ich milczenie chroni ich przed zapomnieniem?