Zgłaszanie błędów i sugestii
import { Aside } from ‘@astrojs/starlight/components’;
W każdej chwili możesz wysłać do nas zgłoszenie — opis błędu, propozycję usprawnienia, pytanie. Status każdego zgłoszenia wraca do Ciebie automatycznie przez panel powiadomień.
Skąd zgłaszać błąd
Section titled “Skąd zgłaszać błąd”W prawym dolnym rogu każdego widoku po zalogowaniu widzisz dwa pływające przyciski:
┌──┐ │🔔│ ← Powiadomienia (z licznikiem nieprzeczytanych) └──┘ ┌──┐ │🐛│ ← Zgłoś błąd └──┘Kliknięcie ikony 🐛 otwiera formularz zgłoszenia. Działa z dowolnej strony aplikacji — dashboard, sesja, profil pacjenta, ustawienia, etc.
Formularz zgłoszenia
Section titled “Formularz zgłoszenia”| Pole | Wymagane | Wskazówka |
|---|---|---|
| Tytuł | tak (5-200 znaków) | Krótki opis problemu — np. „Nie mogę zapisać pacjenta” |
| Szczegóły | tak (10-5000 znaków) | Co się wydarzyło, jakie były kroki przed wystąpieniem, czego się spodziewałeś/aś? |
| Priorytet | tak | Niski / Średni / Wysoki / Krytyczny — pomóż nam zrozumieć pilność |
Załączniki diagnostyczne
Section titled “Załączniki diagnostyczne”Pomagają nam drastycznie szybciej zlokalizować przyczynę problemu. Wszystkie domyślnie zaznaczone — możesz odznaczyć jeśli nie chcesz załączać.
📸 Auto zrzut ekranu
Section titled “📸 Auto zrzut ekranu”Po zaznaczeniu — formularz robi zrzut aktualnego widoku w momencie wysyłki. Bez konieczności ręcznego klikania PrintScreen i wgrywania pliku.
📋 Logi z konsoli
Section titled “📋 Logi z konsoli”Po zaznaczeniu — załączamy ostatnie 200 wpisów technicznych logów Twojej przeglądarki. To informacje o akcjach aplikacji (np. „rozpoczęto upload sesji”, „błąd zapisu”) — bez treści sesji, bez transkrypcji, bez danych pacjentów. Pomagają nam zobaczyć co dokładnie się stało technicznie.
Pole pokazuje aktualną liczbę dostępnych wpisów (np. „47 wpisów”).
📁 Manualny upload pliku
Section titled “📁 Manualny upload pliku”Alternatywa do auto-zrzutu — możesz załączyć własny obrazek (PNG/JPG, max 5 MB). Przydatne gdy:
- chcesz załączyć zrzut zrobiony chwilę wcześniej (przed problemem)
- chcesz dorzucić zdjęcie z telefonu
- używasz urządzenia, na którym auto-zrzut nie działa
Manualny plik nadpisuje auto-zrzut, jeśli oba są zaznaczone.
Co się dzieje po wysłaniu
Section titled “Co się dzieje po wysłaniu”- ✅ Zgłoszenie trafia do naszego zespołu z statusem „Nowe”
- ✅ Załączniki (zrzut + logi) są wgrywane do bezpiecznego magazynu w UE
- ✅ Dostajesz potwierdzenie w postaci komunikatu „Dziękujemy! Zgłoszenie zostało wysłane”
- ✅ Zmiany statusu (przyjęcie do analizy, naprawa, rozwiązanie) automatycznie pojawiają się w panelu powiadomień Twojego konta
Nie musisz monitorować e-maila ani wracać do żadnej strony — informacje przychodzą do Ciebie w aplikacji.
Panel powiadomień
Section titled “Panel powiadomień”Ikona 🔔 w prawym dolnym rogu pokazuje liczbę nieprzeczytanych powiadomień:
- Bez powiadomień — szary kolor ikony, brak licznika
- Z nieprzeczytanymi — fioletowa ikona aktywna, czerwony badge z liczbą (np. „3”, „99+”)
Kliknięcie ikony otwiera panel z prawej strony zawierający:
- Wszystkie zgłoszone błędy wraz z aktualnym statusem
- Inne komunikaty systemowe (np. „Sesja przeanalizowana”, „Subskrypcja wygasa za 3 dni” — w przyszłości)
- Sortowanie — najnowsze na górze
- Wyróżnienie nieprzeczytanych — niebieska kropka i tło highlight
- Czas relatywny — „teraz”, „5 min temu”, „2 godz. temu”,
DD.MM.YYYYdla starszych
Akcje w panelu
Section titled “Akcje w panelu”| Co kliknąć | Co się stanie |
|---|---|
| Pojedyncza pozycja | Oznaczenie jako przeczytane (zniknie kropka, tło wraca do neutralnego) |
| „Oznacz wszystkie” | Wszystkie nieprzeczytane → przeczytane (jednym ruchem) |
| ❌ (zamknij) | Schowanie panelu bez modyfikacji |
Automatyczne wykrywanie błędów
Section titled “Automatyczne wykrywanie błędów”MIND automatycznie wykrywa błędy zgłaszane przez aplikację i otwiera formularz zgłoszenia z wstępnie wypełnionymi polami. Zobaczysz wówczas formularz z żółtym banerem na górze:
✨ Wykryto błąd w aplikacji. Pola są wstępnie wypełnione — dodaj proszę co robiłeś/aś przed wystąpieniem problemu.
Co jest wypełnione automatycznie:
- Tytuł — pierwsza linia błędu (skrócona do 100 znaków)
- Opis — pełna treść błędu z prefiksem
[Wykryto automatycznie z konsoli]+ miejsce na Twój własny opis kroków - Priorytet — sugerowany „Wysoki” (możesz zmienić)
- Załączniki — domyślnie zaznaczone (auto-screenshot + logi konsoli)
Twój udział ogranicza się do dodania krótkiego opisu „co robiłem zanim się wydarzyło” i kliknięcia Wyślij.
Kiedy formularz NIE pojawi się automatycznie
Section titled “Kiedy formularz NIE pojawi się automatycznie”Mamy mechanizmy chroniące przed spamem:
- Max 1 dialog naraz — gdy formularz jest otwarty, kolejne błędy są ignorowane
- 5 min cooldown — po zamknięciu (anulowaniu lub wysłaniu) formularz nie pojawi się ponownie przez 5 min, nawet jeśli wystąpią nowe błędy
- Dedup 30 sekund — jeśli ten sam błąd pojawi się dwukrotnie w ciągu 30 sekund, pokazujemy go tylko raz
- Filtr fałszywych alarmów — błędy pochodzące z rozszerzeń przeglądarki, ResizeObserver loops i niektórych bibliotek są pomijane
Wyłączenie auto-otwierania
Section titled “Wyłączenie auto-otwierania”W stopce automatycznie otwartego formularza widzisz przycisk:
🔕 Wyłącz na tę sesję
Kliknięcie wyłącza auto-popup do końca bieżącej sesji (zamknięcia karty / wylogowania). Po następnym zalogowaniu auto-wykrywanie znów działa. Możesz zawsze ręcznie zgłosić błąd klikając ikonę 🐛 w prawym dolnym rogu.
Statusy zgłoszeń
Section titled “Statusy zgłoszeń”Każde zgłoszenie przechodzi przez następujące statusy:
| Status | Kolor | Co znaczy |
|---|---|---|
| Nowe | niebieski | Właśnie wysłane, czeka na zespół |
| Przyjęte do analizy | żółty | Zespół potwierdził, że zna problem i analizuje |
| W trakcie naprawy | fioletowy | Trwa praca nad rozwiązaniem |
| Rozwiązane | zielony | Naprawa wdrożona — sprawdź czy problem zniknął |
| Odrzucone | szary | Nie naprawiamy (np. zgłoszenie out-of-scope, duplikat, oczekiwane zachowanie) |
Każda zmiana statusu automatycznie tworzy nową notyfikację w panelu z odpowiednim opisem.
Bezpieczeństwo i prywatność
Section titled “Bezpieczeństwo i prywatność”- 🔒 Zgłoszenia są prywatne — widzisz tylko swoje zgłoszenia w panelu powiadomień; inni użytkownicy MIND ich nie widzą
- 🔒 Załączniki w bezpiecznym magazynie w UE — chmurze enterprise z TLS 1.3 i AES-256
- 🛡️ Logi konsoli ≠ dane sesji — zawierają informacje techniczne (np. komunikaty o błędach uploadu), ale nie zawierają transkrypcji sesji, notatek ani treści dokumentów klinicznych
- 🚫 Zgłoszeń nie da się usunąć — to dokumentacja problemów, którą my musimy zachować dla celów jakości
Częste pytania
Section titled “Częste pytania”Czy mogę zgłosić sugestię rozwoju zamiast błędu?
Section titled “Czy mogę zgłosić sugestię rozwoju zamiast błędu?”Tak, formularz służy też do propozycji rozwoju i pytań. Wybierz priorytet „Niski” dla sugestii — odróżni je od pilnych błędów blokujących pracę.
Czy zgłoszenia są anonimowe?
Section titled “Czy zgłoszenia są anonimowe?”Nie — przy każdym zgłoszeniu widzimy Twoje konto (e-mail). Pozwala nam to skontaktować się z Tobą po dodatkowe informacje lub potwierdzić, że problem został rozwiązany. Twoje zgłoszenia nie są publiczne — widzisz je tylko Ty i nasz zespół supportu.
Co jeśli auto-zrzut ekranu zawodzi?
Section titled “Co jeśli auto-zrzut ekranu zawodzi?”Niektóre przeglądarki blokują tę funkcję. Wtedy:
- Odznacz „Załącz zrzut ekranu (auto)”
- Zrób zrzut ręcznie (PrintScreen / Cmd+Shift+4)
- Załącz przez „Wybierz” w sekcji manualnego uploadu
Jak długo czekam na odpowiedź?
Section titled “Jak długo czekam na odpowiedź?”Standardowy SLA to:
- Krytyczne — odpowiedź tego samego dnia roboczego
- Wysokie — w ciągu 2 dni roboczych
- Średnie / Niskie — w ciągu 7 dni roboczych
W każdej chwili sprawdzisz status w 🔔 panelu powiadomień.
Czy mogę dodać kilka zgłoszeń?
Section titled “Czy mogę dodać kilka zgłoszeń?”Tak — bez limitu. Każde z nich będzie miało osobny status i osobne powiadomienia.
Powiązane
Section titled “Powiązane”- Awaria w trakcie sesji — co zrobić, gdy aplikacja zamknęła się podczas nagrywania (recovery flow)
- Prywatność i RODO — jakie dane są przechowywane i przez jaki czas
W razie pilnych spraw możesz też napisać bezpośrednio na kontakt@synapsa.app.