O aplikacji

Jest to hobbystyczny projekt stworzony w trakcie przygotowań do Państwowego Egzaminu Specjalizacyjnego z endokrynologii. Większość dostępnych tego typu aplikacji jest oparta na modelu subskrypcyjnym, zawiera własne interpretacje pytań i odpowiedzi albo dodaje wyjaśnienia bez podpisania źródeł lub autorów. Zależało mi na odpowiedziach bezpośrednio z publicznej bazy CEM (nawet jeśli część z nich może być nieaktualna) albo funkcjach, których nie mogłem znaleźć w płatnych aplikacjach. Nie zamierzam tej aplikacji monetyzować - można ją pobierać, wykorzystywać i udostępniać niekomercyjnie (szczegóły licencji na dole strony startowej).

Baza obejmuje 20 lat egzaminu (2006-2026) razem z oryginalnymi statystykami CEM (trudność, dyskryminacja, rozkład odpowiedzi). Tak jak w innych aplikacjach można uczyć się według sesji, działu tematycznego, oznaczać pytania do powtórki, filtrować po treści albo błędnych odpowiedziach, a także uruchomić pełną symulację egzaminu (oryginalnego lub według swoich kryteriów) z czasem i progami zaliczenia. Przydatną funkcją jest możliwość wygenerowania egzaminu PDF do wydruku i rozwiązania testu na papierze. W opcjach ustawień można zmieniać wygląd aplikacji, kolory, tryb jasny/ciemny. Aplikacja nie zawiera wyjaśnień i komentarzy pytań - dla użytkowników zaawansowanych na własną rękę dostępna jest możliwość dodania modułu LLM (w tym modelu lokalnego) poprzez klucz API.

Całość działa offline, w jednym pliku, bez konta i wysyłania danych poza komputer (z możliwą opcją wykorzystania zapisu ustawień do zewnętrznego pliku - szczegóły niżej). Działa bezproblemowo w przeglądarce w systemach Windows, Mac oraz Android. iPhone domyślnie nie otwiera plików HTML w przeglądarce, więc nie wszystkie funkcje mogą działać prawidłowo - w tej sytuacji proponuję hostowanie aplikacji w sieci lokalnej lub przez serwer (np. Tailscale) - w razie pytań zachęcam do kontaktu.

Źródło pytań

Baza obejmuje 4920 pytań z 41 sesji Państwowego Egzaminu Specjalizacyjnego (PES) z endokrynologii, od sesji wiosna 2006 do wiosna 2026, po 120 pytań na sesję. Pytania i klucze odpowiedzi pochodzą z materiałów Centrum Egzaminów Medycznych (CEM).

W zależności od sesji tekst pozyskano różnymi metodami:

• Sesje 2006-2017 i 2023-2026: web scraping, wraz ze statystykami zdawalności (trudność, dyskryminacja, rozkład odpowiedzi, RPBI) publikowanymi przez CEM.
• Sesje 2018-2020: ekstrakcja tekstu z plików PDF z warstwą tekstową, bez OCR.
• Sesje 2021-2022: skany pytań - PDF-y bez warstwy tekstowej. Tekst odzyskano czterema niezależnymi silnikami OCR (Tesseract LSTM, Tesseract LSTM na obrazie binaryzowanym, Tesseract legacy, Windows.Media.Ocr), a wyniki uzgodniono między silnikami. Klucze odpowiedzi zweryfikowano wzrokowo ze skanów, nie przez OCR, ponieważ automatyczne odczyty myliły niektóre litery.

Dla sesji 2018-2022 CEM nie publikuje danych o zdawalności, dlatego te pytania nie mają w bazie statystyk trudności i dyskryminacji. 20 pytań zostało formalnie unieważnionych przez CEM, są oznaczone w bazie i wyłączone z liczenia wyniku.

Tagi tematyczne (28 działów, według rozdziału B01-IV Interny Szczeklika) przypisano metodą słownikową z wagami, z dopasowaniem bez znaków diakrytycznych i po rdzeniach wyrazów, skontrolowaną metodą TF-IDF/kNN. Pierwszy tag jest najdokładniejszy, tagi dodatkowe mogą mieć mniejszą skuteczność i wynikać z obecności słowa kluczowego w dystraktorach. Szacowany błąd tagowania to 1-2 procent.

Jak powstała ta aplikacja

Aplikacja została zaprojektowana jako jeden plik HTML, działający bez zewnętrznych bibliotek i bez połączenia z internetem - wystarczy kliknąć dwukrotnie ikonę pliku (ale to już wiesz, skoro to czytasz). Baza pytań jest wpisana w kod strony, dzięki czemu nie ma konieczności używania osobnego serwera albo bazy danych. Dzięki temu założeniu plik można również hostować na serwerze, żeby używać z dowolnego urządzenia, albo zapisać na pendrivie/przesłać mailem. Aplikacja ma opcję zapisu ustawień do osobnego pliku i wczytania ustawień z pliku - wówczas można przenosić/przesyłać sam plik z ustawieniami i jest to najpewniejszy sposób zapisania ustawień i postępów do kolejnej sesji.

Przy tworzeniu aplikacji korzystałem z LLM: Claude Sonnet 5 i Claude Opus (Anthropic PBC, San Francisco, CA, USA) oraz Ministral 3 14B (Mistral AI, Paris, France) do pisania i edycji kodu aplikacji (HTML, CSS, JavaScript), do pisania skryptów pomocniczych przy webscrapingu i OCR. Cały kod i materiały wygenerowane przez LLM zostały sprawdzone i poprawione przed publikacją, a ostateczny wygląd, kształt i funkcje aplikacji zostały zaprojektowane przeze mnie.

Gdzie zapisuje się mój postęp

Postęp zapisuje się automatycznie w pamięci przeglądarki, powiązanej z dokładną lokalizacją tego pliku. Jeśli przeniesiesz plik do innego folderu, zmienisz jego nazwę, otworzysz go na innym urządzeniu albo w innej przeglądarce, twoje dane mogą się zresetować - najpewniejszym sposobem na uniknięcie tego jest zapisanie swoich ustawień i postępów do pliku i wczytywanie go do aplikacji w razie potrzeby.

Zapisanie ustawień odbywa się poprzez przycisk „Zapisz postęp do pliku" w Profilu. Taki plik możesz trzymać na pendrivie, wysłać mailem albo wczytać na innym urządzeniu - warto robić to od czasu do czasu jako kopię zapasową, a na pewno przed przeniesieniem samego pliku aplikacji w inne miejsce.