Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Επεξήγηση προέλευσης ιατρικών δεδομένων

Τι καταγράφει η προέλευση σε κάθε εγγραφή σε ένα αρχείο FHIR R4 — τύπος συγγραφέα, άτομο, οργανισμός, σύστημα πηγής, εκδόσεις — πώς να τη ρυθμίσετε με κεφαλίδες, πώς να τη διαβάσετε, και πώς επισημαίνει δεδομένα που δίνονται σε μοντέλα ΤΝ.

Η προέλευση είναι η καταγραφή από πού προήλθε ένα κομμάτι ιατρικών δεδομένων: ποιος το έγραψε, για λογαριασμό ποιου οργανισμού, από ποιο σύστημα, πότε και τι άλλαξε σε κάθε έκδοση. Σε ένα αρχείο που συλλέγει δεδομένα από ασθενείς, συσκευές, κλινικές, εργαστήρια και AI, η προέλευση είναι αυτό που καθιστά μια τιμή αξιόπιστη: μια μέτρηση αρτηριακής πίεσης που πληκτρολογήθηκε στο σπίτι και μία που μετρήθηκε σε μια κλινική φαίνονται πανομοιότυπες χωρίς αυτήν. Στο Anpheros, κάθε εγγραφή σε ένα αρχείο HL7 FHIR R4 παράγει αυτόματα έναν πόρο FHIR Provenance. Αυτή η σελίδα εξηγεί τι περιέχει, πώς να τη συμπληρώσετε σωστά και πώς να τη διαβάσετε.

Γιατί η προέλευση (provenance) έχει σημασία

Κλινική εμπιστοσύνη. Ένας γιατρός αξιολογεί ένα εργαστηριακό αποτέλεσμα διαφορετικά από μια τιμή που εισήγαγε ο ασθενής ή έναν αριθμό που εξήγαγε μια τεχνητή νοημοσύνη από μια φωτογραφία.
Ασφάλεια Τεχνητής Νοημοσύνης. Ένα μοντέλο που λαμβάνει ένα αρχείο πρέπει να γνωρίζει ποια στοιχεία είναι γεγονότα και ποια είναι σημειώσεις που έγραψε ένα άλλο μοντέλο. Χωρίς ετικέτες, τα αντιμετωπίζει όλα ίδια.
Διορθώσεις και διαφωνίες. Όταν μια τιμή αλλάζει, όλοι πρέπει να γνωρίζουν ποια ήταν πριν, ποιος την άλλαξε και γιατί.
Λογοδοσία. Σύμφωνα με τον GDPR και τον Ευρωπαϊκό Χώρο Δεδομένων Υγείας, ένας οργανισμός πρέπει να μπορεί να αποδείξει τι έκανε με τα δεδομένα υγείας ενός ατόμου.
Κοινή χρήση. Όταν ένας ασθενής επιτρέπει σε μια δεύτερη κλινική να διαβάσει το αρχείο του, η κλινική αυτή πρέπει να γνωρίζει ποια δεδομένα έγραψε η πρώτη κλινική.

Τι καταγράφει το Anpheros σε κάθε εγγραφή

Ερώτηση	Πού καταγράφεται	Πώς το ορίζετε
Τι είδους συντάκτης;	`agent.who.identifier` (τύπος συντάκτη)	`author_type` στο `/v1`, ή κεφαλίδα `X-Anpheros-Author-Type`: `patient`, `practitioner`, `device`, `import`, `ai`
Ποιο άτομο;	`agent.who.reference`	`X-Anpheros-Author-Ref: Practitioner/<id>`, ή `X-Anpheros-Acting-As`
Για ποιον οργανισμό;	`agent.onBehalfOf`	ο οργανισμός του `PractitionerRole`, ή `X-Anpheros-On-Behalf-Of: Organization/<id>`
Από ποιο σύστημα;	`entity` με ρόλο `source`	`X-Anpheros-Source-System: <name>`
Ποια εγγραφή σε αυτό το σύστημα;	origin id	`X-Anpheros-Origin-Id: <id>`
Πότε, και τι συνέβη;	`recorded`, `activity` (CREATE, UPDATE, DELETE)	αυτόματα
Ποια έκδοση;	`target` δείχνει στο `<Resource>/<id>/_history/<version>`	αυτόματα

Αν δεν δηλώσετε ποιος είναι ο συντάκτης, η πλατφόρμα καταγράφει import. Δεν υποθέτει ποτέ patient, επειδή μια τιμή που αποδίδεται λανθασμένα στον ασθενή είναι χειρότερη από μια που επισημαίνεται ειλικρινά ως εισαγόμενη.

