Kacper
313e01ad24
- 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>
83 lines
4.3 KiB
Markdown
83 lines
4.3 KiB
Markdown
# 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ę (1–5 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.
|