Zbudowałem to, bo taki most nie miał prawa istnieć — poza USA.

Jeśli mieszkasz w USA albo — w części — UK, Twoje wyniki badań same wpadają do Apple Zdrowie z podpiętej sieci klinik (Epic, Cerner). Cała reszta świata patrzy zza szyby. W Polsce Diagnostyka i ALAB mają własne apki, każda inna, a do Apple Zdrowie nie wysyła nic nikt. To mnie po prostu zjadło.

Skąd to się wzięło

Lubię centralizację danych. Fitness, sen, tętno — wszystko już mam w Zdrowiu, na swoim telefonie, pod swoim biometrycznym zamkiem. Prywatnościowy model Apple to dla mnie jego najmocniejsza strona: dane leżą u Ciebie, nie w chmurze dostawcy urządzenia. Ale kawałka układanki brakowało — wyników badań laboratoryjnych.

Zacząłem czytać, dlaczego nie da się tego samemu wgrać. Znalazłem długą listę formalnych blokad: Apple Health Records to program dla instytucji, wymaga podpięcia do FHIR API, weryfikacji w VCI Directory, i realnie działa dla amerykańskich (i kilku brytyjskich) sieci klinik. Polska Diagnostyka mogłaby teoretycznie dołączyć — ale to ich ruch, nie mój.

Przełom

A potem znalazłem drugi tor: SMART Health Card. Format wymyślony pierwotnie do covidowych certyfikatów szczepień, ale technicznie jest to podpisany JWS z FHIR bundle w środku. Apple Zdrowie ten format przyjmuje z importu pliku przez użytkownika — i, jak się okazało w moim eksperymencie: przyjmuje też typ „laboratory" od dowolnego wystawcy, nie tylko szczepienia z instytucji.

Poczułem się jak dzieciak, który znalazł drzwi. Zbudowałem prototyp. Wygenerowałem trzy karty z trzema datami. Zaimportowałem do Zdrowia na swoim iPhone. Dostałem dyskretne pomiary z wykresem trendu przez 3 lata — zupełnie jak z podpiętej kliniki. Jedyna różnica to szara odznaka „niezweryfikowane" — która przecież mówi prawdę: karta pochodzi z narzędzia konwertującego, nie z laboratorium.

Na czym to stoi

Żadnego autorskiego formatu — pod spodem są trzy otwarte standardy, których Apple Zdrowie i tak używa na co dzień.

HL7^® FHIR^® R4

Międzynarodowy standard wymiany danych medycznych. Każdy wynik zapisujemy jako zasób Observation, a komplet — jako Bundle.

hl7.org/fhir →

SMART Health Cards 1.4.0

Opakowanie i podpis. Pakiet FHIR jest kompresowany i podpisywany kryptograficznie (JWS ES256) — Apple Zdrowie rozpoznaje ten format natywnie.

spec.smarthealth.cards →

LOINC^® + UCUM

Uniwersalne kody badań i jednostek. To dzięki nim „glukoza" z jednego laboratorium i z drugiego trafiają na ten sam wykres trendu.

Słownik LOINC →

Po co to komukolwiek?

Realistycznie: nie liczę, że na tym zarobię. To projekt hobbystyczny, portfolio developerskie i przy okazji może mały pstryk w plecy polskich dostawców. Jeśli Diagnostyka albo ALAB zobaczy, że użytkownicy sami wgrywają swoje wyniki do Apple Zdrowie przez plik, może to ich popchnie do zrobienia tego oficjalnie — z pełną odznaką „Zweryfikowano" i bez pośrednika.

A jeśli nie — będę miał ciekawy projekt, który używam sam, i który może przyda się komuś, kto tak jak ja lubi mieć swoje dane w jednym miejscu.

Zasady, których się trzymam

• Nic nie opuszcza Twojego urządzenia. Dosłownie nie ma serwera, który mógłby przyjąć Twój PDF. To nie „obiecuję, że nie patrzymy" — to architektura, w której nie ma jak patrzeć.
• Przepisuję, nie interpretuję. LabKarta konwertuje format. Nie oznacza, czy wynik jest „dobry" ani nie sugeruje diagnoz. To granica prawna wyrobu medycznego i granica moja.
• Uczciwie o statusie karty. Karta jest niezweryfikowana, wystawiona przez narzędzie, nie przez laboratorium. Apple Zdrowie to pokazuje szarą odznaką i to jest OK — takie właśnie są fakty.
• Ryzyko stabilności. Jestem poza oficjalnie wspieranym scenariuszem Apple. Działa dzisiaj, może przestać jutro. Wtedy to zaktualizuję — albo nie, jak to hobby.

Co dalej

Roadmapa jest raczej mapą niż deklaracją: uniwersalny OCR (ALAB, Synevo), pełny słownik LOINC z oficjalnym polskim tłumaczeniem UMED, edytowalna tabela podglądu, integracja SSIDL gdy będzie gotowa. Wszystko po weekendach, więc bez terminów.