Εγγραφή με πλήρη προέλευση

Ένας καρδιολόγος σε μια κλινική καταγράφει τον καρδιακό ρυθμό κατά τη διάρκεια μιας επίσκεψης, μέσω του λογισμικού της κλινικής:

curl -X POST https://platform.anpheros.com/fhir/R4/Observation -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/fhir+json" \
     -H "X-Anpheros-Author-Type: practitioner" \
     -H "X-Anpheros-Acting-As: PractitionerRole/$ROLE" \
     -H "X-Anpheros-Source-System: ccn-emr" \
     -d '{ "resourceType": "Observation", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "8867-4"}]}, … }'

Η Προέλευση (Provenance) που γράφει η πλατφόρμα:

{"resourceType": "Provenance",
 "target": [{"reference": "Observation/8660eb7c-…/_history/1"}],
 "recorded": "2026-10-12T20:41:47.469000Z",
 "activity": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-DataOperation", "code": "CREATE"}]},
 "agent": [{"type": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type", "code": "author"}]},
            "who": {"reference": "PractitionerRole/e6d8c227-…",
                    "identifier": {"system": "https://anpheros.com/fhir/CodeSystem/author-type", "value": "practitioner"}},
            "onBehalfOf": {"reference": "Organization/c3a56a4b-…", "display": "Clinica Cardio Nord"}}],
 "entity": [{"role": "source", "what": {"identifier": {"system": "ccn-emr"}}}]}

Ο ρόλος του γιατρού, η κλινική του, το είδος του συντάκτη και το σύστημα πηγής βρίσκονται όλα εκεί, σε τυπικό FHIR. Το PractitionerRole πρέπει να υπάρχει στον κατάλογο του έργου σας και να είναι ενεργό. Ένα αίτημα που ονομάζει τον επαγγελματία υγείας κάποιου άλλου απορρίπτεται:

{"resourceType": "OperationOutcome", "issue": [{"severity": "error", "code": "invalid",
  "diagnostics": "Unknown or inactive Practitioner in X-Anpheros-Acting-As."}]}

Η ρύθμιση του καταλόγου καλύπτεται στο Πώς να ενσωματώσετε συστήματα κλινικών με ένα FHIR backend.

Εκδόσεις: τίποτα δεν αντικαθίσταται σιωπηλά

Κάθε ενημέρωση δημιουργεί μια νέα έκδοση του πόρου και ένα νέο Provenance για αυτήν. Μετά τη διόρθωση του καρδιακού ρυθμού από 92 σε 88:

curl https://platform.anpheros.com/fhir/R4/Observation/$OBS/_history -H "Authorization: Bearer $KEY"

επιστρέφει την έκδοση 2 (88) και την έκδοση 1 (92). Η προβολή REST συνοψίζει το Provenance κάθε έκδοσης:

curl https://platform.anpheros.com/v1/patients/$PID/provenance/Observation/$OBS -H "Authorization: Bearer $KEY"

{"data": [
  {"version": 1, "activity": "CREATE", "recorded": "2026-10-12T20:41:47.469000Z", "author_type": "practitioner", "author": "PractitionerRole/e6d8c227-…", "source_system": "ccn-emr", "fhir": "Provenance/6ed91529-…"},
  {"version": 2, "activity": "UPDATE", "recorded": "2026-10-12T20:41:47.500000Z", "author_type": "practitioner", "fhir": "Provenance/3fbf270f-…"}],
 "total": 2}

Οι διαγραφές είναι "μαλακές": ένας διαγραμμένος πόρος εξαφανίζεται από τις αναζητήσεις, αλλά το ιστορικό και το Provenance του παραμένουν.

Ανάγνωση προέλευσης

# who wrote this resource (all versions)
GET /fhir/R4/Provenance?target=Observation/{id}
# everything a practitioner recorded
GET /fhir/R4/Provenance?agent=PractitionerRole/{id}
# the same, summarised, per resource
GET /v1/patients/{pid}/provenance/Observation/{id}

Προέλευση σε περιβάλλοντα Τεχνητής Νοημοσύνης

Το API περιβάλλοντος μεταφέρει την προέλευση σε κάθε στοιχείο που παρέχει σε ένα μοντέλο, ως author_type και source. Σε μορφή κειμένου:

