# PS Master — plan pełnej rundy testowej (Etap 10)

Wersja planu: 1.0

Zakres: strona PS Master oraz funkcje współpracujące z PS Master Soft

Zasada nadrzędna: testy nie mogą wymagać danych produkcyjnych ani wykonywania nieodwracalnych zmian.

## 1. Cel rundy

Sprawdzić, czy PS Master jest czytelny, przewidywalny i bezpieczny na obsługiwanych systemach oraz urządzeniach. Wynik testu powinien opisywać środowisko, wykonane kroki, oczekiwany rezultat i rezultat rzeczywisty.

## 2. Bezpieczne przygotowanie

1. Użyj komputera testowego, maszyny wirtualnej albo danych przykładowych.
2. Nie wklejaj haseł, tokenów, kluczy, danych klientów ani wewnętrznych nazw serwerów.
3. Dla poleceń zmieniających system użyj `-WhatIf`, środowiska laboratoryjnego lub samego Inspektora.
4. Przed testem offline otwórz stronę online co najmniej raz, aby pamięć podręczna mogła się przygotować.
5. Zapisz wersję systemu, PowerShell i przeglądarki.

## 3. Macierz środowisk

| Obszar | Minimalny zakres | Oczekiwany wynik |
|---|---|---|
| Windows PowerShell 5.1 | wyszukiwanie, Generator, Inspektor, przykłady tylko do odczytu | brak błędów składni; właściwe informacje o wersji i uprawnieniach |
| PowerShell 7 na Windows | te same funkcje oraz różnice między 5.1 i 7 | poprawna składnia i czytelne oznaczenie zgodności |
| Linux | PowerShell 7, Bash, sieć, procesy, pliki | polecenia właściwe dla systemu; brak instrukcji Windows w głównym wyniku |
| macOS | PowerShell 7, zsh, launchd, pliki | polecenia właściwe dla macOS; poprawne ścieżki i uprawnienia |
| Telefon 360–430 px | pierwsze kroki, wyszukiwanie, dokumentacja, formularz opinii | brak poziomego przewijania i zasłaniania treści |
| Tablet 768–1024 px | nawigacja, panele, formularze | czytelny układ i dostępne wszystkie przyciski |
| Desktop | pełny przepływ administratora | najważniejsza treść widoczna bez zbędnego przewijania |

## 4. Scenariusze PowerShell

### 4.1 Polecenie tylko do odczytu

- Wyszukaj `Get-Service`.
- Otwórz opis i skopiuj przykład.
- Sprawdź polecenie w Inspektorze.
- Oczekiwany wynik: niskie ryzyko, standardowe uprawnienia dla odczytu, bez sugestii wymagania administratora do zwykłego podglądu.

### 4.2 Symulacja zmiany

- Porównaj `Remove-Item C:\Temp\Test -Recurse -Force` z wariantem zawierającym `-WhatIf`.
- Oczekiwany wynik: ryzyko potencjalnej operacji pozostaje opisane, ale wariant z `-WhatIf` ma wyraźny komunikat „Tryb symulacji”.

### 4.3 Błąd składni lub parametru

- Sprawdź celowo błędne `Get-Servce` albo `Get-Process -Nam explorer`.
- Oczekiwany wynik: błąd jest wskazany prostym językiem, a propozycja poprawki nie zmienia intencji polecenia.

### 4.4 Generator

- Opisz zadanie, uzupełnij wymagane dane i wygeneruj wynik.
- Oczekiwany wynik: kod nie uruchamia się automatycznie; dostępne są kontrola, opis, kopiowanie i pobranie.

## 5. Test systemów Linux i macOS

1. Wybierz odpowiedni tryb systemu.
2. Sprawdź co najmniej pięć poleceń: pliki, procesy, sieć, usługi i informacje systemowe.
3. Zweryfikuj powłokę, ścieżki, wielkość liter, wymagane uprawnienia i dostępność narzędzia.
4. Jeśli polecenie wymaga pakietu lub modułu, PS Master powinien to jasno podać.
5. Nie uznawaj samej kontroli katalogu za test wykonania na prawdziwym urządzeniu.

## 6. Klawiatura i dostępność

- Przejdź po całej aktywnej sekcji klawiszem `Tab` oraz `Shift+Tab`.
- Każdy przycisk musi mieć widoczny fokus i zrozumiałą nazwę.
- Użyj `Enter` lub `Spacja` do uruchomienia przycisków.
- Sprawdź tryb jasny i ciemny oraz powiększenie przeglądarki do 200%.
- Tekst nie może zlewać się z tłem ani znikać po najechaniu kursorem.

## 7. Import, eksport i praca offline

1. Utwórz przykładową własną komendę lub profil firmy.
2. Wyeksportuj dane i sprawdź, czy pobrany plik nie jest pusty.
3. Zaimportuj plik do czystego profilu przeglądarki lub po usunięciu danych testowych.
4. Zamknij kartę, odłącz sieć i ponownie otwórz wcześniej przygotowaną stronę.
5. Oczekiwany wynik: podstawowe moduły i zapis lokalny są dostępne; dokumentacja zewnętrzna, formularz opinii i nowe pobrania mogą wymagać Internetu.

## 8. Prywatna runda z administratorami

Każdy tester powinien wykonać co najmniej jeden pełny przepływ:

1. opisać realny, ale zanonimizowany problem,
2. znaleźć lub wygenerować polecenie,
3. sprawdzić je w Inspektorze,
4. ocenić opis ryzyka i uprawnień,
5. potwierdzić rezultat bez wykonywania niebezpiecznej operacji produkcyjnej,
6. przekazać jedną rzecz, która działa dobrze, oraz jedną propozycję poprawy.

## 9. Szablon zgłoszenia

```text
System i wersja:
PowerShell / powłoka:
Przeglądarka i rozdzielczość:
Moduł PS Master:
Kroki odtworzenia:
Oczekiwany rezultat:
Rzeczywisty rezultat:
Wpływ: blokujący / wysoki / średni / niski / sugestia
Czy problem powtarza się:
Opcjonalny zrzut ekranu bez danych poufnych:
```

## 10. Kryterium zakończenia

Runda jest zakończona, gdy:

- testy Windows PowerShell 5.1 i PowerShell 7 mają zapisany wynik,
- Linux i macOS zostały sprawdzone na rzeczywistych urządzeniach albo wyraźnie oznaczone jako oczekujące,
- telefon, tablet i desktop nie mają błędów blokujących,
- klawiatura, kontrast, import, eksport i tryb offline mają udokumentowany status,
- każde zgłoszenie ma decyzję: naprawione, zaplanowane, odrzucone z uzasadnieniem lub niemożliwe do odtworzenia,
- publiczna lista „Naprawione na podstawie Waszych opinii” została uzupełniona bez ujawniania danych testerów.