Files
servicedesk/wiki/client/README.md
Kacper 90fae0a4de v1.1.0
- In-app notifications: a bell in the top bar backed by Laravel's database
  notification channel, alongside existing e-mail notifications (same
  per-trigger toggle drives both; ticket links now correctly point into the
  recipient's own area instead of always linking to the client view).
- Drag-and-drop attachments on every upload form, plus inline image
  thumbnails in the message thread instead of a plain download link.
- Customer satisfaction (CSAT) rating: clients rate a closed ticket 1-5 stars
  with an optional comment; shown read-only to operators, surfaced as a KPI
  on the stats dashboard, and linked from the "ticket closed" e-mail.
- Saved queue views: operators can save/apply/delete named filter+sort+
  column presets in the ticket queue and mark one as their default.
- Full-text search (MySQL FULLTEXT, portable LIKE fallback) across ticket
  subject/body and reply message bodies, now also on the client's own ticket
  list.
- Stats CSV export for the currently filtered ticket set.
- Optional BookStack knowledge-base integration (off by default): suggests
  articles by category/subcategory while creating a ticket and in a separate
  sidebar for operators on an existing ticket (with a copy-link button).
  Configurable connection/SSL bypass/search-type filter, plus two
  independent per-shelf allow-lists so nothing is ever searched until an
  admin opts specific shelves in.
- Closed tickets no longer show in "Moje zgłoszenia"/"Nieprzypisane"/team
  queue tabs, only under "Zamknięte" (matching how "Otwarte" already worked).
- Wired up the Admin > About "Wersja" field to config('app.version')/VERSION
  in .env instead of a stale hardcoded string.
- Fixed: TicketService::setStatus() now checks a status's stage rather than
  the literal key 'closed' to decide whether to fire the "ticket closed"
  notification/stop the timer.
- Updated README/ARCHITECTURE/CHANGELOG/install/SECURITY docs and all three
  wiki/ role guides for the above; documented a root-vs-www-data file
  ownership gotcha in CLAUDE.md (running artisan commands via a plain
  `docker exec` can leave root-owned Blade cache files that later break
  recompilation for the www-data Apache process).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-22 15:18:09 +02:00

3.4 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).

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,
  • pełną historię wiadomości (Twoje i operatora — notatki wewnętrzne operatora nie są widoczne dla klienta); załączone obrazy pokazują się jako miniatury,
  • SLA — orientacyjny czas do rozwiązania wg priorytetu sprawy.

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.