hackathon-ENGIN/docs/DEMO_SCENARIO.md

45 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ENGIN — scenariusz demo 35 minut
## 0:000: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:351: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:152: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:203: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:053: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 32/32.