Files
servicedesk/wiki/client/README.md
Kacper 0b06687ea1 v1.1.2
- Real-time updates (Laravel Reverb): live operator queue, live ticket
  chat/detail updates for operator and client, periodic fallback refresh
  with a visible countdown as a backstop for dropped websocket connections.
- SLA automation rules (Admin > Automatyzacja SLA): act on a ticket after
  N minutes of customer silence (change priority/status/team/assignee),
  evaluated every 15 minutes, reusing TicketService's own setters so
  automated changes get the same history/notification/broadcast a manual
  change would.
- New notification: every operator on a matching team gets notified when
  a new ticket lands in one of their subcategories.
- BookStack knowledge-base sidebar now also shown on the client's own
  ticket view (previously operator-only); suggestions everywhere now load
  in after first paint instead of blocking it.
- Client ticket view: shows assigned operator + team; page widened to
  match the operator's.
- Notification bell shows unread only; read notifications disappear
  instead of just dimming.
- Stats dashboard: sectioned layout, new breakdowns (by subcategory, CSAT
  by team/operator, top clients, client x subcategory cross-tab).
- Mobile: nav dropdowns (theme/notifications/profile) now expand full
  width instead of overflowing off-screen below 640px.
- Fixed two bugs that silently disabled all real-time updates (missing
  CSRF header on Echo's private-channel auth; a script-load-order race
  that could miss the livewire:init event) and the mariadb healthcheck
  (world-writable credentials file on this stack's NFS mount).
- Assorted test-suite fixes (roles virtual attribute needs the roles
  table seeded; a few missing seeds/wrong assertions found along the way).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-22 20:43:05 +02:00

4.2 KiB
Raw 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 (co ok. 30 s), na wypadek gdyby połączenie w tle się zerwało.

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.