# Dostępność - PappAI

> PappAI jest zaprojektowane tak, aby mogli z niego korzystać wszyscy. Oto, co obsługujemy i jak zgłaszać ewentualne problemy.

Source: https://pappai.it/pl/accessibility

## 1. Aplikacja mobilna (iOS i Android)

Aplikacja PappAI dla pacjentów została stworzona z użyciem SwiftUI (iOS) i Jetpack Compose (Android), frameworków zapewniających natywną integrację z usługami ułatwień dostępu platformy.

- **VoiceOver (iOS) / TalkBack (Android)**: wszystkie główne ekrany są dostępne za pomocą systemowego czytnika ekranu. Elementy interaktywne posiadają opisowe etykiety.
- **Dynamiczny rozmiar tekstu**: aplikacja respektuje systemowe ustawienie rozmiaru tekstu, w tym największe rozmiary ułatwień dostępu. Układy dostosowują się bez obcinania tekstu.
- **Pogrubiony tekst**: aplikacja respektuje opcję ułatwień dostępu Pogrubiony tekst w systemie iOS.
- **Ogranicz ruch**: animacje wejściowe i przejścia są wyłączane, gdy w ustawieniach systemowych włączona jest opcja Ogranicz ruch.
- **Tryb ciemny**: pełne wsparcie trybu ciemnego, z odpowiednim kontrastem zarówno w wariancie jasnym, jak i ciemnym.
- **Sterowanie głosowe (iOS)**: elementy interaktywne posiadają unikalne, opisowe etykiety umożliwiające niezawodną nawigację głosową.

Niektóre bardziej złożone funkcje (robienie zdjęć posiłków, wyświetlanie planów w PDF) mogą mieć ograniczone wsparcie ułatwień dostępu. Pracujemy nad poprawą ich obsługi w kolejnych aktualizacjach.

## 2. Panel internetowy (app.pappai.it)

Panel internetowy dla nutrizionistów został zbudowany przy użyciu React i komponentów shadcn/ui, które są zgodne ze standardami WAI-ARIA.

- **Nawigacja klawiaturą**: wszystkie główne procesy są dostępne z klawiatury (Tab, Enter, strzałki). Wskaźniki fokusu są zawsze widoczne.
- **Czytniki ekranu**: nagłówki, punkty orientacyjne i etykiety ARIA są konsekwentnie stosowane na wszystkich głównych ekranach.
- **Kontrast kolorów**: tekst i elementy interaktywne spełniają lub przewyższają wymagane współczynniki kontrastu WCAG 2.1 poziomu AA.
- **Tryb ciemny**: panel obsługuje systemowe preferencje dotyczące trybu ciemnego.
- **Responsywny design**: interfejs dostosowuje się do różnych rozmiarów okna i poziomu powiększenia przeglądarki do 200%.

## 3. Strona publiczna (pappai.it)

Strona publiczna wykorzystuje semantyczny HTML i jest dostępna zarówno z klawiatury, jak i za pomocą czytników ekranu. Wszystkie obrazy mają opisowy tekst alternatywny. Baner zgody na pliki cookie oraz wszystkie formularze są dostępne z klawiatury.

- **Link pomijający nawigację**: osoby korzystające z klawiatury lub czytnika ekranu mogą pominąć powtarzający się nagłówek i nawigację na każdej stronie.
- **Kontrast kolorów**: tekst i elementy interaktywne zostały sprawdzone pod kątem spełnienia lub przekroczenia współczynników kontrastu WCAG 2.1 poziomu AA.
- **Struktura semantyczna**: sekwencje kroków wykorzystują listy uporządkowane, a tabele danych mają poprawne nagłówki wierszy/kolumn, dzięki czemu czytnik ekranu poprawnie odczytuje ich strukturę.
- **Ogłoszenia na żywo**: dynamiczna treść, taka jak odpowiedzi czatu i błędy formularzy, jest automatycznie ogłaszana czytnikom ekranu.
- **Pełna obsługa klawiatury**: każdy element interaktywny, w tym widżet czatu i przełączniki, można obsłużyć i zamknąć bez myszy.

## 4. Znane ograniczenia

Jesteśmy świadomi następujących obszarów wymagających poprawy:

- Wykresy i diagramy żywieniowe w aplikacji mobilnej nie mają jeszcze pełnych opisów dla VoiceOver/TalkBack.
- Niektóre osadzone treści zewnętrzne (przeglądarka PDF) mogą nie być w pełni dostępne.
- Obsługa napisów i podpisów dla treści wideo w aplikacji nie została jeszcze wdrożona.

Dążymy do poprawy dostępności z każdym wydaniem. Jeśli napotkasz barierę, która nie została tu wymieniona, daj nam znać.

## 5. Kontakt

Jeśli podczas korzystania z PappAI napotkasz bariery w dostępności lub masz sugestie dotyczące jej poprawy, skontaktuj się z nami:

- E-mail: [support@pappai.it](mailto:support@pappai.it): w temacie wpisz „Dostępność”.
- Staramy się odpowiadać w ciągu 5 dni roboczych i jak najszybciej rozwiązywać zgłoszone bariery.

## 6. Opinie i ciągłe doskonalenie

Dostępność to nasze stałe zobowiązanie. Regularnie aktualizujemy aplikację i stronę internetową, dążąc do spełnienia kryteriów WCAG 2.1 poziomu AA we wszystkich funkcjach. Opinie użytkowników są dla nas najcenniejszym wkładem. Dziękujemy za pomoc w ulepszaniu PappAI dla wszystkich.