Konsola
Powierzchnia po zalogowaniu: do czego służy każda strona, kto może co zmieniać i co mówi wdrożenie bez hostowanej konsoli, zamiast linkować do trasy, która zwróciłaby 404.
Do czego służy każda strona konsoli
| Strona | Ścieżka | Cel |
|---|---|---|
| Pulpit | /app | Saldo, dzisiejsze wydatki, sumy wywołań, ostatnie ślady i domyślna rezydencja organizacji. |
| Modele | /app/models | Kandydujące punkty końcowe podzielone na wywoływalne, zablokowane przez obowiązującą politykę i tylko katalogowe; zablokowany wiersz zawiera własny powód routera. |
| Klucze API | /app/keys | Utwórz klucz z jego zakresami, skopiuj sekret jednorazowo i odwołaj klucze. |
| Plac zabaw | /app/playground | Wyślij podpowiedź przez prawdziwy router; konsola wywołuje API po stronie serwera, więc klucz nigdy nie trafia do przeglądarki. |
| Ślady | /app/traces | Metadane poszczególnych wywołań: model, region, powód wyboru trasy, opóźnienie i koszt, a obok listy widnieje obowiązujący okres przechowywania. |
| Użycie | /app/usage | Wywołania, tokeny i wydatki według dnia i modelu. |
| Zasady | /app/policies | Rezydencja, listy dozwolonych/zabronionych dostawców i modeli, limity cen i wartość retencji przechowywana przez zasady. |
| Ustawienia | /app/settings | Nazwa organizacji, domyślna rezydencja danych, domyślny okres przechowywania i język konsoli. |
| Rezydencja | /app/settings/residency | Które punkty końcowe dopuszcza dana polityka, a które wykluczył router, wraz z uzasadnieniem routera. |
| Eksporty | /app/exports | Pobierz traces.json, usage.json, policies.json, szablon DPA i pakiet audytu NDJSON. |
| Profil | /app/profile | Twoje własne konto: nazwa, język, e-mail, hasło, weryfikacja, sesje i usunięcie konta. |
| Rozliczenia | /app/billing | Saldo, wydatki w tym miesiącu i plan. Dodawanie środków to formularz, który pojawia się tylko wtedy, gdy wdrożenie go włączy. |
| Zespół | /app/team | Członkowie i role oraz zaproszenia; link z zaproszeniem jest wyświetlany, aby można go było skopiować ręcznie. |
Kto może co zmieniać
Konsola egzekwuje dwa zestawy ról. owner i admin zarządzają; developer może zapisywać; viewer ma dostęp tylko do odczytu.
- Zarządzanie (owner, admin): zasady, zespół, ustawienia, środki, unieważnianie kluczy oraz tworzenie klucza z zakresem platform_write.
- Zapis (developer): tworzenie kluczy wnioskowania i wydawanie środków organizacji przez playground, ale bez prawa do zarządzania.
- Tylko odczyt (viewer): strony i ślady można odczytywać; playground jest odrzucany.
- Zbiorcze pobieranie danych organizacji (traces.json, usage.json, policies.json, audit.ndjson) wymaga roli z prawem zapisu; me.json to eksport własnego konta wywołującego i jest dostępny dla każdego członka.
Twoje własne konto
Te działania zapisują wyłącznie wiersze kluczowane identyfikatorem użytkownika sesji, więc żadne pole formularza nie może ich skierować na inną osobę.
- Nazwa wyświetlana i język konsoli.
- Adres e-mail: jego zmiana wymaga aktualnego hasła, a nowy adres zaczyna jako niezweryfikowany, ponieważ poprzedni dowód dotyczył starego adresu.
- Hasło: co najmniej 12 znaków, dolny limit w packages/shared/src/limits.mjs; jego zmiana wylogowuje wszystkie inne sesje i unieważnia oczekujące linki do resetowania.
- Weryfikacja adresu e-mail: żądanie wymaga skonfigurowanego transportu poczty; bez niego strona informuje, że to wdrożenie nie może go obsłużyć.
- Lista zalogowanych sesji, każdą można odwołać, plus jedna kontrolka, która wylogowuje wszystkie inne przeglądarki i zachowuje tę; bieżącej sesji nie można odwołać z listy.
- Usunięcie konta: odmawiane, gdy jesteś jedynym właścicielem organizacji, która ma jeszcze innych członków lub niezerowe saldo środków, a odmowa wskazuje nazwę organizacji.
Konsola to wdrożenie
Konsola jest faktem wdrożeniowym, a nie stroną publiczną. Jej bazowy URL pochodzi z PUBLIC_CONSOLE_URL, a renderer nigdy go nie zgaduje.
consoleHref(’/signup’) to kształt linku: zwraca origin konsoli plus trasę lub null, gdy konsola nie jest skonfigurowana.
Płatności kartą wymagają flagi stripe_enabled we wdrożeniu. Strona bezpieczeństwa odnotowuje, że obsługa kredytu przyjmuje przesłaną kwotę bez weryfikacji płatności, a flaga musi pozostać wyłączona, dopóki to nie zostanie naprawione i przetestowane.