May 28, 2026, 1:43 PM

toolbox/README.md

@@ -0,0 +1,53 @@
+# DBAToolBox - Narzędzie do Zarządzania MS SQL
+
+DBAToolBox to prosta aplikacja okienkowa (WPF) napisana w PowerShellu, służąca do szybkiego sprawdzania połączenia z serwerami MS SQL Server oraz pobierania podstawowych informacji o instancji.
+
+## Funkcje
+
+- **Testowanie połączenia:** Sprawdza dostępność serwera SQL.
+- **Informacje o instancji:** Wyświetla wersję, edycję oraz status serwera po udanym połączeniu.
+- **Logowanie zdarzeń:** Panel logów wyświetlający przebieg operacji w czasie rzeczywistym.
+- **Persystencja ustawień:** Automatycznie zapamiętuje ostatnio używaną nazwę serwera.
+- **Interfejs graficzny:** Przejrzysty interfejs zbudowany w technologii WPF.
+
+## Wymagania
+
+Aby korzystać z narzędzia, system musi spełniać poniższe wymagania:
+1. **PowerShell 5.1 lub nowszy** (w tym PowerShell 7+).
+2. **Moduł dbatools:** Aplikacja wykorzystuje ten moduł do komunikacji z SQL Server.
+   - Instalacja: `Install-Module dbatools -Scope CurrentUser`
+3. **Uprawnienia:** Odpowiednie uprawnienia sieciowe i bazodanowe do łączenia się z docelowymi serwerami.
+
+## Struktura Projektu
+
+- `DBAToolBox.ps1` - Główny skrypt uruchomieniowy aplikacji.
+- `Modules/SQLManager.psm1` - Logika biznesowa i funkcje pomocnicze.
+- `UI/MainWindow.xaml` - Definicja interfejsu użytkownika (XAML).
+- `Config/settings.json` - Plik konfiguracyjny przechowujący ustawienia użytkownika.
+
+## Uruchomienie
+
+1. Otwórz PowerShell w folderze projektu.
+2. Uruchom skrypt główny:
+   ```powershell
+   .\DBAToolBox.ps1
+   ```
+
+## Konfiguracja
+
+Ustawienia są przechowywane w pliku `Config/settings.json`. Obecnie wspierane klucze:
+- `LastServer`: Nazwa ostatnio wpisanego serwera.
+- `Theme`: Motyw aplikacji (domyślnie "Light").
+
+## Rozwiązywanie problemów
+
+Jeśli aplikacja nie uruchamia się:
+1. Upewnij się, że moduł `dbatools` jest zainstalowany.
+2. Sprawdź, czy Twoja polityka wykonywania skryptów (Execution Policy) pozwala na uruchamianie lokalnych skryptów:
+   ```powershell
+   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
+   ```
+
+---
+Autor: Gemini CLI
+Data: Maj 2026