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.
Utwórz klasę
Przejdź do „Klasy” w nagłówku i kliknij „+ Nowa klasa”. Nadaj jej nazwę (np. „3A chemia rozszerzona”) i opcjonalnie krótki opis. Klasa działa jako tag pod który później podepniesz kartkówki i wyniki — możesz filtrować sesje i statystyki per klasa. Klas możesz mieć dowolnie wiele, są prywatne (widzisz tylko Ty).
Tworzenie pytań
Przejdź do „Pytania” w nagłówku. Dwa typy własności:
  • 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. Jeśli chcesz dodać pytanie do puli wspólnej — użyj przycisku „Zaproponuj pytanie”; propozycję zatwierdza administrator. Generator AI (1–20 pytań z wybranego tematu przez Claude Sonnet) jest dostępny tylko dla administratora puli wspólnej — z opcjonalnym drugim modelem-sędzią, który stara się odsiewać pytania z błędami merytorycznymi.
4
Tworzenie kartkówki
Na dashboardzie kliknij „Nowa kartkówka”. Wybierz tytuł, czas (minuty), liczbę pytań i opcjonalnie klasę. Trzy tryby doboru pytań (zakładki w oknie):
  • 🎲 Automatyczny — system sam losuje pytania z zakresu klasy. Możesz określić rozkład pytań per temat(np. 4 × Mol, 3 × Roztwory, 3 × Reakcje = 10 pytań). Najszybszy sposób — dobry na codzienną kartkówkę.
  • 🔀 Cross-scope (mieszany zakres) — dla każdego tematu osobno wybierasz z jakiej klasy mają lecieć pytania (np. Mol z klasy 2 rozszerzenie, Roztwory z klasy 1 podstawa). Przydatne przed maturą albo przy powtórkach międzyklasowych.
  • ✋ Ręczny wybór — otwierasz listę wszystkich pytań z zaznaczonego zakresu, filtrujesz po temacie/tekście i ręcznie zaznaczasz konkretne pytania. Pełna kontrola nad zestawem — dobre na wejściówki, kolokwia, powtórki „po Twojemu”.
Opcje anti-ściąganie (checkboxy w oknie):
  • 🎯 Losuj kolejność pytań per uczeń — każdy uczeń dostanie ten sam zestaw pytań, ale w innej kolejności. Sąsiad nie ma jak podpatrzeć „które pytanie 3?”. Zapamiętane per uczeń, więc po odświeżeniu widzi tę samą kolejność.
  • 👥 Grupy A/B (dwa kody, różne pytania) — najsilniejsze zabezpieczenie. Kartkówka dostanie dwa kody, pół klasy wchodzi kodem A, druga połowa kodem B. Oba kody mają pytania z tych samych tematów, ale całkowicie różne treści. Wystartują i skończą się jednocześnie; wyniki lecą do wspólnej statystyki. W trybach Automatyczny i Cross-scopewymaga 2× więcej pytań na temat w puli. W trybie ✋ Ręcznyzobaczysz dwa taby (Grupa A / Grupa B) — wybierasz pytania osobno do każdej puli, system pilnuje żeby nie powtarzały się.
💡 Możesz łączyć oba anti-cheat: Grupy A/B rozdzielają pule pytań, a losowa kolejność miesza sekwencję wewnątrz każdej grupy. Razem = maksymalna ochrona przed ściąganiem.Nie musisz kończyć od razu — „Zapisz jako szkic” odłoży konfigurację, a wrócisz do niej z panelu „Moje szkice”.Masz gotową kartkówkę i chcesz uruchomić ją w kolejnej klasie? Użyj 📋 Duplikuj na karcie sesji — pojawi się mini-picker klasy i nowa sesja dostanie własny kod, gotowa do uruchomienia.
Prowadzenie sesji
Po utworzeniu zobaczysz 6-znakowy kod (lub dwa kody A i B w trybie Grupy A/B — wtedy również dwa osobne kody QR, po jednym dla każdej grupy) oraz linka „Dołącz". Uczniowie skanują QR albo wchodzą na stronę „Dołącz” i wpisują kod. Klikasz „Rozpocznij” gdy klasa gotowa. Podczas sesji widzisz:
  • ⏱ Zegar odliczający do końca kartkówki (żółty ≤2 min, czerwony pulsujący ≤30 s).
  • Live status każdego ucznia — awatar z numerem w dzienniku i etykieta: „Dołączył” (poczekalnia, przed startem),„Pisze” (sesja aktywna) lub „Oddane” z wynikiem.
  • W trybie Grupy A/B — widget 👥 Grupy A vs B z balansem dołączeń (zielony ✓ gdy zrównoważone, czerwony ⚠ w innym wypadku) oraz porównanie średnich (alert gdy różnica ≥8 pp).
  • 🧹 Usuń duplikaty — jeśli uczeń przypadkiem dołączył kilka razy, jeden klik czyści nadmiarowe puste wpisy. Prace już oddane są chronione i nie zostaną skasowane.
Automatyczne zakończenie: po upływie limitu czasu system sam flipuje sesję na „Zakończona”, automatycznie oddaje arkusze uczniów którzy nie zdążyli kliknąć „Oddaj” (nieodpowiedziane pytania liczą się jako błędne), i wysyła Ci powiadomienie na dashboardzie. Możesz też zakończyć wcześniej klikając „Zakończ” — działa tak samo.
Wyniki i przegląd pytań
Po zakończonej sesji pobierz wyniki w PDF/CSV — indywidualnie lub zbiorczo. Statystyki per pytaniepokazują najtrudniejsze pytania w klasie (jaki% klasy odpowiedziało źle). Dodatkowo panel „Użyte pytania” wyświetla całą pulę wykorzystaną w kartkówce — dla pytań ze wspólnej puli możesz kliknąć „Zgłoś poprawkę”, żeby wysłać administratorowi uwagę (np. „poprawna odpowiedź to B, nie A”) prosto z widoku sesji.

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 imię (bez nazwiska) i numer w dzienniku (1–40). Nie potrzebujesz konta ani maila — pełna zgodność z RODO. Jeśli klikniesz „Dołącz” drugi raz z tego samego urządzenia, wrócisz do swojej rozpoczętej pracy zamiast tworzyć nowy wpis.
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. Jeśli nie zdążysz kliknąć „Oddaj” przed końcem czasu — system i tak wyśle Twoje zapisane odpowiedzi automatycznie (nieodpowiedziane pytania liczą się jako błędne). Nauczyciel może też zakończyć wcześniej — zostaniesz od razu przekierowany do widoku wyników z komunikatem, że praca została zapisana.
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.

chemiainfo@kartkowka.pl