Kanon

Czym jest Kanon

Kanon opisuje stan docelowy wyglądu i języka MedPassa. Dokumentem nadrzędnym jest Brandbook MedPass 1.0 z września 2026. Kanon go nie zastępuje: rozwija go tam, gdzie brandbook milczy (komponenty interfejsu, stany, dostępność), i przekłada na coś, czego da się użyć w kodzie.

Nazwa nie jest przypadkowa. Kanon to zbiór reguł uznanych za obowiązujące, czyli dokładnie to, czym jest ten dokument. Jest krótka, czytelna po polsku i po angielsku, i nie koliduje z nazwą żadnego koloru ani komponentu w marce.

Dla kogo

• Dla osoby budującej interfejs aplikacji, także dla agenta AI: tokeny, komponenty, stany, dostępność i to, gdzie aplikacja dziś odbiega od celu.
• Dla osoby piszącej teksty: strona, oferta, mail, komunikat w interfejsie. Ton, tabela „tak piszemy / tego unikamy” i czerwone linie prawne, których nie wolno przekroczyć.
• Dla osoby przygotowującej materiały poza ekranem: etykieta, protokół, pieczątka, prezentacja. Warianty logo, pole ochronne, rozmiary minimalne.
• Dla wspólników: jedno miejsce, w którym widać, jak marka ma wyglądać i brzmieć, oraz co w niej jest cytatem z brandbooka, a co propozycją do zatwierdzenia.

Jak korzystać

1. Zacznij od Marki i Języka marki, zanim napiszesz albo narysujesz cokolwiek. Pół strony, a oszczędza tygodnie.
2. W Fundamentach są wartości: kolory, skala kroju, odstępy, narożniki. Każda liczba na stronie pochodzi z jednego pliku tokenów src/tokens/tokeny.ts, a żywe przykłady są zbudowane z tych samych tokenów. Nie ma wartości przepisanej ręcznie.
3. W Komponentach i Wzorcach każda strona mówi na górze dwie rzeczy: czy rozdział jest gotowy i czy aplikacja jest dziś z nim zgodna.
4. Na każdej stronie oznaczenie „propozycja Kanonu” znaczy: brandbook tego nie definiuje, wartość jest naszym wnioskiem i czeka na zatwierdzenie. Bez tego oznaczenia wartość jest z brandbooka albo z aplikacji, i wtedy jest tak podpisana.

Trzy oznaczenia, które warto znać

Jak zgłaszać zmiany

Kanon żyje w repozytorium medpass-hq/kanon (Astro, build statyczny, Cloudflare Pages). Zmiana w treści to zmiana w pliku w src/data, zmiana wartości to zmiana w src/tokens/tokeny.ts. Każda zmiana idzie gałęzią i PR-em, jak w pozostałych repozytoriach MedPassa. Decyzje, które zmieniają regułę, dostają wpis w DECYZJE.md z datą, powodem i tym, co odrzucono.

Przed publikacją pnpm verify uruchamia sprawdzenie typów, build i strażnika treści. Strażnik szuka zwrotów zakazanych z brandbooka i z czerwonych linii prawnych. Nie wyłączamy go dlatego, że jest uciążliwy.

Wersja

Lista rozbieżności między brandbookiem a aplikacją

Zebrane w jednym miejscu, żeby dało się je zamknąć po kolei. Każda ma szerszy opis na stronie, do której prowadzi.