Pentru dezvoltatori

Platformă de consimțământ al pacientului: cum funcționează consimțământul, domeniile, expirarea și revocarea într-un API de date de sănătate

Ce trebuie să facă o platformă care ajută la consimțământul pacientului: consimțământul ca obiect de prim rang cu domenii și expirare, revocare care intră în vigoare imediat, un jurnal de acces pe care pacientul îl poate citi și AI scrie dețineri pentru aprobare. Cum implementează Anpheros acest lucru.

de Publicat 4 min de citit

Consimțământul este partea unui produs de sănătate pe care nimeni nu vrea să o construiască și pe care toată lumea este auditată. „Utilizatorul a bifat o căsuță la înregistrare” nu satisface Articolul 9 din GDPR, nu supraviețuiește unei revizuiri a protecției datelor și nu permite unei persoane să retragă accesul dintr-o aplicație fără a-și șterge contul. Acest ghid descrie ce trebuie să facă o platformă de consimțământ al pacientului și cum o face Anpheros Platform, astfel încât să o puteți reutiliza în loc să o reconstruiți.

Versiune tehnică pentru dezvoltatori: Platformă de consimțământ al pacientului · Consimțământ pe developers.anpheros.com, cu cereri, răspunsuri și limite. Această pagină este versiunea în limbaj simplu.

Consimțământul ca obiect, nu ca flag

În Anpheros, un consimțământ este o acordare: o persoană, o aplicație, un set de scopuri, un scop, o expirare. Este creat atunci când persoana aprobă accesul pe pagina de consimțământ, este listat acolo unde persoana îl poate vedea și poate fi revocat în orice moment. Citirile sunt verificate în raport cu acesta la fiecare cerere.

  • Scopurile spun ce poate citi sau scrie aplicația: observații, condiții, medicamente, alergii, documente și așa mai departe, opțional restrânse pe categorii (de exemplu, rezultate de laborator, dar nu simptome).
  • Durata este aleasă de persoană: 30, 90, 180 sau 365 de zile. Nu există „pentru totdeauna”.
  • Revocarea intră în vigoare la următoarea cerere. Aplicația primește un webhook consent.revoked.
  • Scopul este înregistrat cu acordarea și afișat persoanei.

Cum solicită o aplicație

Prin OAuth 2.1 cu PKCE, cu SMART pe FHIR lansare independentă pentru aplicațiile care vorbesc deja SMART. Persoana se conectează, vede ce aplicație solicită, ce scopuri și pentru cât timp, și aprobă sau declină. Aplicația primește un token limitat la acel pacient și acele scopuri; o cheie de proiect nu înlocuiește niciodată consimțământul unei persoane.

GET  https://platform.anpheros.com/oauth/authorize?client_id=…&scope=patient/Observation.read …
POST https://platform.anpheros.com/oauth/token

Tokenurile de acces durează 30 de minute, tokenurile de reîmprospătare 30 de zile. Documentele de descoperire se găsesc la /.well-known/oauth-authorization-server și /.well-known/smart-configuration.

Ce vede pacientul

GET /me/patients/{id}/grants listează fiecare aplicație cu acces, scopurile și expirarea sa. …/grants/{grant}/access-log listează ce a citit sau scris fiecare, sub consimțământ și cu cheia proprie a proiectului. Cu format=fhir, jurnalul revine ca un Bundle de resurse FHIR R4 AuditEvent modelate după IHE Basic Audit Log Patterns. În Anpheros Daily, aceasta este ecranul „Conexiuni”; aplicația dvs. proprie poate afișa același lucru.

Citiri versus scrieri

Cu consimțământ, o organizație vede întregul dosar, inclusiv ce au scris alte clinici, dar poate modifica sau șterge doar ceea ce a scris ea însăși. Fiecare versiune a fiecărei resurse înregistrează proiectul care a scris-o; o scriere de către un alt proiect este refuzată cu o explicație. Fiecare scriere produce o resursă Provenance care numește aplicația, organizația în numele căreia a acționat și persoana.

Agenții AI propun, persoana decide

O scriere efectuată sub consimțământul unei persoane de către o aplicație înregistrată ca agent AI nu este aplicată imediat. Platforma o validează și răspunde cu 202 Accepted cu un ID de propunere; nimic nu se schimbă în dosar. Persoana vede propunerea, ce este și ce aplicație a trimis-o, și o acceptă sau o respinge. O propunere acceptată este scrisă exact așa cum a fost trimisă și marcată ca fiind scrisă de AI. Acesta este modul în care un asistent conectat prin MCP poate ajuta la completarea unui dosar fără a scrie niciodată în el nesupravegheat.

O persoană își poate partaja dosarul și prin QR sau link. POST /me/patients/{id}/shl creează un SMART Health Link pentru submulțimea de urgență (alergii, medicamente, probleme, imunizări) sau pentru International Patient Summary complet, cu o parolă opțională și expirare. Fiecare deschidere este în jurnalul de acces, iar linkul poate fi dezactivat imediat. Orice cititor SMART Health Link îl poate deschide.

Modelul complet, cu fiecare regulă, se găsește la developers.anpheros.com/guides/consent-model.

Întrebări frecvente

Acordarea este obiectul operațional verificat la fiecare cerere; dosarul transportă, de asemenea, resurse FHIR Consent și Provenance, astfel încât alte sisteme să poată citi ce a fost convenit și cine a scris ce. Jurnalul de acces este disponibil ca FHIR AuditEvent.

Poate un pacient să acorde acces doar la o parte din dosar?

Da. Scopurile sunt pe tip de resursă, cu filtre de categorie, iar persoana le alege pe pagina de consimțământ. O aplicație poate solicita doar rezultate de laborator sau doar medicamente.

Ce se întâmplă când expiră consimțământul?

Cerile sub acea acordare returnează 403 de la data expirării încolo. Aplicația poate solicita din nou; persoana decide din nou. Nimic nu este șters.

Revocarea șterge ceea ce aplicația a citit deja?

Niciun sistem nu poate „de-citi” date. Revocarea oprește imediat accesul ulterior și este înregistrată; ceea ce aplicația a stocat pe partea sa este guvernat de propriile obligații conform GDPR.

Poate o clinică să acceseze un dosar fără consimțământul pacientului?

Un proiect vede pacienții pe care i-a creat singur. Citirea unui dosar creat în altă parte necesită acordarea persoanei. Nu există nicio suprascriere administrativă.

Acest ghid este informativ și nu înlocuiește consultul medical. Pentru decizii despre sănătatea ta, vorbește cu medicul tău. În urgență, sună la 112.
Despre autor
Adrian Kereky

Fondatorul Anpheros. Inginer electronist, a lucrat șase ani în conducere autonomă, pe proiecte din industria auto în parteneriat cu Samsung și NVIDIA, la arhitectura sistemelor de asistență la condus și a sistemelor AI care rulează pe cipuri NVIDIA cu CUDA. Apoi a construit Anpheros: dosarul medical controlat de pacient și platforma HL7 FHIR R4 pe care rulează.

Mai mult despre Anpheros și autor →

Ține-ți dosarul medical la tine

Anpheros Daily păstrează simptomele, analizele, medicamentele și documentele într-un singur loc, în format standard, sub controlul tău. Planul Basic e gratuit.

Descarcă Anpheros Daily