Files
servicedesk/wiki/client/README.md
Kacper 7a8cf2037c v1.3.0
- Snipe-IT asset inventory integration (Admin > Integracje), optional and off
  by default: connect by API address + personal token (+ SSL-verification
  bypass). Three independent toggles: client can pick which of their own
  Snipe-IT assets a ticket concerns (scoped to admin-selected subcategories,
  empty = never shows), operator sees the requester's assets in a ticket-view
  sidebar, operator can search the whole inventory from that same sidebar (not
  a separate page) for shared equipment. Assets shown as "numer środka - numer
  seryjny - producent model" + category; a linked asset's live status is
  fetched fresh on the ticket page, and unlinking stays available to an
  operator even with both view/search toggles off.
- AI summary: a "Wygeneruj teraz" button for an immediate on-demand refresh,
  plus a new admin toggle to regenerate right after every new reply/note
  instead of only on the next scheduled sweep. The transcript sent to the
  model now also includes the ticket's own opening body, fixing summaries
  missing the original request on long threads.
- Fixed: the status dropdown in the operator ticket view could keep showing
  the pre-change status after a status-changing quick action until the next
  page load (Livewire/Alpine-morph quirk for wire:change-bound selects).
- Docs: README/ARCHITECTURE/CHANGELOG/install/wiki updated for all of the
  above, including correcting the AI-summary refresh description left over
  from the 1.2.1 release notes.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-27 21:11:21 +02:00

4.9 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ł wybór sprzętu dla wybranej podkategorii, zobaczysz listę Twojego sprzętu z ewidencji (Snipe-IT/inwentarza), dopasowaną po Twoim adresie e-mail — kliknij „Powiąż” przy urządzeniu, którego dotyczy zgłoszenie (opcjonalne, ponowne kliknięcie odznacza wybór). Dostępne tylko dla podkategorii, które administrator do tego dopuścił.
  6. 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.
  7. 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 zgłoszenie jest powiązane z konkretnym sprzętem (przez Ciebie przy tworzeniu zgłoszenia albo przez operatora później) — jego nazwa w panelu bocznym „Powiązany sprzęt”,
  • 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.