Storefront Axecore Playwright

Aplikacja do testów dostępności w sklepach Shoper.

Szybki start

🐳 Opcja 1: Docker (Zalecana)

# Uruchomienie kontenera (zbudowanie i odpalenie w tle)
docker-compose up -d --build

# Wyłączenie kontenera
docker-compose down

Aplikacja będzie gotowa pod adresem: http://localhost:3000

💻 Opcja 2: Lokalnie

# Instalacja zależności i przeglądarek
npm install
npm run install-browsers

# Zbudowanie i uruchomienie
npm run build
npm start

Obsługa CLI

Możesz uruchamiać testy bezpośrednio w terminalu:

# Szybki test wybranego adresu URL
npm run test https://example.com

# Test z kliknięciem w baner cookies (adres, selektor CSS, czas oczekiwania w ms)
ts-node src/test-url.ts https://example.com "button[aria-label='Accept all']" 2000

Poziomy błędów

• Krytyczne (Critical): Problemy drastycznie obniżające dostępność - do natychmiastowej naprawy.
• Poważne (Serious): Główne uchybienia z dużym wpływem na dostępność - wysoki priorytet.
• Umiarkowane (Moderate): Ważne problemy, które w pewnym stopniu ograniczają dostępność - należy naprawić.
• Drobne (Minor): Subtelne błędy o niewielkim wpływie - warto naprawić w wolnej chwili.
• Wymaga przeglądu (Needs Review): Sytuacje niejednoznaczne dla automatu - wymagają oceny człowieka.

Troubleshooting

• Błąd "Browser not found": Brakuje przeglądarek Playwright. Uruchom npm run install-browsers. Jeśli używasz Dockera, przebuduj obraz na czysto: docker-compose build --no-cache.
• Port 3000 jest zajęty: Zmień port uruchamiając komendę np. tak: PORT=8080 npm start.
• Błędy kompilacji TypeScript: Usuń stare pliki i zbuduj projekt ponownie: rm -rf dist a następnie npm run build.
• Błędy limitu czasu (Timeout): Domyślny maksymalny czas ładowania strony to 30 sekund. W przypadku wyjątkowo powolnych stron konieczna będzie zmiana tej wartości bezpośrednio w kodzie.

Jak wydawać paczkę?

Użyj komendy:

• npm publish --beta dla paczki beta
• npm publish --public dla paczki public