Asystent sędziego ISSF – szybkie odpowiedzi z regulaminów

W panelu administratora pojawiło się nowe narzędzie: Asystent sędziego ISSF.
Jego celem jest przyspieszenie pracy sędziów i obsługi zawodów, gdy trzeba szybko znaleźć przepis w regulaminach ISSF lub Ustawie o broni i amunicji (np. wymiary tarcz, wymagania sprzętowe, procedury).

🆕 Co zostało dodane?

• Nowa pozycja w menu admina: „Asystent sędziego ISSF”.
• Okno czatu z asystentem, który odpowiada na pytania na podstawie:
  • regulaminów ISSF oraz Ustawy o broni i amunicji wgranych do workspace,
  • numerów paragrafów (np. 6.3.1, 7.3),
  • nazw plików PDF (np. issf2023_karabin.pdf).
• Obsługa wielu instancji rozmów:
  • możesz mieć kilka równoległych wątków (np. osobno tarcze, osobno procedury bezpieczeństwa),
  • każda instancja ma własny kontekst i historię.
• Historia wszystkich rozmów zapisywana w bazie danych – nic nie ginie po przeładowaniu strony.

⚙️ Gdzie to znaleźć?

1. Zaloguj się do Panelu administratora.
2. W lewym menu wybierz:

Asystent sędziego ISSF

3. Zobaczysz ekran podzielony na dwie części:
   • lewo – lista instancji (wątków rozmowy),
   • prawo – okno czatu z asystentem.

📝 Jak korzystać z asystenta?

1. Zadawanie pytania

W prawej kolumnie:

1. Wpisz pytanie w polu tekstowym, np.:

„Jakie są wymiary tarczy karabinowej 10 m według przepisów ISSF?”

albo o Ustawę o broni i amunicji:

„Jakie wymagania dotyczą przechowywania broni według Ustawy o broni i amunicji?”

2. Wyślij pytanie:

   • Enter – wysyła wiadomość,
   • Shift + Enter – dodaje nową linię (bez wysyłania),
   • albo kliknij przycisk „Szukaj w regulaminach”.

3. Po chwili zobaczysz odpowiedź:

   • sformatowaną w Markdown (wypunktowania, pogrubienia),
   • z odwołaniami do konkretnych dokumentów i paragrafów.

2. Czytanie odpowiedzi

Asystent podaje:

• nazwę dokumentu, np. issf2023_karabin.pdf,
• konkretne paragrafy, np. 6.3.1, 7.3,
• czasem listę kroków lub parametrów (np. średnice tarczy, wymagane odległości).

Rekomendowany sposób pracy:

• potraktuj odpowiedź jako skrót,
• w razie wątpliwości otwórz wskazany dokument i paragraf i zweryfikuj zapis oryginalny.

🔁 Instancje rozmów – kiedy używać wielu wątków?

Lewa kolumna to lista instancji (wątków rozmowy):

• każda instancja ma:
  • opis kontekstu (skrót ostatniego pytania),
  • ID rozmowy,
  • skrót API ID – identyfikator techniczny sesji po stronie asystenta.
• kliknięcie w wiersz:
  • przełącza prawą część ekranu na historię wybranej rozmowy.

Przykładowe zastosowania wielu instancji

• 1️⃣ Wątek „Tarcze i wymiary”
• 2️⃣ Wątek „Klasyfikacja i protesty”
• 3️⃣ Wątek „Bezpieczeństwo na osi”

Dzięki temu nie mieszasz tematów i możesz wrócić do wcześniejszych odpowiedzi z pełnym kontekstem.

🔒 Limit otwartych rozmów

Aby zachować czytelność pracy:

• system pozwala domyślnie na maksymalnie 5 otwartych rozmów,
• po osiągnięciu limitu:
  • przycisk „Utwórz nową rozmowę z asystentem” jest wyszarzony,
  • pojawia się komunikat, że trzeba zamknąć jedną z istniejących rozmów.

Jak zamknąć rozmowę?

Masz dwa sposoby:

1. Z poziomu danej rozmowy – przycisk „Zamknij instancję” pod polem pytania.
2. Z listy instancji po lewej – ikona kosza przy wybranej rozmowie.

Zamknięcie rozmowy:

• nie usuwa historii z bazy,
• tylko ukrywa ją z listy aktywnych w panelu.

🧩 Co jest po drugiej stronie? (technicznie w skrócie)

Dla ciekawych, w paru punktach:

• każda rozmowa ma swój ID i własny sessionId używany w API,
• pytania i odpowiedzi są zapisywane w dwóch tabelach:
  • range_judge_assist_chat_conversations,
  • range_judge_assist_chat_messages,
• odpowiedzi renderowane są w Markdown – dlatego listy i nagłówki wyglądają czytelnie.

Szczegółowa dokumentacja techniczna znajduje się w pliku:

• doc/documentation_range_judge_assist.md

👥 Dla kogo jest ten moduł?

• Sędziowie – szybkie sprawdzenie konkretnego przepisu bez przekopywania PDF-ów.
• Obsługa zawodów – odpowiedzi na pytania zawodników (np. co do zasad, sprzętu, procedur).
• Związek – ujednolicenie interpretacji przepisów (wszyscy pytają tę samą „encyklopedię”).

💬 Masz pomysł na rozwój Asystenta?

Jeśli podczas korzystania z Asystenta zauważysz:

• brakujące obszary dokumentacji,
• niejasne odpowiedzi,
• funkcje, których brakuje (np. eksport rozmowy),

daj nam znać przez standardowe kanały wsparcia ZZSS.
Asystent ma być narzędziem, które realnie odciąża sędziów i obsługę, więc każdy feedback jest dla nas cenny. 🚀