Skip to main content

Golden records

A golden record is the single canonical FHIR Patient resource for one real-world person, regardless of how many local MRNs they have across connected facilities.

Structure​

{
  "resourceType": "Patient",
  "id": "GOLDEN-00441",
  "meta": {
    "tag": [{"system": "http://jammpi.io/tags", "code": "golden-record"}]
  },
  "link": [
    {"type": "seealso", "other": {"reference": "Patient/MRN12345"}},
    {"type": "seealso", "other": {"reference": "Patient/PRIV-9901"}},
    {"type": "seealso", "other": {"reference": "Patient/H-20891"}}
  ],
  "extension": [
    {"url": "http://jammpi.io/ext/seen-at", "valueString": "BR01,BR03,BR07"},
    {"url": "http://jammpi.io/ext/confidence", "valueDecimal": 0.97}
  ]
}

How JamBridge uses the golden record​

When JamBridge processes a message and JamMPI returns a golden record ID, it stamps the ID on every FHIR resource written:

{
  "resourceType": "Patient",
  "id": "MRN12345",
  "link": [{"type": "refer", "other": {"reference": "Patient/GOLDEN-00441"}}],
  "extension": [{"url": "http://jammpi.io/ext/golden-record-id", "valueString": "GOLDEN-00441"}]
}

Any system that queries HAPI FHIR for Patient/GOLDEN-00441 gets the complete cross-branch record.

Manual merge and unmerge​

JamMPI provides an admin API for reviewing POSSIBLE-grade matches:

GET /api/merge-candidates?grade=possible
POST /api/merge   {"keep": "GOLDEN-00441", "merge": "GOLDEN-00998"}
POST /api/unmerge {"golden": "GOLDEN-00441", "remove": "Patient/MRN12345"}

All merge and unmerge decisions are written to the audit log.