Dokumentacja

Instrukcja obsługi

Wszystko czego potrzebujesz aby uruchomić pierwszą kartkówkę dzisiaj. Sekcje są krótkie i zawierają konkretne przykłady.

Dla Nauczyciela

1
Rejestracja i logowanie
Załóż konto klikając „Jestem nauczycielem” → „Zarejestruj konto”. Aktywuj konto klikając w link wysłany na e-mail. Pierwsze logowanie wymaga weryfikacji e-mail. Hasło bcrypt-hashowane, nie przechowujemy jawnego.
Tworzenie pytań
Przejdź do „Pytania” w nagłówku. Dwa typy:
  • Wspólne — moderowane przez administratora, dostępne dla wszystkich (tylko do odczytu).
  • Twoje — tworzysz sam, widzisz tylko Ty.
Każde pytanie należy do zakresu (klasa 1–3 podstawowej lub 1–4 rozszerzonej) i ma temat. Możesz dodać obrazek i wyjaśnienie poprawnej odpowiedzi. AI generatorwyprodukuje 5–20 pytań z wybranego tematu — sędzia jakościautomatycznie odrzuca te z błędami merytorycznymi.
3
Tworzenie kartkówki
Na dashboardzie kliknij „Nowa kartkówka”. Wybierz tytuł, czas (minuty), liczbę pytań i opcjonalnie klasę. Możesz określić rozkład pytań per temat (np. 4 × Mol, 3 × Roztwory, 3 × Reakcje = 10 pytań).
Prowadzenie sesji
Po utworzeniu zobaczysz 6-znakowy kod oraz QR. Uczniowie skanują QR albo wchodzą na stronę „Dołącz” i wpisują kod. Klikasz „Rozpocznij” gdy klasa gotowa. Postęp uczniów widzisz na żywo.
Wyniki
Po zakończonej sesji pobierz wyniki w PDF/CSV — indywidualnie lub zbiorczo. Statystyki per pytaniepokazują najtrudniejsze pytania w klasie (jaki% klasy odpowiedziało źle).

Dla Ucznia

A
Dołączanie
Wejdź na stronę dołączania lub kliknij „Jestem uczniem” na stronie głównej. Wpisz 6-znakowy kod od nauczyciela oraz swoje imię i nazwisko. Nie potrzebujesz konta ani maila.
B
Rozwiązywanie kartkówki
Po starcie sesji odpowiadaj na kolejne pytania. Twoja odpowiedź zapisuje się automatycznie co 1.2 sekundy — możesz odświeżyć stronę, zmienić urządzenie czy stracić internet, postęp pozostaje. W każdym momencie widzisz pozostały czas.
C
Wyniki
Po oddaniu zobaczysz wynik procentowy oraz wyjaśnienia błędnych odpowiedzi (jeśli nauczyciel je dodał). Możesz pobrać swój arkusz w PDF.

Jak działa ocenianie

Aplikacja używa algorytmu Damerau-Levenshteina z chemiczno-językowymi tolerancjami. Konkretnie akceptujemy:

Polskie znaki opcjonalne
„wegla" = „węgla" = „WĘGLA"
Wzory chemiczne — różne zapisy
„H2O" = „H₂O" = „H_2O"
Drobne literówki
„siakra" → „siarka" (1 zamiana znaku)
Jednostki opcjonalne
„48" = „48 g" = „48g"
Synonimy w nawiasach
„hydrat (kryształowodan)" — oba akceptowane
Wielkość liter
„HCl" = „hcl" = „HCL" (zawsze)
Tolerancja jest świadoma. Dla pytań ABCD algorytm wymaga dokładnego wyboru — żadnych domysłów. Dla pytań otwartych zostawiamy ~10% marginesu błędu na literówki, ale nie tolerujemy fundamentalnych pomyłek pojęciowych.

Bezpieczeństwo konta

W Ustawieniach (/teacher/settings) możesz włączyć:

  • 2FALogowanie 2-etapowe przez kod email — po wpisaniu hasła wymagany jest 6-cyfrowy kod wysłany na adres e-mail.
  • ZaufaneZaufane urządzenia — pomiń 2FA na 60 dni dla tego komputera/ telefonu. Możesz cofnąć zaufanie pojedynczego urządzenia lub wszystkich na raz.
  • AlertAlert nowego logowania — gdy ktoś loguje się z nowego kraju lub przeglądarki, dostajesz e-mail z lokalizacją i instrukcją „Wyloguj wszędzie”.
  • SesjeWyloguj wszystkie urządzenia — jeden klik unieważnia wszystkie tokeny i cofa wszystkie zaufane urządzenia. Przydatne gdy podejrzewasz przejęcie.
Po zmianie hasła lub resetowaniu hasła wszystkie zaufane urządzenia są automatycznie cofane — wymagają ponownego 2FA.

Najczęściej zadawane pytania

Nie znalazłeś odpowiedzi?

Napisz do nas — odpowiadamy w 24h.

Sugestie, błędy, pytania o integrację z dziennikiem — wszystko trafia do nas na e-mail.

kontakt@kartkowka.com.pl