# System Diagnostics Center - poradnik nietechniczny

Wersja: 1.5.7-animation-asset-loader-hardening

Ten panel sluzy do jednego prostego celu: przed warsztatem albo po zmianach w projekcie sprawdzic, czy aplikacja jest zdrowa.

Otworz:

```text
/admin/tools/system-diagnostics.html
```

Kliknij:

```text
Uruchom pelna diagnostyke
```

## Co sprawdza panel

Panel sprawdza miedzy innymi:

```text
- backend PHP
- pliki aplikacji
- katalogi z danymi
- uprawnienia zapisu
- mapy
- przejscia miedzy mapami
- spawn pointy
- pathfinding
- scenariusze
- eventy
- flow scenariusza / stages
- recurring events
- availability windows
- asset mapping
- sprite mapping
- animacje
- multi-tile frames
- sesje
- logi
- raporty
- analytics
- poradniki nietechniczne bez polskich znakow
```

## Jak czytac wynik

Statusy:

```text
READY
```

Mozna testowac lub prowadzic warsztat.

```text
READY_WITH_WARNINGS
```

System dziala, ale sa rzeczy do poprawy. Przed prawdziwym klientem warto je przejrzec.

```text
NOT_READY
```

Nie odpalaj warsztatu, dopoki nie naprawisz problemow critical/error.

## Poziomy problemow

```text
critical
```

Blokujacy problem. Moze rozwalic gre, mapy, scenariusz albo zapis danych.

```text
error
```

Powazny problem. Trzeba naprawic przed warsztatem.

```text
warning
```

Ostrzezenie. Moze nie blokowac testu, ale moze powodowac dziwne zachowanie.

```text
info
```

Informacja. Nie musi byc bledem, np. nieuzywany sprite.

## Jak naprawiac problemy

Przy kazdym problemie panel pokazuje:

```text
- kategorie
- kod problemu
- opis
- gdzie problem wystepuje
- jak naprawic
- link do narzedzia, jesli da sie wskazac
```

Przyklad:

```text
TRANSITION_TARGET_SPAWN_NOT_FOUND
Przejscie prowadzi do brakujacego spawna.

Jak naprawic:
Dodaj spawn point na mapie docelowej albo popraw ID.
```

## Eksport raportu

Mozesz pobrac:

```text
- JSON
- Markdown
```

JSON jest dobry do dalszej diagnostyki.
Markdown jest dobry do wklejenia w rozmowe albo do zapisania jako notatka testowa.

## Kiedy uzywac

Uzywaj po kazdej wiekszej zmianie:

```text
- po dodaniu assetow
- po zapisaniu animacji
- po zmianie sprite-mapping
- po zbudowaniu mapy
- po dodaniu przejsc miedzy mapami
- po zmianie scenariusza
- po dodaniu eventow cyklicznych
- przed testem warsztatu
- przed prawdziwym warsztatem
```

## Najlepsza kolejnosc pracy

```text
1. Odswiez assets/vendor, jesli byly nowe pliki.
2. Otworz Animation Builder, jesli robisz animacje.
3. Otworz Asset Library, jesli sprawdzasz sprite.
4. Otworz Map Studio, jesli zmieniales mapy.
5. Otworz Scenario Editor, jesli zmieniales scenariusz.
6. Uruchom System Diagnostics.
7. Napraw critical/error.
8. Przejdz Playtest QA.
9. Zrob test gracza, prowadzacego i projektora.
```

## Typowe problemy

### Brakuje spriteId

Obiekt na mapie wskazuje sprite, ktorego nie ma w sprite-mapping.json.

Naprawa:

```text
1. Otworz Map Studio.
2. Znajdz obiekt.
3. Wybierz poprawny spriteId.
```

Albo:

```text
1. Otworz Animation Builder.
2. Utworz brakujacy spriteId.
3. Zapisz do sprite-mapping.json.
```

### Przejscie prowadzi do brakujacego spawna

Mapa docelowa istnieje, ale nie ma spawn pointa o podanym ID.

Naprawa:

```text
1. Otworz mape docelowa w Map Studio.
2. Dodaj spawn point.
3. Nadaj mu dokladnie ten sam ID.
4. Zapisz mape.
```

### interactionTile jest zablokowany

Gracz nie moze podejsc do obiektu.

Naprawa:

```text
1. Otworz Map Studio.
2. Znajdz obiekt.
3. Przesun interactionTile na wolna podloge.
4. Uruchom pathfinding preview.
```

### Poradnik ma polskie znaki

Niektore proste viewery krzacza polskie znaki.

Naprawa:

```text
Zapisz poradnik nietechniczny bez ogonkow.
```