# Scenario Flow Control Room - poradnik

Ten modul pomaga prowadzacemu i testerowi ogarnac tempo scenariusza.

## Po co to jest

Scenariusz ma etapy, eventy czasowe, eventy cykliczne i okna dostepnosci. Bez kokpitu latwo zgubic, co ma sie odpalic i dlaczego cos nie dziala.

Control Room pokazuje:

- aktualny etap,
- czas gry,
- czas w etapie,
- nastepny etap,
- eventy cykliczne,
- eventy zablokowane,
- powod blokady,
- zakupy / role / questy dostepne lub zablokowane.

## Gdzie wejsc

Panel testowy:

```text
/admin/tools/scenario-flow-control-room.html
```

Panel live dla prowadzacego:

```text
/facilitator.html?code=KOD_SESJI
```

## Jak czytac sekcje w panelu prowadzacego

### Aktualny etap

Pokazuje, w jakim etapie jest wybrana druzyna.

Przyklad:

```text
STAGE_03_CRISIS - Kryzys i eskalacja
```

### Czas w etapie

Pokazuje, ile czasu druzyna siedzi w tym etapie. Przydatne, gdy grupa za dlugo analizuje albo za szybko biegnie dalej.

### Recurring events

To eventy, ktore moga odpalac sie co kilka minut.

Przyklad:

```text
EVT_RECURRING_CLIENT_PRESSURE
co 5 minut
max 3 razy
```

### Dlaczego cos sie nie odpala

To jest najwazniejsze dla testera. Jesli event nie dziala, panel pokazuje powod, np.:

```text
Event nie jest dostepny w tym etapie.
Wymaga eventu EVT_MACHINE_FAILURE.
Oferta wygasla po etapie STAGE_02_FIRST_ISSUES.
```

## Rczna kontrola etapow

W panelu prowadzacego mozna:

- ustawic konkretny etap,
- przejsc do nastepnego etapu,
- cofnac do poprzedniego etapu,
- zatrzymac automatyczne przejscia etapow,
- wznowic automatyczne przejscia etapow.

To jest przydatne, gdy szkolenie nie idzie idealnie wedlug planu.

## Kiedy zatrzymac auto-etapy

Zatrzymaj auto-etapy, gdy:

- grupa potrzebuje wiecej czasu,
- chcesz omowic decyzje przed kryzysem,
- chcesz recznie odpalic event,
- chcesz pokazac cos na projektorze,
- scenariusz testowy wymaga pauzy.

## Kiedy ustawic etap recznie

Ustaw etap recznie, gdy:

- grupa skonczyla watek szybciej,
- chcesz wejsc w kryzys od razu,
- testujesz konkretny fragment scenariusza,
- chcesz powtorzyc etap.

## Dobra praktyka

Przed warsztatem zrob szybki test:

1. Otworz Scenario Timeline.
2. Otworz Flow Control Room.
3. Sprawdz, czy eventy sa w dobrych etapach.
4. Sprawdz, czy recurring event ma maxRuns.
5. Sprawdz, czy zakupy nie wygasaja zanim da sie je odblokowac.
6. Utworz sesje testowa.
7. Wejdz jako gracz.
8. W panelu prowadzacego przejdz recznie przez wszystkie etapy.


---

Wersja: 1.5.1-scenario-flow-control-room. Dokument celowo uzywa prostego jezyka. W poradnikach nietechnicznych unikamy polskich znakow, zeby nie krzaczyly sie w prostych viewerach.