Ustawienia
Dostosowanie motywu (Dark, Light, Warm), układu (Desktop, Mobile, Chat), zarządzanie poświadczeniami logowania, zmiana hasła oraz status integracji runtime LLM Account Hub.
1. Diagramy Procesów i Architektury
A. Topologia nawigacji i wywołań akcji
flowchart TD
subgraph S["Kontekst: CONFIG"]
V["Widok: Ustawienia
Natychmiastowa zmiana palety barw interfejsu"] A_1["layout.set
Wybór sposobu organizacji ekranu (desktop / onepage)"] A_2["preferences.save
Trwały zapis preferencji na koncie użytkownika"] A_3["auth.profile
Zmiana wyświetlanej nazwy konta"] A_4["auth.password
Bezpieczna aktualizacja hasła do konta"] end V --> A_0 V --> A_1 V --> A_2 V --> A_3 V --> A_4
?view=settings"]
end
subgraph Actions["Dostępne akcje i procedury CQRS"]
A_0["theme.setNatychmiastowa zmiana palety barw interfejsu"] A_1["layout.set
Wybór sposobu organizacji ekranu (desktop / onepage)"] A_2["preferences.save
Trwały zapis preferencji na koncie użytkownika"] A_3["auth.profile
Zmiana wyświetlanej nazwy konta"] A_4["auth.password
Bezpieczna aktualizacja hasła do konta"] end V --> A_0 V --> A_1 V --> A_2 V --> A_3 V --> A_4
B. Maszyna stanów i cykl życia operacji
stateDiagram-v2
[*] --> Idle : Wejście do widoku Ustawienia
Idle --> FormOrFilter : Interakcja z kontrolkami
FormOrFilter --> CQRSCommand : Wywołanie akcji
CQRSCommand --> StateUpdated : Aktualizacja stanu i API
StateUpdated --> Idle : Odświeżenie widoku
C. Sekwencja wykonania CQRS
sequenceDiagram
autonumber
actor U as Użytkownik / Agent
participant UI as Interfejs (Ustawienia)
participant CQRS as Dyspozytor CQRS
participant API as Backend API (:8891)
participant DB as Baza / Runtime
U->>UI: Kliknięcie / Wywołanie akcji [theme.set]
UI->>CQRS: dispatch('theme.set', data)
CQRS->>API: Żądanie HTTP REST / RPC
API->>DB: Mutacja / Odczyt stanu
DB-->>API: Potwierdzenie zapisu
API-->>CQRS: Wynik operacji + ślad zdarzenia
CQRS-->>UI: Aktualizacja stanu (state)
UI-->>U: Re-render widoku i powiadomienie (toast)
2. Zarejestrowane Polecenia CQRS
| Akcja UI | Procedura URI | URN w kodzie | Opis |
|---|---|---|---|
theme.set | proc://clonerd.dev/cmd/ui/theme/v1 | urn:clonerd:code:js:actions:navigation#setTheme | Natychmiastowa zmiana palety barw interfejsu |
layout.set | proc://clonerd.dev/cmd/ui/layout/v1 | urn:clonerd:code:js:actions:navigation#setLayout | Wybór sposobu organizacji ekranu (desktop / onepage) |
preferences.save | proc://clonerd.dev/cmd/preferences/save/v1 | urn:clonerd:code:js:actions:settings#savePrefs | Trwały zapis preferencji na koncie użytkownika |
auth.profile | proc://clonerd.dev/cmd/auth/profile/v1 | urn:clonerd:code:js:actions:auth#updateProfile | Zmiana wyświetlanej nazwy konta |
auth.password | proc://clonerd.dev/cmd/auth/password/v1 | urn:clonerd:code:js:actions:auth#changePassword | Bezpieczna aktualizacja hasła do konta |
3. Powiązane Endpointy API
| Metoda | Ścieżka REST | Opis |
|---|---|---|
| POST | /api/auth/profile | Aktualizacja nazwy konta |
| POST | /api/auth/password | Zmiana hasła użytkownika |