{
  "resourceType": "StructureDefinition",
  "id": "saudi-observation",
  "url": "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation",
  "version": "1.0.0",
  "name": "SaudiObservation",
  "title": "Saudi Clinical Observation Profile",
  "status": "active",
  "date": "2025-07-07",
  "publisher": "Saudi Health Council",
  "contact": [
    {
      "name": "Saudi Health Council",
      "telecom": [
        {
          "system": "url",
          "value": "https://www.shc.gov.sa"
        }
      ]
    }
  ],
  "description": "Saudi Clinical Observation Profile provides standardized clinical observation documentation aligned with Saudi clinical practices and cultural considerations. This profile supports comprehensive clinical data capture including vital signs, laboratory results, diagnostic findings, and clinical assessments with appropriate cultural context and NHIC terminology compliance.",
  "jurisdiction": [
    {
      "coding": [
        {
          "code": "SA",
          "system": "urn:iso:std:iso:3166",
          "display": "Saudi Arabia"
        }
      ]
    }
  ],
  "purpose": "To standardize clinical observation documentation across Saudi healthcare facilities while accommodating cultural considerations and Saudi clinical practices.",
  "copyright": "Copyright © 2025 Saudi Health Council",
  "fhirVersion": "4.0.1",
  "mapping": [
    {
      "identity": "shdd",
      "uri": "http://shc.gov.sa/shdd",
      "name": "Saudi Health Data Dictionary v2"
    }
  ],
  "kind": "resource",
  "abstract": false,
  "type": "Observation",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Observation",
  "derivation": "constraint",
  "differential": {
    "element": [
      {
        "id": "Observation.extension",
        "path": "Observation.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "ordered": false,
          "rules": "open"
        }
      },
      {
        "id": "Observation.extension:measurementContext",
        "path": "Observation.extension",
        "sliceName": "measurementContext",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation-measurement-context"
            ]
          }
        ]
      },
      {
        "id": "Observation.extension:culturalContext",
        "path": "Observation.extension",
        "sliceName": "culturalContext",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation-cultural-context"
            ]
          }
        ]
      },
      {
        "id": "Observation.extension:religiousConsiderations",
        "path": "Observation.extension",
        "sliceName": "religiousConsiderations",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation-religious-considerations"
            ]
          }
        ]
      },
      {
        "id": "Observation.extension:environmentalFactors",
        "path": "Observation.extension",
        "sliceName": "environmentalFactors",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Extension",
            "profile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation-environmental-factors"
            ]
          }
        ]
      },
      {
        "id": "Observation.identifier",
        "path": "Observation.identifier",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS001 - Observation Identifier"
          }
        ]
      },
      {
        "id": "Observation.basedOn",
        "path": "Observation.basedOn",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS002 - Observation Order Reference"
          }
        ]
      },
      {
        "id": "Observation.partOf",
        "path": "Observation.partOf",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS003 - Parent Observation Reference"
          }
        ]
      },
      {
        "id": "Observation.status",
        "path": "Observation.status",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS004 - Observation Status"
          }
        ]
      },
      {
        "id": "Observation.category",
        "path": "Observation.category",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "coding.code"
            }
          ],
          "rules": "open",
          "description": "Slice based on observation category"
        },
        "min": 1,
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS005 - Observation Category"
          }
        ]
      },
      {
        "id": "Observation.category:vitalSigns",
        "path": "Observation.category",
        "sliceName": "vitalSigns",
        "short": "Vital signs category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:vitalSigns.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:vitalSigns.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "vital-signs"
      },
      {
        "id": "Observation.category:laboratory",
        "path": "Observation.category",
        "sliceName": "laboratory",
        "short": "Laboratory category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:laboratory.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:laboratory.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "laboratory"
      },
      {
        "id": "Observation.category:imaging",
        "path": "Observation.category",
        "sliceName": "imaging",
        "short": "Imaging category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:imaging.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:imaging.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "imaging"
      },
      {
        "id": "Observation.category:procedure",
        "path": "Observation.category",
        "sliceName": "procedure",
        "short": "Procedure category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:procedure.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:procedure.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "procedure"
      },
      {
        "id": "Observation.category:survey",
        "path": "Observation.category",
        "sliceName": "survey",
        "short": "Survey category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:survey.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:survey.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "survey"
      },
      {
        "id": "Observation.category:exam",
        "path": "Observation.category",
        "sliceName": "exam",
        "short": "Exam category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:exam.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:exam.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "exam"
      },
      {
        "id": "Observation.category:therapy",
        "path": "Observation.category",
        "sliceName": "therapy",
        "short": "Therapy category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:therapy.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:therapy.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "therapy"
      },
      {
        "id": "Observation.category:activity",
        "path": "Observation.category",
        "sliceName": "activity",
        "short": "Activity category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:activity.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:activity.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "activity"
      },
      {
        "id": "Observation.category:social-history",
        "path": "Observation.category",
        "sliceName": "social-history",
        "short": "Social history category",
        "min": 0,
        "max": "1"
      },
      {
        "id": "Observation.category:social-history.coding.system",
        "path": "Observation.category.coding.system",
        "patternUri": "http://terminology.hl7.org/CodeSystem/observation-category"
      },
      {
        "id": "Observation.category:social-history.coding.code",
        "path": "Observation.category.coding.code",
        "min": 1,
        "patternCode": "social-history"
      },
      {
        "id": "Observation.code",
        "path": "Observation.code",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationCode"
            }
          ],
          "strength": "extensible",
          "description": "LOINC codes with SNOMED CT extensions for Saudi clinical observations",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-observation-codes"
        },
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS010 - Observation Code (LOINC/SNOMED CT)"
          }
        ]
      },
      {
        "id": "Observation.subject",
        "path": "Observation.subject",
        "min": 1,
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-patient",
              "http://hl7.org/fhir/StructureDefinition/Group",
              "http://hl7.org/fhir/StructureDefinition/Device",
              "http://hl7.org/fhir/StructureDefinition/Location"
            ]
          }
        ],
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS020 - Observation Subject"
          }
        ]
      },
      {
        "id": "Observation.focus",
        "path": "Observation.focus",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS021 - Observation Focus"
          }
        ]
      },
      {
        "id": "Observation.encounter",
        "path": "Observation.encounter",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-encounter"
            ]
          }
        ],
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS022 - Associated Encounter"
          }
        ]
      },
      {
        "id": "Observation.effective[x]",
        "path": "Observation.effective[x]",
        "min": 1,
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS030 - Observation Date/Time"
          }
        ]
      },
      {
        "id": "Observation.issued",
        "path": "Observation.issued",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS031 - Observation Issued Date/Time"
          }
        ]
      },
      {
        "id": "Observation.performer",
        "path": "Observation.performer",
        "slicing": {
          "discriminator": [
            {
              "type": "type",
              "path": "resolve()"
            }
          ],
          "rules": "open",
          "description": "Slice based on performer type"
        },
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS040 - Observation Performer"
          }
        ]
      },
      {
        "id": "Observation.performer:practitioner",
        "path": "Observation.performer",
        "sliceName": "practitioner",
        "short": "Healthcare practitioner who performed the observation",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/StructureDefinition/Practitioner"
            ]
          }
        ]
      },
      {
        "id": "Observation.performer:organization",
        "path": "Observation.performer",
        "sliceName": "organization",
        "short": "Healthcare organization responsible for the observation",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/StructureDefinition/Organization"
            ]
          }
        ]
      },
      {
        "id": "Observation.performer:patient",
        "path": "Observation.performer",
        "sliceName": "patient",
        "short": "Patient who performed self-observation",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-patient"
            ]
          }
        ]
      },
      {
        "id": "Observation.performer:relatedPerson",
        "path": "Observation.performer",
        "sliceName": "relatedPerson",
        "short": "Related person who performed the observation",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/StructureDefinition/RelatedPerson"
            ]
          }
        ]
      },
      {
        "id": "Observation.value[x]",
        "path": "Observation.value[x]",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS050 - Observation Value"
          }
        ]
      },
      {
        "id": "Observation.dataAbsentReason",
        "path": "Observation.dataAbsentReason",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS051 - Data Absent Reason"
          }
        ]
      },
      {
        "id": "Observation.interpretation",
        "path": "Observation.interpretation",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationInterpretation"
            }
          ],
          "strength": "extensible",
          "description": "Saudi-specific observation interpretation codes",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-observation-interpretation"
        },
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS060 - Observation Interpretation"
          }
        ]
      },
      {
        "id": "Observation.note",
        "path": "Observation.note",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS070 - Observation Notes"
          }
        ]
      },
      {
        "id": "Observation.bodySite",
        "path": "Observation.bodySite",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "BodySite"
            }
          ],
          "strength": "extensible",
          "description": "SNOMED CT body site codes with Arabic translations",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-body-site"
        },
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS080 - Body Site"
          }
        ]
      },
      {
        "id": "Observation.method",
        "path": "Observation.method",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationMethod"
            }
          ],
          "strength": "extensible",
          "description": "SNOMED CT observation method codes with Arabic translations",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-observation-method"
        },
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS090 - Observation Method"
          }
        ]
      },
      {
        "id": "Observation.specimen",
        "path": "Observation.specimen",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS100 - Specimen Reference"
          }
        ]
      },
      {
        "id": "Observation.device",
        "path": "Observation.device",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS110 - Device Reference"
          }
        ]
      },
      {
        "id": "Observation.referenceRange",
        "path": "Observation.referenceRange",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS120 - Reference Range"
          }
        ]
      },
      {
        "id": "Observation.referenceRange.low",
        "path": "Observation.referenceRange.low",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS121 - Reference Range Low"
          }
        ]
      },
      {
        "id": "Observation.referenceRange.high",
        "path": "Observation.referenceRange.high",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS122 - Reference Range High"
          }
        ]
      },
      {
        "id": "Observation.referenceRange.type",
        "path": "Observation.referenceRange.type",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationRangeMeaning"
            }
          ],
          "strength": "extensible",
          "description": "Saudi-specific reference range types",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-reference-range-type"
        }
      },
      {
        "id": "Observation.referenceRange.appliesTo",
        "path": "Observation.referenceRange.appliesTo",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationRangeType"
            }
          ],
          "strength": "extensible",
          "description": "Saudi population groups for reference ranges",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-population-groups"
        }
      },
      {
        "id": "Observation.referenceRange.age",
        "path": "Observation.referenceRange.age",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS123 - Reference Range Age"
          }
        ]
      },
      {
        "id": "Observation.referenceRange.text",
        "path": "Observation.referenceRange.text",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS124 - Reference Range Text"
          }
        ]
      },
      {
        "id": "Observation.hasMember",
        "path": "Observation.hasMember",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation",
              "http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse",
              "http://hl7.org/fhir/StructureDefinition/MolecularSequence"
            ]
          }
        ],
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS130 - Related Observations"
          }
        ]
      },
      {
        "id": "Observation.derivedFrom",
        "path": "Observation.derivedFrom",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/StructureDefinition/DocumentReference",
              "http://hl7.org/fhir/StructureDefinition/ImagingStudy",
              "http://hl7.org/fhir/StructureDefinition/Media",
              "http://hl7.org/fhir/StructureDefinition/QuestionnaireResponse",
              "http://nphies.sa/fhir/ksa/nphies-fs/StructureDefinition/saudi-observation",
              "http://hl7.org/fhir/StructureDefinition/MolecularSequence"
            ]
          }
        ],
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS140 - Source Observations"
          }
        ]
      },
      {
        "id": "Observation.component",
        "path": "Observation.component",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS150 - Observation Components"
          }
        ]
      },
      {
        "id": "Observation.component.code",
        "path": "Observation.component.code",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationCode"
            }
          ],
          "strength": "extensible",
          "description": "LOINC codes with SNOMED CT extensions for observation components",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-observation-component-codes"
        }
      },
      {
        "id": "Observation.component.value[x]",
        "path": "Observation.component.value[x]",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS151 - Component Value"
          }
        ]
      },
      {
        "id": "Observation.component.dataAbsentReason",
        "path": "Observation.component.dataAbsentReason",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS152 - Component Data Absent Reason"
          }
        ]
      },
      {
        "id": "Observation.component.interpretation",
        "path": "Observation.component.interpretation",
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "ObservationInterpretation"
            }
          ],
          "strength": "extensible",
          "description": "Saudi-specific component interpretation codes",
          "valueSet": "http://nphies.sa/fhir/ksa/nphies-fs/ValueSet/saudi-observation-interpretation"
        }
      },
      {
        "id": "Observation.component.referenceRange",
        "path": "Observation.component.referenceRange",
        "mapping": [
          {
            "identity": "shdd",
            "map": "VS153 - Component Reference Range"
          }
        ]
      }
    ]
  }
}