# Playtest i QA scenariusza — poradnik

Celem Playtest QA nie jest zastąpienie testu człowiekiem. Celem jest złapanie głupich błędów zanim wejdziesz na salę i okaże się, że drzwi do serwerowni są piękne, ale prowadzą donikąd.

## Widok

```text
/admin/tools/playtest-qa.html
```

## Co sprawdza QA

- walidację backendową scenariusza,
- czy scenariusz ma briefing,
- czy scenariusz ma cele/zakończenia,
- czy mapa istnieje,
- czy obiekty mają ID,
- czy obiekty z akcjami mają interactionTile,
- czy interactionTile nie wychodzi poza mapę,
- czy questy wskazują istniejące obiekty i akcje,
- czy efekty wskazują istniejące wskaźniki, questy i obiekty,
- czy drzwi mają sensowne `walkableStates`,
- czy suma zakupów nie jest absurdalnie większa od budżetu startowego.

## Jak testować scenariusz

1. Wybierz scenariusz.
2. Kliknij **Uruchom QA**.
3. Najpierw popraw błędy czerwone.
4. Potem przeczytaj ostrzeżenia żółte.
5. Otwórz Scenario Editor lub Map Builder i popraw problem.
6. Uruchom QA jeszcze raz.
7. Dopiero potem twórz sesję testową.

## Test ręczny po QA

Automat nie wie, czy scenariusz jest śmieszny, logiczny i szkoleniowo dobry. Dlatego po QA zrób ręczny playtest:

- wejdź jako gracz,
- przejdź od startu do każdego ważnego pokoju,
- kliknij każdego ważnego NPC,
- kliknij każdy ważny obiekt,
- wykonaj minimum jeden zakup,
- zatrudnij minimum jedną rolę,
- odpal event decyzyjny,
- sprawdź drzwi zamknięte i otwierane po warunku,
- zakończ grę,
- sprawdź raport i debriefing.

## Definicja „gotowe do testu”

Scenariusz jest gotowy do testu, gdy:

- nie ma błędów czerwonych,
- żółte ostrzeżenia są świadomie zaakceptowane,
- wszystkie ważne questy da się ukończyć,
- eventy odpalają się w sensownej kolejności,
- ekonomia nie zabija gracza po 2 minutach bez powodu,
- prowadzący wie, co omówić w debriefingu.

## Definicja „gotowe na warsztat”

Scenariusz jest gotowy na warsztat, gdy:

- przeszedł QA,
- przeszedł ręczny test,
- działa join gracza,
- działa facilitator,
- działa projector,
- działa raport końcowy,
- prowadzący ma backup plan, gdy ktoś kliknie coś głupiego.