hackathon-ENGIN/docs/DEMO_SCENARIO.md

ENGIN — scenariusz demo 3–5 minut

0:00–0:35 — problem

„Jeden przemysłowy silnik ma 8, 12 lub 16 cylindrów. Mechanik dostaje 21 punktów widma dla każdego cylindra, ale potrzebuje decyzji: który cylinder sprawdzić, jakiej usterki szukać i jak pilna jest interwencja. ENGIN zamienia te pomiary w kolejkę konkretnych działań.”

0:35–1:15 — ekran silnika

1. Uruchom streamlit run app.py i pozostaw „Dane demonstracyjne”.
2. Wskaż status silnika, najwyższe nasilenie i liczbę cylindrów wymagających uwagi.
3. Pokaż mapę odchyleń: diagnoza jest zapisana przy każdym cylindrze, a stała skala kolorów pozwala porównywać silniki.

Komunikat: „Nie zmuszamy mechanika do czytania 21 wykresów. Najpierw widzi najważniejszy cylinder i pilność.”

1:15–2:20 — explainability

1. Otwórz „Szczegóły cylindra”.
2. Wybierz najwyżej sklasyfikowany cylinder.
3. Opcjonalnie dodaj drugi cylinder do porównania.
4. Porównaj widmo z medianą pozostałych cylindrów tego samego silnika.
5. Wskaż zaznaczone pasma, wynik modelu, nasilenie i rekomendowany następny krok.

Komunikat: „Referencją jest konkretny silnik, nie abstrakcyjna średnia całej floty. Dzięki temu wynik jest łatwiejszy do zweryfikowania przez człowieka.”

2:20–3:05 — odporność

1. Rozwiń „Informacje techniczne”.
2. Pokaż grupowe makro F1 0.981, trafność nasilenia 0.930 i wynik przy 5% braków.
3. Powiedz, że cały silnik jest zawsze w jednym zbiorze walidacyjnym, a model działa na CPU.

Komunikat: „Wynik nie powstał przez przeciek między cylindrami tego samego silnika. Pipeline jest też testowany na brakach odpowiadających realnym danym warsztatowym.”

3:05–3:40 — własny plik i wartość

1. Pokaż opcję „Wgraj plik CSV”, ale nie przełączaj jej, jeśli czas jest napięty.
2. Pokaż przyciski pobrania wyników oraz pełnej diagnostyki.

Zamknięcie: „ENGIN daje trzy rzeczy naraz: konkursowo skuteczny model, weryfikowalne uzasadnienie i prostą decyzję serwisową. Działa lokalnie na CPU i jest gotowy na podłączenie do warsztatowego procesu.”

Plan awaryjny

• Jeśli nie ma internetu: aplikacja nie potrzebuje internetu.
• Jeśli model nie wystartuje: automatycznie działa tryb awaryjny na zapisanych predykcjach demonstracyjnych.
• Jeśli brakuje czasu: pokaż ekran główny, jeden cylinder i metryki — około 90 sekund.
• Przed wystąpieniem uruchom python -m unittest discover -v i zachowaj terminal z wynikiem 38/38.