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 severity i liczbę cylindrów wymagających uwagi.
3. Pokaż mapę cylindrów oraz ranking kontroli.

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. Porównaj jego widmo z medianą pozostałych cylindrów tego samego silnika.
4. Wskaż zaznaczone pasma, score modelu, severity 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. Przejdź do „Walidacja i model”.
2. Pokaż grouped Macro F1 0.981, severity 0.930 i wynik przy 5% braków.
3. Powiedz, że cały silnik jest zawsze w jednym foldzie i że inference 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 submission 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 fallback na zapisanych predykcjach demo.
• 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.