BetterDesk/MGMT_CLIENT_PROMPT.md

Prompt: BetterDesk MGMT Client

Cel

Na bazie istniejącego projektu UNITRONIX/BetterDesk utwórz nowy, wydzielony typ klienta o nazwie BetterDesk MGMT Client (klient administracyjno-operatorski), którego zadaniem jest zapewnienie administratorom i operatorom centrum wsparcia zdalnego pełnego, bezpiecznego i wysokowydajnego dostępu do urządzeń podłączonych do serwera BetterDesk.

Klient MGMT ma być aplikacją typu standalone, zoptymalizowaną pod kątem:

• maksymalnej jakości obrazu,
• niskich opóźnień,
• szerokiego wsparcia kodeków,
• stabilności połączeń,
• zgodności z różnymi systemami operacyjnymi,
• bezpieczeństwa operacyjnego i kryptograficznego,
• centralnego zarządzania infrastrukturą BetterDesk.

Główna rola klienta MGMT

Klient MGMT to narzędzie dla administratorów, helpdesku, operatorów i personelu wsparcia technicznego. Ma umożliwiać:

1. zdalne łączenie się do klientów typu Agent,
2. wyświetlanie listy urządzeń zarejestrowanych nie tylko w BetterDesk, ale również – jeśli architektura projektu na to pozwala – urządzeń pochodzących z integracji z RustDesk,
3. zarządzanie serwerem BetterDesk z poziomu aplikacji,
4. prowadzenie czatu z użytkownikami i agentami podłączonymi do serwera,
5. odbieranie powiadomień o prośbach o pomoc,
6. nadzorowanie i obsługę scenariuszy CDAP (narzędzie operatora do zdalnej pomocy i zarządzania),
7. zapewnienie maksymalnej jakości i płynności transmisji obrazu dzięki pełnemu wykorzystaniu dostępnych technologii projektu.

Wymagania architektoniczne

Przeanalizuj aktualną architekturę repozytorium BetterDesk i zaprojektuj klienta MGMT tak, aby:

• wykorzystywał maksymalnie istniejące komponenty i protokoły projektu,
• nie dublował logiki już obecnej w backendzie i usługach serwera,
• wydzielał warstwę GUI od warstwy komunikacyjnej,
• wspierał modularność,
• umożliwiał dalszą rozbudowę o dodatkowe kodeki, integracje i mechanizmy polityk bezpieczeństwa.

Zaproponuj architekturę, która może wykorzystywać:

• frontend oparty o obecne zasoby JavaScript/HTML/CSS,
• wydajny backend/bridge lokalny w Go tam, gdzie wymagana jest wydajność, natywna integracja systemowa, streaming, zarządzanie procesami i funkcje bezpieczeństwa,
• skrypty Shell/PowerShell do instalacji, detekcji środowiska i działań administracyjnych per system operacyjny.

Kluczowe funkcje klienta MGMT

1. Panel urządzeń

Klient MGMT ma prezentować zunifikowaną listę urządzeń:

• online/offline,
• typ urządzenia,
• system operacyjny,
• wersja klienta,
• nazwa hosta,
• adresy sieciowe,
• status bezpieczeństwa,
• ostatnie połączenie,
• tagi, grupy, lokalizacje, właściciel urządzenia,
• źródło urządzenia: BetterDesk / integracja RustDesk / inne przyszłe źródła.

Lista ma wspierać:

• wyszukiwanie,
• filtrowanie,
• sortowanie,
• grupowanie,
• widoki administracyjne,
• szybkie akcje masowe.

2. Zdalna sesja premium

Połączenie z klientem Agent ma oferować:

• maksymalną jakość obrazu,
• adaptacyjny bitrate,
• dynamiczne dopasowanie rozdzielczości,
• szerokie wsparcie kodeków zależnie od możliwości systemu i sprzętu,
• preferowanie sprzętowej akceleracji, jeśli jest dostępna,
• automatyczny fallback do bezpiecznych i kompatybilnych trybów software,
• przesyłanie dźwięku, jeśli projekt to umożliwia,
• tryb wielu monitorów,
• wybór monitora,
• kopiuj/wklej, schowek,
• transfer plików,
• opcjonalny zdalny terminal / shell administracyjny, jeśli architektura to wspiera,
• nagrywanie sesji zgodnie z polityką uprawnień i audytu,
• mechanizmy rekonfiguracji jakości w trakcie sesji.

3. Czat i komunikacja

Klient MGMT ma umożliwiać:

• czat 1:1 z użytkownikiem końcowym,
• czat operator ↔ agent,
• czat grupowy dla kontekstu incydentu lub zgłoszenia,
• gotowe odpowiedzi,
• historię konwersacji,
• powiadomienia push/in-app,
• eskalację zgłoszeń,
• oznaczanie sesji jako wymagającej pilnej pomocy.

4. Zarządzanie serwerem BetterDesk

Klient MGMT ma zawierać panel administracyjny pozwalający – zależnie od uprawnień – na:

