Język marki
Język marki
Rzeczowo. Konkretnie. Bez nadmiaru. Mówimy o porządku, dostępie do informacji i kolejnej czynności. Nie obiecujemy wyników klinicznych ani automatycznej zgodności z przepisami.
- Stan rozdziału:
- gotowe
Ton
Cytat
Mówimy o porządku, dostępie do informacji i kolejnej czynności. Nie obiecujemy wyników klinicznych ani automatycznej zgodności z przepisami.
| Zasada | W praktyce |
|---|---|
| Rzeczowo | Podmiot, orzeczenie, dopełnienie. Liczby, daty, nazwy urządzeń. „Termin minął 02.08.2026”, nie „Uwaga! Przegląd zaległy!” |
| Konkretnie | Zamiast „zarządzaj dokumentacją” piszemy „zbierz protokoły i historię przy urządzeniu”. Czasownik, który da się wykonać. |
| Bez nadmiaru | Jedno zdanie, gdy wystarcza jedno. Bez wykrzykników, bez „ups”, bez emotikonów, bez „innowacyjny”, „inteligentny”, „kompleksowy”. |
| Spokojnie | Termin po terminie jest zadaniem, nie alarmem. Nie straszymy kontrolą i nie straszymy pacjentem. |
| Do człowieka | Zwracamy się na „Ty” w interfejsie i w mailu do osoby, na „Państwo” w ofercie do placówki. Nigdy „użytkownik może…”. |
| Ich słowami | Laboratorium mówi „wzorcowanie”, pracownia RTG „test specjalistyczny”, oddział „przegląd”. System nazywa czynność tak, jak nazywa ją placówka, bo typ czynności jest daną. |
Tak piszemy, tego unikamy
| Tak piszemy | Tego unikamy |
|---|---|
| Zobacz terminy przeglądów w jednym miejscu. | Już nigdy nie przegapisz przeglądu. |
| Zbierz protokoły i historię przy urządzeniu. | Pełna zgodność z przepisami bez wysiłku. |
| Zeskanuj QR, aby otworzyć kartę urządzenia. | Jeden skan gwarantuje bezpieczeństwo. |
| Termin minął. Sprawdź historię i zaplanuj dalsze działania. | To urządzenie zagraża pacjentom. |
Cztery pary z brandbooka (s. 14) w oryginalnym brzmieniu. Prawa kolumna to nie tylko zły styl. Każde z tych zdań obiecuje coś, czego system nie kontroluje: wynik, zgodność, bezpieczeństwo. Trzecie i czwarte wprowadzają do produktu pacjenta, którego produkt nie dotyczy.
Komunikaty błędu
Cytat
Błąd + następny krok: Nie udało się dodać protokołu. Spróbuj ponownie.
| Wzorzec | Przykład | Uwaga |
|---|---|---|
| Co się nie udało + co zrobić | Nie udało się dodać protokołu. Spróbuj ponownie. | Dwa zdania. Pierwsze nazywa czynność, drugie daje krok. |
| Co jest nie tak z polem + jak poprawić | Data nie może być późniejsza niż dziś. | Bez „nieprawidłowa wartość”. Mówimy, jaka reguła została naruszona. |
| Błąd po naszej stronie | Coś poszło nie tak po naszej stronie. Nic nie zostało zapisane. Spróbuj jeszcze raz, a jeśli błąd wróci, daj nam znać. | Zapewnienie „nic nie zostało zapisane” jest ważniejsze niż przeprosiny. Bez kodu błędu w treści dla użytkownika. |
| Nie ma takiej strony | Nie ma takiej strony. Adres jest nieaktualny albo zawiera literówkę. Sprawdź go albo wróć do pulpitu. | Dwa wyjścia. |
| Brak zasięgu (do napisania) | Wpis czeka na połączenie. Zapisze się sam, gdy wróci zasięg. | To nie jest błąd, tylko stan. Nie pokazujemy go na czerwono. |
- Bez winy po stronie użytkownika: „podałeś zły numer” zamieniamy na „numer nie pasuje do wzoru NN-NNNNN”.
- Bez „błąd”, „error”, „nieprawidłowy”, „niepoprawny” jako jedynej treści. Te słowa niczego nie mówią.
- Bez „proszę” i bez „przepraszamy”. Zamiast tego konkret i następny krok.
- Nie zmieniamy etykiety przycisku na „Zapisywanie…”, bo zmiana szerokości przesuwa sąsiadów. Przycisk jest wyłączony, etykieta zostaje.
Mikrokopia przycisków
| Reguła | Tak | Nie |
|---|---|---|
| Czasownik w trybie rozkazującym plus dopełnienie | Dodaj urządzenie · Zapisz protokół · Wczytaj arkusz ewidencji · Otwórz paszport | OK · Wyślij · Dalej · Urządzenie |
| To, co się stanie, nie to, gdzie się jest | Wydrukuj etykiety QR | Etykiety |
| Anulowanie nazywa się „Anuluj”, powrót „Wróć do…” | Anuluj · Wróć do karty urządzenia | Cofnij (to jest osobna czynność) · Zamknij (gdy nic się nie zamyka) |
| Decyzja nazywa się po swojemu | Przyjmij · Odrzuć · Zamknij zgłoszenie | Tak · Nie · Potwierdź |
| Czynność nieodwracalna mówi, co zrobi | Wycofaj z użytkowania | Usuń |
| Bez wykrzykników i bez emotikonów | Zobacz terminy | Zobacz terminy! |
Zasady nazewnictwa
| W interfejsie i w tekstach | W kodzie | Uwaga |
|---|---|---|
| MedPass | medpass | W zdaniu z wielkim M i P. W logotypie tylko z pliku. |
| placówka | facility | Nie „klient”, nie „szpital”, chyba że mowa o konkretnym szpitalu. |
| firma serwisowa | serviceCompany | Nie „serwisant”, gdy chodzi o firmę; „serwisant” to osoba. |
| jednostka (oddział, gabinet, pracownia, dział) | orgUnit | Etykieta zależy od typu placówki. W bazie nie ma słowa „oddział”. |
| urządzenie | device | Nie „aparat”, nie „sprzęt” w interfejsie; „aparatura” dopuszczalna w tekstach marketingowych. |
| zdarzenie, wpis w historii | event | „Wpis” w interfejsie, „zdarzenie” w dokumentacji. |
| przegląd okresowy, wzorcowanie, walidacja, test podstawowy, test specjalistyczny, naprawa | inspection, calibration, validation, basicTest, specialistTest, repair | Otwarty słownik. „Czynność” jako słowo nadrzędne, gdy nie wiemy, która. |
| protokół | serviceReport | Nie „raport”, nie „dokument” w interfejsie. |
| orzeczenie o stanie technicznym | verdict | Wpisuje człowiek. Nigdy „wynik systemu”. |
| reżim terminowy | maintenanceSchedule | W interfejsie można „cykl czynności”, gdy „reżim” brzmi obco dla placówki. |
| termin, następny termin | dueDate | Nie „deadline”. |
| zgłoszenie usterki, zgłoszenie | faultReport | Nie „ticket”, nie „incydent”. |
| pakiet do kontroli | auditPackage | Nie „audyt”: audyt robi kontrola, my dajemy pakiet. |
| paszport techniczny, paszport urządzenia | jw. | Nie „karta techniczna” (to część paszportu), nie „dossier”. |
- Daty:
DD.MM.RRRRw tabelach i kartach, „24 września 2026” w prozie i mailu. - Liczby z jednostką: „12 miesięcy”, „41 dni”, odmienione. Bez skrótów „mies.”, „d.”.
- Wielkie litery: tylko na początku zdania i w nazwach własnych. Nagłówki, przyciski i etykiety kolumn zdaniowo („Następny termin”, nie „Następny Termin”). Kicker jest jedynym miejscem z samymi wielkimi literami.
- Nazwy kolumn krótkie: „Nr fabryczny” jest dopuszczalnym skrótem, bo pełna nazwa nie mieści się w kolumnie.
- Bez myślników jako przerywników w zdaniu; przecinek, dwukropek, kropka. Polskie cudzysłowy „takie”.
Czerwone linie prawne
Cytat
Nasza kwalifikacja nie jest dana raz na zawsze. Możemy ją stracić przez funkcję albo przez zdanie w ofercie.
| # | Czerwona linia | Dlaczego | Ryzyko |
|---|---|---|---|
| 1 | Techniczna integracja blokująca urządzenie (system zdalnie wyłącza aparat po terminie) | To jest wprost „software driving or influencing the use of a device”. Blokada pompy klasy IIb czyni z nas klasę IIb. | Krytyczne. Nigdy. |
| 2 | Marketing obiecujący korzyść kliniczną | Przeznaczenie deklarowane przez producenta decyduje o kwalifikacji. Można wejść pod MDR samym tekstem. | Wysokie. Najtańszy sposób, żeby sobie zaszkodzić. To jest linia, której pilnuje Kanon i strażnik treści. |
| 3 | Moduł wiążący urządzenie z pacjentem (którzy pacjenci byli badani na tym aparacie, rejestr ekspozycji) | Działanie staje się „for the benefit of individual patients”. | Wysokie. Kusząca funkcja, świadomie odkładana. |
| 4 | Automatyczny werdykt o dopuszczeniu do użytku wydawany przez algorytm | Szara strefa. System porównuje pomiar z limitem i pokazuje ostrzeżenie; werdykt wpisuje i podpisuje człowiek. | Średnie. Rozwiązane projektem: pieczęć zawsze z nazwiskiem. |
| 5 | AI przewidujące awarie z rekomendacją „wycofać z użycia” | Łączy 4 z językiem decyzyjnym, otwiera pytanie o AI Act. | Średnie, rośnie z czasem. |
Czego nie wolno napisać
Poniższa lista jest sprawdzana maszynowo przed każdym wdrożeniem Kanonu i strony (scripts/lint-content.mjs). Wzorce i przykłady pochodzą z jednego pliku src/data/jezyk-zakazane.ts, więc strona i strażnik nie mogą się rozjechać. Wzorca nie usuwamy dlatego, że jest uciążliwy.
| Zwrot | Dlaczego nie | Źródło | Wzorzec strażnika |
|---|---|---|---|
| już nigdy nie przegapisz | Obietnica wyniku, którego system nie kontroluje. Termin pilnuje człowiek, system przypomina. | Brandbook s. 14 | ju(ż|z)\s+nigdy\s+nie\s+przegapisz |
| pełna zgodność z przepisami | Obietnica zgodności. Odpowiedzialność za spełnienie obowiązków zostaje po stronie placówki. | Brandbook s. 14 | pe(ł|l)n(a|ą|ej)\s+zgodno(ś|s)(ć|c|ci)\s+z\s+przepisami |
| gwarantuje bezpieczeństwo | Gwarancja bezpieczeństwa to deklaracja przeznaczenia, której produkt nie ma prawa złożyć. | Brandbook s. 14 | gwarantuj\w*\s+bezpiecze(ń|n)stw |
| zagraża pacjentom | Straszenie pacjentem wprowadza pacjenta do produktu, który pacjenta nie dotyczy. | Brandbook s. 14 | zagra(ż|z)a\w*\s+pacjent |
| bezpieczeństwo pacjenta | Obietnica korzyści klinicznej. Przeznaczenie deklarowane przez producenta decyduje o kwalifikacji pod MDR. | compliance-regulacje.md 1.5 | bezpiecze(ń|n)stw\w*\s+pacjent |
| chroni pacjentów | Obietnica korzyści klinicznej. | compliance-regulacje.md 1.5 | chroni\w*\s+pacjent |
| jakość leczenia | Obietnica korzyści klinicznej. | compliance-regulacje.md 1.5 | jako(ś|s)(ć|c)\s+leczenia |
| bezpieczeństwo terapii | Obietnica korzyści klinicznej. | compliance-regulacje.md 1.5 | bezpiecze(ń|n)stw\w*\s+terapii |
| zapewnia zgodność | Obietnica zgodności z przepisami. | compliance-regulacje.md 1.5 | (gwarantuj|zapewnia)\w*\s+zgodno(ś|s)(ć|c) |
| patient safety, protects patients, quality of care, ensures compliance | Te same obietnice po angielsku, na wypadek treści w innych językach. | compliance-regulacje.md 1.5 | patient\s+safety|protects?\s+patients|quality\s+of\s+care|ensures?\s+compliance |
Zdania, które przekroczyłyby czerwoną linię numer 2
- MedPass chroni pacjentów przed powikłaniami.
- System zwiększa bezpieczeństwo terapii.
- Dzięki MedPass poprawia się jakość leczenia.
Każde z nich deklaruje przeznaczenie medyczne. Żadne nie wymaga zmiany w kodzie, żeby zmienić kwalifikację prawną produktu.
Co wolno
- Terminy, dokumentacja, porządek, kontrola, historia, ewidencja, protokół, przypomnienie, pakiet do kontroli.
- „Wspiera utrzymanie zgodności”, „pomaga spełnić obowiązki dokumentacyjne”, „odpowiedzialność zostaje po stronie placówki”. Wsparcie tak, gwarancja nie.
- „Praca, która znika”: mniej telefonów, mniej szukania, mniej przepisywania. To jest obietnica, którą kontrolujemy.
- Pytanie w FAQ strony: „Czy system załatwia za nas zgodność z przepisami?” z odpowiedzią „Nie i nikt uczciwie tego nie obieca.” To jest wzorcowa odpowiedź.
Deklaracja przeznaczenia
Stoi w stopce każdej strony (także tej), w regulaminie, w stopce eksportów PDF i w onboardingu. Brzmienie jest jedno i nie parafrazujemy go:
Cytat
MedPass jest systemem ewidencji i dokumentacji technicznej aparatury medycznej. Nie jest wyrobem medycznym w rozumieniu art. 2 pkt 1 rozporządzenia MDR 2017/745. Nie zastępuje oceny technicznej ani decyzji o dopuszczeniu wyrobu do używania, za które odpowiada uprawniony personel i kierownik podmiotu leczniczego.