[NRL-1279] Add sample pointer unit tests and initial sample from Orion

Author: mattdean3-nhs

layer/nrlf/core/tests/test_sample_pointers.py

@@ -0,0 +1,35 @@
+import os
+
+import pytest
+
+from nrlf.consumer.fhir.r4.model import DocumentReference as ConsumerDocumentReference
+from nrlf.core.validators import DocumentReferenceValidator
+from nrlf.producer.fhir.r4.model import DocumentReference as ProducerDocumentReference
+
+
+@pytest.fixture
+def sample_pointer_data() -> str:
+    json_files = [f for f in os.listdir("./tests/data/samples") if f.endswith(".json")]
+
+    for file in json_files:
+        with open(f"./tests/data/samples/{file}", "r") as f:
+            pointer_data = f.read()
+            yield pointer_data
+
+
+def test_sample_pointer_as_consumer(sample_pointer_data: str):
+    docref = ConsumerDocumentReference.model_validate_json(sample_pointer_data)
+
+    validator = DocumentReferenceValidator()
+    result = validator.validate(data=docref)
+
+    assert result.is_valid
+
+
+def test_sample_pointer_as_producer(sample_pointer_data: str):
+    docref = ProducerDocumentReference.model_validate_json(sample_pointer_data)
+
+    validator = DocumentReferenceValidator()
+    result = validator.validate(data=docref)
+
+    assert result.is_valid

tests/data/samples/README.md

@@ -0,0 +1,11 @@
+# Supplier sample data
+
+This directory contains sample pointer data from our suppliers. Samples have
+been sourced directly from suppliers or anonymised from live data.
+
+To add a new sample to this folder, follow these steps:
+
+- Remove any real PII from the DocumentReference data (NHS numbers, URLs, ids etc)
+- Add the DocumentReference data to a .json file with a name describing the
+  supplier and the pointer type, something like <ODSCode>_<PointerType>_<other-unique-info>.json
+- Run the tests to verify that the pointer works with our model and validators

tests/data/samples/YGM91_MentalHealthCrisisPlan_Orion_Feb2025.json

@@ -0,0 +1,97 @@
+{
+  "resourceType": "DocumentReference",
+  "id": "YGM91-b5a1aef1-a3ee-4c38-be31-e98968fe7ae9",
+  "masterIdentifier": {
+    "system": "urn:ietf:rfc:3986",
+    "value": "b5a1aef1-a3ee-4c38-be31-e98968fe7ae9"
+  },
+  "status": "current",
+  "type": {
+    "coding": [
+      {
+        "system": "http://snomed.info/sct",
+        "code": "736253002",
+        "display": "Mental health crisis plan"
+      }
+    ]
+  },
+  "category": [
+    {
+      "coding": [
+        {
+          "system": "http://snomed.info/sct",
+          "code": "734163000",
+          "display": "Care plan"
+        }
+      ]
+    }
+  ],
+  "subject": {
+    "identifier": {
+      "system": "https://fhir.nhs.uk/Id/nhs-number",
+      "value": "9658218873"
+    }
+  },
+  "author": [
+    {
+      "identifier": {
+        "system": "https://fhir.nhs.uk/Id/ods-organization-code",
+        "value": "YGM91"
+      }
+    }
+  ],
+  "custodian": {
+    "identifier": {
+      "system": "https://fhir.nhs.uk/Id/ods-organization-code",
+      "value": "YGM91"
+    }
+  },
+  "content": [
+    {
+      "extension": [
+        {
+          "url": "https://fhir.nhs.uk/England/StructureDefinition/Extension-England-ContentStability",
+          "valueCodeableConcept": {
+            "coding": [
+              {
+                "system": "https://fhir.nhs.uk/England/CodeSystem/England-NRLContentStability",
+                "code": "dynamic",
+                "display": "Dynamic"
+              }
+            ]
+          }
+        }
+      ],
+      "attachment": {
+        "contentType": "application/pdf",
+        "language": "en",
+        "url": "ssp://endpoint.nrlproducer.thirdparty.nhs.uk/nrl/content",
+        "title": "Treatment Escalation Plan"
+      },
+      "format": {
+        "system": "https://fhir.nhs.uk/England/CodeSystem/England-NRLFormatCode",
+        "code": "urn:nhs-ic:unstructured",
+        "display": "Unstructured Document"
+      }
+    }
+  ],
+  "context": {
+    "practiceSetting": {
+      "coding": [
+        {
+          "system": "http://snomed.info/sct",
+          "code": "92221000000103",
+          "display": "Mental health home treatment team"
+        }
+      ]
+    },
+    "related": [
+      {
+        "identifier": {
+          "system": "https://fhir.nhs.uk/Id/nhsSpineASID",
+          "value": "012345678910"
+        }
+      }
+    ]
+  }
+}