- Type 2 diabetes mellitus (E11), active, onset 2024-10-15 [import/anpheros-sandbox]
- Metformin 1000 mg 1 tablet twice daily with meals, active [patient/anpheros-sandbox]
- Glucose [Mass/volume] in Blood: 2026-09-16: 140.0 mg/dL [device/anpheros-sandbox]

Οι μετρήσεις που γράφονται με author_type: ai δεν εμφανίζονται ποτέ μεταξύ αυτών των γεγονότων. Αναφέρονται ξεχωριστά στην ενότητα ai_notes και επισημαίνονται ως μη επαληθευμένες, ώστε ένα μοντέλο να μην μπορεί να συγχέει την εικασία ενός προηγούμενου μοντέλου με μια μέτρηση. Πείτε στο μοντέλο τι σημαίνουν οι ετικέτες και ζητήστε του να τις αναφέρει. Ο οδηγός Πώς να δημιουργήσετε μια εφαρμογή Τεχνητής Νοημοσύνης για την υγεία με backend FHIR δείχνει μια προτροπή που το κάνει.

Τι βλέπει ο ασθενής

Η προέλευση (Provenance) είναι επίσης αυτό που βλέπει ο ασθενής. Το αρχείο του δείχνει ποιος πρόσθεσε κάθε στοιχείο, και η λίστα των συνδέσεών του δείχνει, για κάθε εφαρμογή, ποιος απέκτησε πρόσβαση σε τι, με το όνομα όταν ένας επαγγελματίας υγείας ενεργούσε ("Δρ. Άννα Παπαδοπούλου · Κλινική Καρδιο Νορντ διάβασε τα εργαστηριακά σας αποτελέσματα"). Δείτε Μοντέλο συναίνεσης και πρόσβασης.

Κανόνες που καθιστούν χρήσιμη την προέλευση

Να ορίζετε πάντα τον τύπο του συντάκτη. Κοστίζει ένα πεδίο και είναι η πιο σημαντική ετικέτα στην εγγραφή.
Να ονομάζετε το πρόσωπο όταν ένα πρόσωπο το έγραψε. Χρησιμοποιήστε το X-Anpheros-Acting-As για το κλινικό προσωπικό.
Να ονομάζετε το σύστημα προέλευσης, και να περνάτε το δικό του αναγνωριστικό ως αναγνωριστικό προέλευσης όταν υπάρχει.
Διορθώστε με ενημέρωση, ποτέ με διαγραφή και επανεισαγωγή. Μια ενημέρωση διατηρεί τον σύνδεσμο μεταξύ της παλιάς και της νέας τιμής.
Να επισημαίνετε την έξοδο AI ως ai, συμπεριλαμβανομένων των τιμών που ένα μοντέλο εξήγαγε από ένα έγγραφο. Οι τιμές που προέρχονται από ένα έγγραφο μπορούν επίσης να παραπέμπουν σε αυτό με το derived_from.

Συχνές ερωτήσεις

Τι είναι η προέλευση δεδομένων στην υγειονομική περίθαλψη;

Η τεκμηριωμένη προέλευση και το ιστορικό ενός δεδομένου υγείας: ποιος το δημιούργησε ή το άλλαξε, για λογαριασμό ποιου, από ποιο σύστημα και πότε. Στο HL7 FHIR αναπαρίσταται από τον πόρο Provenance, ο οποίος δείχνει στην ακριβή έκδοση του πόρου που περιγράφει.

Είναι η προέλευση ίδια με ένα αρχείο καταγραφής ελέγχου (audit log);

Όχι. Η προέλευση περιγράφει τα δεδομένα: ποιος έγραψε κάθε έκδοση. Ένα αρχείο καταγραφής ελέγχου περιγράφει την πρόσβαση: ποιος διάβασε ή έγραψε τι, πότε, με ποια συγκατάθεση. Το Anpheros διατηρεί και τα δύο. Ο ασθενής βλέπει το αρχείο καταγραφής πρόσβασης για κάθε εφαρμογή που είναι συνδεδεμένη στο αρχείο του.

Μπορώ να γράψω τους δικούς μου πόρους Προέλευσης (Provenance);

Το Anpheros γράφει έναν για κάθε δημιουργία, ενημέρωση και διαγραφή, οπότε κανονικά δεν χρειάζεται. Χρησιμοποιήστε τις παραπάνω κεφαλίδες για να το κάνετε ακριβές. Μια Προέλευση που παρέχεται από τον πελάτη πρέπει να στοχεύει πόρους ενός μόνο ασθενούς.

Σχετικά

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card