Usprawnienia UX i dostępności

---

title: Usprawnienia UX i dostępności - czytelność stanu, reguł i sesji użytkownika author: Kotmin - PJT created: 2026-04-09 updated: 2026-04-09

Opis

Historia użytkownika

Jako gracz, chce mieć jasna informacje o stanie sesji (czy jestem zalogowany), zasadach gry oraz czytelności elementów (kolory kart), żeby nie tracić czasu na domyślanie się i unikać błędów wynikających z niejednoznaczności.

---

Kontekst i problem

Obecne problemy

• Brak stalej, czytelnej informacji o tym, ze użytkownik jest zalogowany (brak elementu "Hi, username")
• Zasady dotyczące kart (np. requirement 4 kart tego samego koloru) nie są wystarczająco czytelne
• Kolory kart mogą być trudne do rozróżnienia (brak wsparcia accessibility)
• Brak możliwości cofnięcia akcji "dobierz 2 karty" mimo braku zmiany stanu

Dlaczego to problem

• Gracz traci orientacje (czy jest zalogowany, co może zrobić)
• Nieczytelne zasady prowadza do frustracji i błędnych decyzji
• Brak accessibility ogranicza dostępność gry
• Brak cofania prostych akcji zmniejsza poczucie kontroli

---

Rozwiązanie

Zestaw usprawnień UX skupionych na czytelności i kontroli:

• Stały element UI: "Hi, username" + opcja wylogowania (widoczny globalnie)
• Tryb accessibility dla kart: możliwość wyświetlania nazw kolorów na kartach (toggle w ustawieniach)
• Doprecyzowanie zasad:
  • Przy wymaganiu "4 karty" bez wskazania koloru - komunikat, ze chodzi o 4 karty tego samego koloru
  • Wsparcie wizualne (tooltip / hint przy akcji)
• Możliwość anulowania akcji "dobierz 2 karty" dopóki stan gry nie uległ zmianie

---

Kluczowe zasady

• Minimalna ingerencja w flow gry - zmiany maja wspierać, nie spowalniać
• Czytelność > estetyka (szczególnie w trybie accessibility)
• Informacja powinna być dostępna w kontekście (tam gdzie potrzebna)

---

Acceptance Criteria

• [ ] Widoczny globalnie element "Hi, {username}" gdy użytkownik jest zalogowany
• [ ] Obok nazwy użytkownika widoczna akcja "Wyloguj"
• [ ] Opcja w ustawieniach: "Pokaz nazwy kolorów kart" (domyslnie OFF)
• [ ] Po włączeniu opcji, każda karta wyświetla nazwę koloru (np. "czerwony")
• [ ] Przy probie zagrania kart, UI jasno komunikuje wymaganie: "4 karty tego samego koloru"
• [ ] Tooltip lub hint pojawia się w kontekście wyboru akcji
• [ ] Po wybraniu akcji "dobierz 2 karty", gracz może anulować akcje dopóki nie zostanie wykonana pierwsza zmiana stanu
• [ ] Anulowanie nie jest możliwe po ujawnieniu nowych kart lub innej zmianie stanu gry