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
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?