← Wszystkie widoki i mapa menu

Połączenia API

Rejestr i konfigurator połączeń z zewnętrznymi API AI (OpenAI, Anthropic, Gemini, Ollama, Cloudflare, Hetzner). Zapewnia szyfrowane przechowywanie kluczy i bezpieczną rotację.

Kontekst (Surface) MANAGER

Kanoniczny URI proc://clonerd.com/ui/connectors/v1

URN Implementacji urn:clonerd:code:js:views:connectors

Wzorzec URL /?view=connectors&tab={cards|table|add|edit}&item={id}&surface=manager

1. Diagramy Procesów i Architektury

A. Topologia nawigacji i wywołań akcji

flowchart TD subgraph S["Kontekst: MANAGER"] V["Widok: Połączenia API
?view=connectors"] end subgraph Actions["Dostępne akcje i procedury CQRS"] A_0["platform.status-set
Włączenie lub wyłączenie konektora API"] A_1["platform.delete
Usunięcie zarejestrowanego połączenia"] end V --> A_0 V --> A_1

B. Maszyna stanów i cykl życia operacji

stateDiagram-v2 [*] --> Idle : Wejście do widoku Połączenia API 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 (Połączenia API) participant CQRS as Dyspozytor CQRS participant API as Backend API (:8891) participant DB as Baza / Runtime U->>UI: Kliknięcie / Wywołanie akcji [platform.status-set] UI->>CQRS: dispatch('platform.status-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
`platform.status-set`	`proc://clonerd.dev/cmd/platform/status/v1`	`urn:clonerd:code:js:actions:platform#setStatus`	Włączenie lub wyłączenie konektora API
`platform.delete`	`proc://clonerd.dev/cmd/platform/delete/v1`	`urn:clonerd:code:js:actions:platform#deleteRecord`	Usunięcie zarejestrowanego połączenia

3. Powiązane Endpointy API

Metoda	Ścieżka REST	Opis
GET	`/api/connectors`	Wykaz konektorów przypisanych do zespołów
POST	`/api/connectors`	Zapis nowego bezpiecznego połączenia