Baza pytań do aplikacji lub LMS: CSV, JSONL i wymagania jakości

Jaki format wybrać: CSV czy JSONL?

CSV dobrze sprawdza się w prostych tabelach i arkuszach kalkulacyjnych. Wymaga jednak jasnych zasad kodowania, separatorów, pustych pól i zapisu wielowierszowych treści. Przy materiałach z dużą liczbą załączników i różnymi typami pytań bardziej elastyczny może być JSONL — jeden rekord JSON w każdej linii.

Nie ma jednego najlepszego formatu dla każdej platformy. Gdy docelowy system posiada model relacyjny, można przygotować tabele pytań, odpowiedzi, kategorii i załączników. Ważniejsze od rozszerzenia pliku jest to, czy da się odtworzyć znaczenie każdego pola bez odgadywania jego zawartości.

Minimalna struktura rekordu

Pytanie powinno mieć stabilny identyfikator niezależny od kolejności w pliku, rodzaj zadania, treść, listę odpowiedzi lub kryteria oceny, wskazanie poprawnej odpowiedzi, kategorię i wersję. Do tego warto zapisać źródło oraz daty publikacji i merytorycznej weryfikacji. Rekord bez odpowiedzi albo z kluczem roboczym nie powinien być oznaczany jako „zatwierdzony”.

Jeżeli zadanie wykorzystuje grafikę, odnośnik do pliku powinien wskazywać konkretną wersję. Sam URL do zewnętrznej strony nie gwarantuje, że materiał przetrwa import, zmiany licencji lub wyłączenie serwera.

• id: stały identyfikator rekordu.
• stem: jednoznaczna treść pytania.
• options / answer: warianty i prawidłowa odpowiedź albo kryteria.
• source / reviewed_at: pochodzenie oraz data przeglądu.
• status / rights: stan kontroli i uprawnienia do wykorzystania.

Automatyczne testy, które naprawdę warto mieć

Pierwszym etapem QA jest kontrola składni i liczby rekordów. Kolejne to wykrywanie duplikatów, zgodności kluczy z wariantami, pustych pól, brakujących załączników i znaków uszkodzonych przy imporcie. Dobrze, jeśli test potrafi pokazać konkretny rekord oraz przyczynę odrzucenia.

Następnie potrzebna jest ocena ekspercka próbek i miejsc podwyższonego ryzyka. Automatyczny test zgodności pól nie rozstrzyga, czy odpowiedź jest zgodna z aktualnym prawem, medycyną czy normą techniczną. To dwa odrębne poziomy kontroli.

Licencja i dystrybucja są osobnymi tematami

Kupienie pliku nie zawsze daje prawo do wgrania jego zawartości do publicznej aplikacji, a tym bardziej do odsprzedaży całego zbioru. Zawsze sprawdzaj zakres licencji, źródło materiałów i warunki korzystania z ilustracji. W systemie B2B warto rozdzielić uprawnienia do wewnętrznej nauki, komercyjnego użycia w aplikacji i dalszej dystrybucji.

EGZATEKA opisuje zakres i stan poszczególnych pakietów, ale sam opis produktu nie zastępuje sprawdzenia praw do konkretnej edycji. Przed integracją danych we własnym systemie wymagaj wykazu źródeł, wersji i braków.

Wersjonowanie i aktualizacje

Z każdą nową publikacją zapisuj identyfikator wydania, sumę kontrolną pliku oraz listę zmian. Pozwala to odtworzyć, które pytania były aktywne w danym dniu i czego używano podczas szkolenia. Gdy zmienia się przepis wpływający na odpowiedź, nowa wersja powinna zawierać merytoryczne uzasadnienie zmiany, a nie tylko zamianę litery klucza.

Taki proces ogranicza liczbę sporów z klientami i ułatwia aktualizację aplikacji. Dla zespołów tworzących materiały w większej skali jest to podstawowy element jakości, nie luksusowy dodatek.