Moje nerdy (Digital Twins)
Rejestr i konfigurator cyfrowych bliźniaków (Digital Twins). Pozwala na łączenie tożsamości przeglądarek, subskrypcji AI i narzędzi programistycznych w spójne profile przypisane do projektów i maszyn.
1. Diagramy Procesów i Architektury
A. Topologia nawigacji i wywołań akcji
flowchart TD
subgraph S["Kontekst: WORK"]
V["Widok: Moje nerdy (Digital Twins)
Przełączanie widoku między kafelkami, tabelą a dodawaniem"] A_1["record.save
Przygotowanie planu zapisu konfiguracji nerda (IaC)"] A_2["record.delete
Przygotowanie planu usunięcia tożsamości nerda"] A_3["projects.fetch
Pobranie listy projektów z podłączonych integracji API"] A_4["project.set
Przypisanie wybranego projektu do formularza nerda"] end V --> A_0 V --> A_1 V --> A_2 V --> A_3 V --> A_4
?view=accounts"]
end
subgraph Actions["Dostępne akcje i procedury CQRS"]
A_0["collection.tabPrzełączanie widoku między kafelkami, tabelą a dodawaniem"] A_1["record.save
Przygotowanie planu zapisu konfiguracji nerda (IaC)"] A_2["record.delete
Przygotowanie planu usunięcia tożsamości nerda"] A_3["projects.fetch
Pobranie listy projektów z podłączonych integracji API"] A_4["project.set
Przypisanie wybranego projektu do formularza nerda"] 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
[*] --> ListCards : Otwarcie listy nerdów
ListCards --> AddNerd : Kliknij Dodaj Nerda
AddNerd --> FetchProjects : Pobierz projekty z API
FetchProjects --> FillForm : Wybór projektu i usług
FillForm --> PlanCreation : Przygotuj plan
PlanCreation --> ApprovedRuntime : Zatwierdzenie planu
ApprovedRuntime --> ActiveTwin : Nerd aktywny w środowisku
ActiveTwin --> [*]
C. Sekwencja wykonania CQRS
sequenceDiagram
autonumber
actor U as Użytkownik / Agent
participant UI as Interfejs (Moje nerdy (Digital Twins))
participant CQRS as Dyspozytor CQRS
participant API as Backend API (:8891)
participant DB as Baza / Runtime
U->>UI: Kliknięcie / Wywołanie akcji [collection.tab]
UI->>CQRS: dispatch('collection.tab', 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 |
|---|---|---|---|
collection.tab | proc://clonerd.dev/cmd/collection/tab/v1 | urn:clonerd:code:js:actions:collection#switchTab | Przełączanie widoku między kafelkami, tabelą a dodawaniem |
record.save | proc://clonerd.dev/cmd/record/save/v1 | urn:clonerd:code:js:actions:collection#saveRecord | Przygotowanie planu zapisu konfiguracji nerda (IaC) |
record.delete | proc://clonerd.dev/cmd/record/delete/v1 | urn:clonerd:code:js:actions:collection#deleteRecord | Przygotowanie planu usunięcia tożsamości nerda |
projects.fetch | proc://clonerd.dev/cmd/projects/fetch/v1 | urn:clonerd:code:js:actions:projects#fetch | Pobranie listy projektów z podłączonych integracji API |
project.set | proc://clonerd.dev/cmd/project/set/v1 | urn:clonerd:code:js:actions:projects#set | Przypisanie wybranego projektu do formularza nerda |
3. Powiązane Endpointy API
| Metoda | Ścieżka REST | Opis |
|---|---|---|
| GET | /api/records | Pobranie zarejestrowanych nerdów |
| POST | /api/plans | Przygotowanie audytowalnego planu zmiany nerda |
| GET | /api/projects | Lista projektów zintegrowanych z platformą |