Files
servicedesk/wiki/client/README.md
Kacper 313e01ad24 v1.2.1
- Generic AI integration (Admin > Integracje > "Integracja AI"), optional and
  off by default: an OpenAI-compatible /chat/completions client (Groq, OpenAI,
  or a self-hosted Ollama instance) configured by base URL, optional API key,
  model, and an SSL-verification toggle. Foundation for the two AI features
  below and anything else that wants an LLM call in the future.
- BookStack automatic content tagging (AI): "Otaguj nową treść"/"Otaguj
  wszystko ponownie" buttons plus `php artisan bookstack:tag-content`
  (--dry-run/--force/--limit=N) tag every book/chapter/page with matching
  helpdesk subcategory names, idempotent by default.
- BookStack search refinement: "Przeszukuj" is now three independent
  checkboxes (Książki/Strony/Rozdziały) instead of a single dropdown, plus a
  new "Szukaj po" setting (nazwa/tagi/oba) — tag matching uses the bare
  subcategory name, matching what auto-tagging writes.
- AI-driven ticket triage + summary (Admin > Integracje > "Automatyzacja AI
  dla zgłoszeń", via new scheduled ai:run-ticket-automation): five toggles
  auto-assign/correct category+subcategory, rewrite an unclear subject, and
  set priority from content, once per ticket in the background; every change
  is logged in the ticket's history. Separately, an AI summary + suggested
  action for every ticket, shown to operators only, with an admin-editable
  prompt.
- Operators can now reassign a ticket to any team, not just one they belong
  to.
- The auto-refresh countdown badges (ticket view, operator queue) are now
  clickable — fetch immediately and reset the countdown.
- All 7 "cyclical" intervals (3 browser refresh countdowns, the notification
  bell poll, and the 4 background scheduled commands) are now configurable
  from Admin > Konfiguracja instead of fixed in code.
- Fixed: an operator viewing a ticket that's deleted or moved outside their
  team scope mid-session is now redirected to the operator queue instead of
  hitting an error.
- Docs: README/ARCHITECTURE/CLAUDE/install/wiki updated for all of the above.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-24 13:38:39 +02:00

4.3 KiB
Raw Permalink Blame History

Przewodnik — Klient

Panel klienta (/client) służy do zgłaszania problemów/próśb i śledzenia ich rozwiązania. Po zalogowaniu każde konto domyślnie ląduje właśnie tutaj — nawet jeśli posiada też uprawnienia operatora lub administratora (przełączysz się przez menu profilu w prawym górnym rogu). Dzwoneczek powiadomień w górnym pasku pokazuje tylko nieprzeczytane powiadomienia — kliknięcie usuwa je z listy.

Zgłaszanie nowej sprawy

  1. Kliknij „Nowe zgłoszenie”.
  2. Wybierz kategorię, a następnie podkategorię — lista i opisy pod każdą pozycją pomagają wybrać właściwą (np. „VPN” vs „Sieć wewnętrzna”).
  3. Uzupełnij temat i opis sprawy. W zależności od wybranej podkategorii mogą pojawić się dodatkowe pola (np. numer inwentarzowy sprzętu, kwota, data potrzebna, zgoda przełożonego) — administrator skonfigurował je specjalnie dla tej podkategorii.
  4. Opcjonalnie dodaj załączniki — przeciągnij pliki na pole załączników albo kliknij, żeby wybrać je z dysku (limit rozmiaru/liczby/plików ustala admin — komunikat o błędzie poinformuje, jeśli coś przekracza limit).
  5. Jeśli administrator włączył podpowiedzi z bazy wiedzy, przy wyborze kategorii/podkategorii może pojawić się lista pasujących artykułów — warto je sprawdzić, zanim wyślesz zgłoszenie.
  6. Wyślij zgłoszenie. Otrzymasz e-mail potwierdzający (jeśli powiadomienia są włączone) z linkiem do podglądu, oraz — jeśli jesteś zalogowany — powiadomienie w dzwoneczku w górnym pasku.

Zgłoszenie można też wysłać bez logowania ze strony głównej — wystarczy podać e-mail; konto zostanie założone automatycznie (jeśli administrator włączył auto-provisioning gości), a dalsze śledzenie sprawy odbywa się przez link z maila albo po zalogowaniu.

Śledzenie zgłoszeń

Dashboard klienta dzieli zgłoszenia na dwie zakładki:

  • Bieżące — zgłoszenia jeszcze nie zamknięte.
  • Archiwum — zgłoszenia zamknięte.

Pole wyszukiwania nad listą przeszukuje numer, temat i treść zgłoszenia (oraz odpowiedzi w wątku).

Otwórz dowolne zgłoszenie, by zobaczyć:

  • aktualny status i priorytet, oraz przypisanego operatora i zespół, który obsługuje sprawę,
  • pełną historię wiadomości (Twoje i operatora — notatki wewnętrzne operatora nie są widoczne dla klienta); załączone obrazy pokazują się jako miniatury,
  • historię zmian — log statusu/priorytetu/zespołu/przypisania z datą,
  • SLA — orientacyjny czas do rozwiązania wg priorytetu sprawy,
  • jeśli administrator włączył integrację z bazą wiedzy — panel z artykułami dopasowanymi do kategorii/podkategorii sprawy (te same podpowiedzi, co przy tworzeniu zgłoszenia).

Wszystko na tej stronie aktualizuje się na żywo — jeśli operator odpowie albo zmieni status/przypisanie, zobaczysz to bez odświeżania strony. Mały licznik przy przycisku „Wróć do listy” to niezależny, okresowy fallback (domyślnie co ok. 30 s), na wypadek gdyby połączenie w tle się zerwało — kliknięcie licznika od razu odświeża stronę i resetuje odliczanie.

Odpowiadanie

W widoku zgłoszenia można dopisać kolejną wiadomość w dowolnym momencie (np. dodać brakujące informacje albo potwierdzić rozwiązanie) — operator zobaczy ją i, jeśli powiadomienia są włączone, dostaniesz e-mail przy każdej zmianie statusu lub nowej odpowiedzi operatora oraz powiadomienie w dzwoneczku w górnym pasku (kliknięcie przenosi od razu do zgłoszenia).

Ocena obsługi

Po zamknięciu zgłoszenia w panelu bocznym pojawia się prośba o ocenę (15 gwiazdek

  • opcjonalny komentarz) — jednorazowa, bez możliwości zmiany po wysłaniu. Mail o zamknięciu zgłoszenia zawiera też bezpośredni link do oceny.

Najczęstsze pytania

  • Nie widzę mojego zgłoszenia — sprawdź zakładkę Archiwum, jeśli sprawa została już zamknięta.
  • Zmieniłem zdanie co do kategorii — napisz o tym w wiadomości; tylko operator/ administrator może zmienić kategorię/podkategorię już złożonego zgłoszenia.
  • Nie dostaję e-maili — powiadomienia e-mail są konfigurowalne przez admina i mogą być wyłączone dla niektórych zdarzeń; sprawdź też SPAM.