• przegląd stanu serwera,
• przegląd podłączonych klientów,
• zarządzanie operatorami i rolami,
• konfigurację polityk bezpieczeństwa,
• podgląd logów i zdarzeń,
• zarządzanie kluczami, tokenami i rejestracją klientów,
• zarządzanie integracjami,
• zarządzanie kolejką powiadomień o pomocy,
• zarządzanie grupami urządzeń i regułami przypisania.

5. Tryb CDAP / operator

Klient MGMT ma być głównym narzędziem operatora. Powinien:

• obsługiwać wiele równoczesnych sesji,
• oferować kolejkę zgłoszeń,
• priorytety incydentów,
• dashboard aktywnych połączeń,
• monitoring jakości sesji,
• wskaźniki wykorzystania pasma, kodeka, FPS, opóźnienia,
• podgląd alertów i problemów z agentami,
• możliwość przejmowania, przekazywania i kończenia sesji zgodnie z uprawnieniami.

Bezpieczeństwo — wymagania krytyczne

To jest priorytet najwyższy. Implementacja ma być projektowana zgodnie z zasadą secure-by-design.

Wymagania:

• silna wzajemna autoryzacja klient ↔ serwer,
• TLS/mTLS tam, gdzie możliwe,
• rotacja tokenów sesyjnych,
• krótko żyjące tokeny dostępu,
• role i uprawnienia RBAC,
• opcjonalnie wsparcie MFA dla operatorów,
• pinning certyfikatów lub bezpieczny trust model,
• pełen audyt zdarzeń administracyjnych,
• podpisywanie lub weryfikacja integralności aktualizacji,
• minimalizacja powierzchni ataku,
• bezpieczne przechowywanie sekretów lokalnie z użyciem systemowych magazynów poświadczeń jeśli możliwe,
• ograniczenie wykonywania działań wysokiego ryzyka,
• jawna zgoda użytkownika tam, gdzie polityka firmy lub tryb pracy tego wymaga,
• rozdzielenie funkcji operatora i superadministratora,
• ścisła walidacja komunikatów przychodzących,
• odporność na replay attack, downgrade attack i nieautoryzowane przejęcie sesji.

Kompatybilność systemowa

Klient MGMT musi być zaprojektowany z myślą o:

• Windows,
• Linux,
• macOS.

Uwzględnij:

• różnice w przechwytywaniu obrazu,
• różnice w modelu uprawnień,
• różnice w przechowywaniu sekretów,
• różnice w instalacji i aktualizacji,
• różnice w akceleracji sprzętowej i dostępności kodeków,
• różnice w działaniu usług/system tray/notyfikacji.

UX/UI

Interfejs ma być:

• nowoczesny,
• czytelny,
• szybki,
• zoptymalizowany dla operatora pracującego pod obciążeniem,
• wspierać motyw ciemny i jasny,
• mieć priorytet na ergonomię, gęstość informacji i szybkość działania.

Widoki minimalne:

• logowanie,
• dashboard,
• lista urządzeń,
• szczegóły urządzenia,
• okno zdalnej sesji,
• panel czatu,
• centrum powiadomień,
• panel zarządzania serwerem,
• panel ustawień,
• panel audytu/logów.

Integracja z RustDesk

Jeśli repozytorium BetterDesk technicznie umożliwia integrację z RustDesk, zaprojektuj warstwę integracyjną tak, aby:

• nie łamać obecnej architektury,
• oddzielać źródła urządzeń logicznie,
• normalizować metadane urządzeń,
• zachować spójny model uprawnień,
• zapewniać bezpieczne mapowanie sesji, statusów i identyfikatorów.

Jeśli pełna integracja nie jest możliwa bez dużych zmian, zaproponuj:

• etapowy plan integracji,
• warstwę kompatybilności,
• adapter źródeł urządzeń.

Wymagania implementacyjne

Na bazie istniejącego projektu:

1. przeanalizuj strukturę repozytorium i wskaż, które moduły można ponownie wykorzystać,
2. zaproponuj docelową strukturę kodu klienta MGMT,
3. wskaź, które części napisać w Go, a które w JavaScript,
4. uwzględnij budowanie aplikacji wieloplatformowej,
5. uwzględnij instalatory i aktualizacje,
6. zaproponuj warstwę konfiguracji i polityk,
7. zaproponuj testy:
   • jednostkowe,
   • integracyjne,
   • e2e,
   • testy bezpieczeństwa,
   • testy wydajności streamingu,
   • testy kompatybilności systemowej.

Oczekiwany rezultat

Wygeneruj kompletny plan i implementację klienta BetterDesk MGMT Client, obejmującą:

• architekturę,
• strukturę katalogów,
• komponenty GUI,
• warstwę komunikacji,
• obsługę zdalnych sesji,
• panel serwera,
• czat,
• powiadomienia,
• model bezpieczeństwa,
• integrację z istniejącym backendem BetterDesk,
• plan integracji z RustDesk,
• strategię wdrożenia cross-platform.