Mini Minesweeper Lite

**Mini Saper Lite — Retro Puzzle Challenge**

Mini Saper Lite przenosi ponadczasową łamigłówkę logiczną na urządzenia mobilne z charakterystyczną oprawą graficzną Pixel Classic. Podstawowa rozgrywka to czysty Saper: odkrywaj bezpieczne komórki, oznaczaj miny i oczyszczaj planszę bez wywoływania eksplozji.

**Rozgrywka**
- Trzy poziomy trudności: Łatwy (9×9, 10 min), Średni (12×12, 20 min), Trudny (16×16, 40 min)
- Bezpieczeństwo po pierwszym dotknięciu: Twoje pierwsze odkrycie i 8 sąsiadujących z nim komórek ma gwarancję braku min
- Wskazówki liczbowe wskazują na obecność min w otaczających 8 komórkach
- Puste komórki automatycznie powiększają sąsiednie bezpieczne obszary (wypełnianie)
- Przełączaj się między trybem ODKRYWANIA (dotknij, aby kopać) a trybem FLAG (dotknij, aby oznaczyć)
- Wygraj, odkrywając wszystkie bezpieczne komórki; przegraj, trafiając w minę

**Cele i ograniczenia**
- Brak limitów ruchu i czasu — skup się na celności, a nie na szybkości
- Timer śledzi czas od pierwszego dotknięcia
- Rzuć sobie wyzwanie, aby pobić swój rekord życiowy na każdym poziomie trudności
- Nieograniczona liczba powtórzeń; Każda gra to nowa, losowo generowana plansza.

**Systemy wspomagania**
- Wskazówka: obejrzyj reklamę z nagrodą, aby automatycznie odkryć jedną bezpieczną komórkę (1 na grę).
- Przyciski przełączania trybu u dołu ekranu do przełączania między trybami ODKRYWANIE/FLAGA.
- Naciśnij i przytrzymaj dowolną komórkę, aby szybko przełączyć flagę bez zmiany trybu.

**Projekt wizualny: Motyw Pixel Classic.**
- Zaokrąglone rogi 0 dp (wszystkie kwadratowe przyciski i karty).
- Trójwymiarowe, ścięte przyciski z podświetleniem i cieniem.
- Obramowanie 2–4 dp pikseli na wszystkich elementach interfejsu.
- Czcionka o stałej szerokości dla cyfr i etykiet.
- Ciemne tło (#0D0D0D) z jasnozielonymi akcentami (#00E436).
- Pogrubiony tekst WIELKIMI LITERAMI.
- Ikony emoji (💣 ⏱ 💡 🚩) dla natychmiastowego rozpoznania.
- Informacja zwrotna po naciśnięciu: przyciski 3D spłaszczają się po naciśnięciu.

**Strony i nawigacja**
- Aktywność domowa: Przyciski 6-pikselowe. (GRAJ, USTAWIENIA, JAK GRAĆ, HISTORIA, STATYSTYKI, OSIĄGNIĘCIA)
- Aktywność w grze: wyśrodkowana kwadratowa plansza, HUD z licznikami min/timerów, przełącznik trybu, przycisk podpowiedzi
- Okno poziomu trudności: wybierz poziom łatwy/średni/trudny przed rozpoczęciem
- Okno wyniku gry: pokazuje czas, najlepszy czas, nową odznakę rekordu
- Aktywność ustawień: dźwięk, wibracje, przełączanie efektów retro
- Aktywność sposobu gry: 4 karty instruktażowe z objaśnieniami liczb, flag, trybów i podpowiedzi
- Aktywność historii: przewijana lista rekordów z przyciskiem „wyczyść wszystko”
- Aktywność statystyk: 11 statystyk (rozegrane gry, wskaźnik wygranych, najlepsze czasy, idealne gry)
- Aktywność osiągnięć: 8 osiągnięć w 2-kolumnowej siatce (PIERWSZE ZWYCIĘSTWO, DEMON PRĘDKOŚCI, PERFEKCJONISTA, SERIA ZWYCIĘSTW 3/5, WETERANOWI, MISTRZOWI, TRYB TRUDNY)
- Strony dodatkowe powrót do strony głównej za pomocą przycisku pikselowego powrotu; Strona główna korzysta z przycisku podwójnego powrotu do wyjścia

**Uwagi dotyczące UX**
- Czysta nawigacja wieloaktywnościowa, brak struktury dolnych kart
- Niestandardowy pasek narzędzi pikseli na wszystkich stronach drugorzędnych (głębokie czarne tło, obramowanie z zielonych pikseli 4dp u dołu, trójwymiarowy przycisk powrotu ze strzałką ◀)
- Adaptacja krawędzi do krawędzi paska stanu i dolnego obszaru nawigacji
- Dynamiczne obliczanie rozmiaru komórki w celu wyśrodkowania kwadratowej planszy na ekranie
- Potwierdzenie pauzy podczas wycofywania się z aktywnej gry

**Integracja reklam**
- Pakiet TradPlus SDK zintegrowany poprzez niezależny moduł tradplus-sdk
- Reklamy z nagrodami: Zwiększenie liczby podpowiedzi (1 na grę)
- Reklamy śródmiąższowe: przejście powrotu do strony głównej po zakończeniu gry, limit 3 na sesję
- Identyfikatory jednostek reklamowych skonfigurowane w MinesweeperApp.kt i AndroidManifest.xml
- Zgoda na przetwarzanie danych zgodnie z RODO przy pierwszym uruchomieniu

**Trwałość danych**
- SharedPreferences + Gson dla historii (maks. 100 rekordów), statystyk (11 metryk), Osiągnięcia (8 do odblokowania), ustawienia (3 przełączniki)
- Brak bazy danych „Pokoje”; wszystkie dane przechowywane jako ciągi JSON
- Historia śledzi poziom trudności, wynik (wygrana/przegrana), czas, datę
- Statystyki obejmują liczbę całkowitą/wygranych/przegranych, wskaźnik wygranych, najlepsze czasy na poziomie trudności, odkryte kafelki, postawione flagi, idealne gry
- Osiągnięcia odblokowują się automatycznie na podstawie kamieni milowych rozgrywki

**Uwagi techniczne**
- Kotlin
- Układ XML
- ViewBinding
- Zarządzanie stanem w stylu MVVM (LiveData + ViewModel dla GameActivity)
- Architektura Multi-Activity
- Trwałość SharedPreferences (bez pokoju)
- Java 17
- minSdk 26 / targetSdk 36 / compileSdk 36
- Wyrównanie stron pamięci Androida 16 KB (`useLegacyPackaging = false`)
- W pełni zaimplementowany motyw Pixel Classic