Koncepcja projektu

Nazwa: „Kwiz Pamięci”

Nazwa nawiązuje wprost do misji Instytutu Pamięci Narodowej — dbałości o pamięć o najnowszej historii Polski — i łączy ją z lekką, przystępną formą quizu. „Kwiz Pamięci” jest krótka, łatwa do zapamiętania, dobrze brzmi jako nazwa aplikacji i domeny (np. kwizpamieci.pl), a jednocześnie jasno komunikuje odbiorcy (nauczycielowi historii), czego może się po niej spodziewać.

Dla kogo i po co

Grupą docelową są nauczyciele historii w szkołach podstawowych i ponadpodstawowych. Zamiast ręcznie przygotowywać sprawdziany, nauczyciel wpisuje temat lekcji (np. „Sierpień 1980”), wybiera poziom trudności odpowiedni dla klasy oraz liczbę pytań, a aplikacja generuje gotowy quiz do wydruku (PDF/DOCX) lub do przeprowadzenia on-line — wraz z kluczem odpowiedzi.

Ścieżka użytkownika

1. Panel logowania — zakładanie konta i logowanie nauczyciela.
2. Menu generowania — pole tematu/hasła historycznego, wybór poziomu trudności (szkoła podstawowa / ponadpodstawowa / poziom rozszerzony) oraz liczby pytań.
3. Wygenerowany quiz — podgląd pytań, możliwość rozwiązania quizu on-line z natychmiastową informacją zwrotną.
4. Eksport — pobranie gotowego sprawdzianu w formacie .pdf lub .docx, z kluczem odpowiedzi lub bez (wersja dla ucznia / wersja dla nauczyciela).

Zgodność z WCAG 2.1

• Semantyczna struktura HTML (nagłówki, listy, fieldset/legend, punkty orientacyjne).
• Wszystkie pola formularzy mają powiązane etykiety (label) i opisy pomocnicze.
• Link „Przejdź do treści głównej” (skip link) na każdej stronie.
• Widoczny fokus klawiatury (:focus-visible) i pełna obsługa z klawiatury, bez pułapek fokusu.
• Komunikaty o błędach i wynikach ogłaszane w regionach aria-live / role="alert".
• Kontrast tekstu i przycisków dobrany zgodnie z poziomem AA (min. 4.5:1 dla tekstu).
• Treść niezależna od koloru — poprawne/błędne odpowiedzi oznaczone także tekstem i ikoną, nie tylko kolorem.
• Responsywny układ (praca na komputerze, tablecie i telefonie) bez poziomego przewijania strony.
• prefers-reduced-motion respektowane dla animacji interfejsu.

Architektura techniczna

Aplikacja działa w modelu klient–serwer: dostępna z klawiatury i czytnika ekranu warstwa frontendowa komunikuje się z API generującym quizy oraz eksportującym pliki.

1. Frontend (HTML/CSS/JS, WCAG 2.1) — panel logowania, formularz generowania quizu, widok quizu, eksport.
2. API (Node.js/Express) — uwierzytelnianie, generowanie quizu na podstawie tematu/poziomu/liczby pytań, generowanie plików PDF (pdfkit) i DOCX (docx).
3. Silnik doboru pytań — dopasowuje wpisane hasło do puli pytań wg tagów tematycznych i poziomu trudności; w wersji MVP korzysta z redakcyjnie przygotowanej bazy pytań.
4. Docelowe źródła danych (roadmap) — adapter API multiwyszukiwarki IPN (szukaj.ipn.gov.pl) zamiast/obok statycznej bazy pytań oraz adapter biblioteki cyfrowej MEiN.

Plan integracji z multiwyszukiwarką IPN i biblioteką MEiN

Wersja językowa

Wersja demonstracyjna przygotowana jest w języku polskim (zgodnie z wymaganiem „przynajmniej jeden wariant językowy”). Struktura treści (baza pytań, etykiety interfejsu) jest przygotowana tak, by w kolejnym etapie łatwo dodać wariant angielski.